REST Resource: projects.histories.executions.environments

资源：环境

环境表示来自父级执行的一组测试运行（步骤），这些测试运行（步骤）配置了同一组维度（模型、版本、语言区域和方向）。之所以会多次运行此类，主要是因为分片（拆分测试套件以便在各种设备上并行运行）和重新运行（多次运行测试来检查不同的结果）等功能。

JSON 表示法 
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
字段
projectId

string

仅限输出。项目 ID。
historyId

string

仅限输出。历史记录 ID。
executionId

string

仅限输出。执行 ID。
environmentId

string

仅限输出。环境 ID。
dimensionValue

map (key: string, value: string)

描述环境的维度值。维度值始终由“Model”“Version”“Locale”和“Orientation”组成。

  • 回复：Always set
  • 在创建请求中：始终设置
  • 在更新请求中：从未设置

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
displayName

string

显示在界面中的直观易懂的简短名称。最多 100 个字符。例如：Nexus 5，API 27。
creationTime

object (Timestamp)

仅限输出。创建环境的时间。
completionTime

object (Timestamp)

仅限输出。环境状态设为完成的时间。

当状态转换为 COMPLETE 时，系统会自动设置此值。
shardSummaries[]

object (ShardSummary)

仅限输出。分片摘要。

除非在 TestExecutionService 中启用分片功能，否则只会显示一个分片。
environmentResult

object (MergedResult)

环境的合并结果。
resultsStorage

object (ResultsStorage)

用户存储分区中输出文件的存储位置。

ShardSummary

环境中分片的结果摘要。

JSON 表示法 
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
字段
runs[]

object (StepSummary)

属于分片的步骤摘要。

通过 TestExecutionService 启用 flaky_test_attempts 后，可以进行多次运行（步骤）。运行作业将按 multistepNumber 排序。
shardResult

object (MergedResult)

分片的合并结果。

步骤摘要

此类型没有字段。

此执行中步骤的简明摘要。

MergedResult

环境的合并测试结果。

如果环境只有一个步骤（没有重新运行或分片），则合并结果与步骤结果相同。如果环境有多个分片和/或重新运行，则属于同一环境的分片和重新运行的结果将合并为一个环境结果。

JSON 表示法 
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
字段
state

enum (State)

资源状态
outcome

object (Outcome)

资源的结果
testSuiteOverviews[]

object (TestSuiteOverview)

在此环境中运行的每个测试套件的汇总结果和汇总结果。

组合：如果套件中的测试用例按不同的步骤（分片）运行，系统会将结果重新加到一个概览中。（例如，如果 shard1 有 2 次失败，而 shard2 有 1 次失败而不是概览 failedCount = 3）。

汇总：如果同一套件中的测试用例多次运行（不稳定），结果会合并（例如，如果 testcase1.run1 失败、testcase1.run2 通过，且 testcase2.run1 和 testcase2.run2 均失败，则概览 flakyCount = 1，failCount = 1）。

结果存储

用于存储测试结果的存储空间。

JSON 表示法 
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
字段
resultsStoragePath

object (FileReference)

测试结果的根目录。
xunitXmlFile

object (FileReference)

Xunit XML 文件的路径。

方法

get

 获取环境。

list

 列出给定执行的环境。