REST Resource: projects.histories.executions

资源:执行

执行代表步骤的集合。例如,它可以表示: - 在一系列设备配置上执行的移动测试 - 包含构建步骤和测试步骤的 jenkins 作业

执行消息的最大大小为 1 MiB。

可以更新执行,直到其状态设置为完成,此时它变得不可变。

JSON 表示
{
  "executionId": string,
  "state": enum (State),
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "outcome": {
    object (Outcome)
  },
  "dimensionDefinitions": [
    {
      object (MatrixDimensionDefinition)
    }
  ],
  "specification": {
    object (Specification)
  },
  "testExecutionMatrixId": string
}
领域
executionId

string

此执行的历史记录中的唯一标识符。

如果调用者设置或覆盖该字段,则返回 INVALID_ARGUMENT。

  • 在响应中总是设置
  • 在创建/更新请求中:从不设置
state

enum ( State )

初始状态为 IN_PROGRESS。

唯一合法的状态转换是从 IN_PROGRESS 到 COMPLETE。

如果请求无效转换,将返回 PRECONDITION_FAILED。

该状态只能设置为 COMPLETE 一次。如果多次将状态设置为 COMPLETE,将返回 FAILED_PRECONDITION。

如果状态设置为 COMPLETE,则执行中所有正在进行的步骤都将设置为 COMPLETE。如果未设置该步骤的结果,则结果将设置为“不确定”。

  • 在响应中总是设置
  • 在创建/更新请求中:可选
creationTime

object ( Timestamp )

创建执行的时间。

该值将在调用executions.create 时自动设置。

  • 响应:始终设置
  • 在创建/更新请求中:从不设置
completionTime

object ( Timestamp )

执行状态转变为 COMPLETE 的时间。

当状态转换为 COMPLETE 时,将自动设置该值。

  • 响应:如果执行状态为 COMPLETE,则设置。
  • 在创建/更新请求中:从不设置
outcome

object ( Outcome )

对结果进行分类,例如分为成功或失败

  • 响应:如果由创建/更新请求设置则存在
  • 在创建/更新请求中:可选
dimensionDefinitions[]

object ( MatrixDimensionDefinition )

此执行中不同步骤的维度可能会有所不同。这必须在执行的整个生命周期中保持固定。

如果在更新请求中设置了此字段,则返回 INVALID_ARGUMENT。

如果同名出现在多个维度定义中,则返回 INVALID_ARGUMENT。

如果列表大小超过 100,则返回 INVALID_ARGUMENT。

  • 响应:如果由 create 设置则存在
  • 在创建请求中:可选
  • 在更新请求中:从未设置
specification

object ( Specification )

有关执行请求的轻量级信息。

  • 响应:如果由 create 设置则存在
  • 在创建中:可选
  • 更新中:可选
testExecutionMatrixId

string

TestExecutionService 使用的 TestExecution Matrix ID。

  • 响应:如果由 create 设置则存在
  • 在创建中:可选
  • 更新中:从未设置

矩阵维度定义

该类型没有字段。

一个步骤的不同运行的矩阵的一维。

规格

有关如何运行执行的详细信息。

JSON 表示
{

  // Union field specification can be only one of the following:
  "androidTest": {
    object (AndroidTest)
  },
  "iosTest": {
    object (IosTest)
  }
  // End of list of possible types for union field specification.
}
领域

联盟字段specification

specification只能是以下之一:

androidTest

object ( AndroidTest )

Android 移动测试执行规范。

iosTest

object ( IosTest )

iOS 移动测试执行规范。

Android测试

Android 移动测试规范。

JSON 表示
{
  "androidAppInfo": {
    object (AndroidAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "androidInstrumentationTest": {
    object (AndroidInstrumentationTest)
  },
  "androidRoboTest": {
    object (AndroidRoboTest)
  },
  "androidTestLoop": {
    object (AndroidTestLoop)
  }
  // End of list of possible types for union field test.
}
领域
androidAppInfo

object ( AndroidAppInfo )

有关被测应用程序的信息。

testTimeout

object ( Duration )

测试在自动取消之前允许运行的最长时间。

联盟实地test

test只能是以下之一:

androidInstrumentationTest

object ( AndroidInstrumentationTest )

Android 仪器测试。

androidRoboTest

object ( AndroidRoboTest )

Android 机器人测试。

androidTestLoop

object ( AndroidTestLoop )

Android 测试循环。

Android应用程序信息

安卓应用程序信息。

JSON 表示
{
  "name": string,
  "packageName": string,
  "versionName": string,
  "versionCode": string
}
领域
name

string

应用程序的名称。选修的

packageName

string

应用程序的包名称。必需的。

versionName

string

应用程序的版本名称。选修的。

versionCode

string

应用程序的内部版本代码。选修的。

Android仪器测试

对 Android 应用程序的测试,该应用程序可以独立于正常生命周期控制 Android 组件。

有关 Android 测试类型的更多信息,请参阅https://developer.android.com/training/testing/fundamentals

JSON 表示
{
  "testPackageId": string,
  "testRunnerClass": string,
  "testTargets": [
    string
  ],
  "useOrchestrator": boolean
}
领域
testPackageId

string

要执行的测试的java包。必需的

testRunnerClass

string

InstrumentationTestRunner 类。必需的

testTargets[]

string

每个目标都必须使用包名称或类名称进行完全限定,采用以下格式之一: - "package packageName" - "class packageName.class_name" - "class packageName.class_name#method_name"

如果为空,则将运行模块中的所有目标。

useOrchestrator

boolean

该标志指示是否使用 Android Test Orchestrator 来运行测试。

AndroidRobo测试

对 Android 应用程序的测试,在虚拟或物理 Android 设备上探索该应用程序,在运行过程中查找罪魁祸首和崩溃情况。

JSON 表示
{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}
领域
appInitialActivity

string

应该用于启动应用程序的初始活动。选修的

bootstrapPackageId

string

引导程序的 java 包。选修的

bootstrapRunnerClass

string

引导程序的运行程序类。选修的

maxDepth

integer

Robo 可以探索的遍历堆栈的最大深度。选修的

maxSteps

integer

Robo 可以执行的最大步骤/操作数。默认为无限制 (0)。选修的

Android测试循环

该类型没有字段。

测试循环是可以由应用程序本身启动的测试,通过侦听意图来确定何时运行。

IOS测试

iOS 移动测试规范

JSON 表示
{
  "iosAppInfo": {
    object (IosAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "iosXcTest": {
    object (IosXcTest)
  },
  "iosTestLoop": {
    object (IosTestLoop)
  },
  "iosRoboTest": {
    object (IosRoboTest)
  }
  // End of list of possible types for union field test.
}
领域
iosAppInfo

object ( IosAppInfo )

有关被测应用程序的信息。

testTimeout

object ( Duration )

测试在自动取消之前允许运行的最长时间。

联盟实地test

test只能是以下之一:

iosXcTest

object ( IosXcTest )

iOS XCTest。

iosTestLoop

object ( IosTestLoop )

iOS 测试循环。

iosRoboTest

object ( IosRoboTest )

iOS Robo 测试。

Ios应用程序信息

iOS 应用程序信息

JSON 表示
{
  "name": string
}
领域
name

string

应用程序的名称。必需的

IOSXc测试

使用 XCTest 框架对 iOS 应用程序进行测试。

JSON 表示
{
  "bundleId": string,
  "xcodeVersion": string
}
领域
bundleId

string

应用程序的捆绑 ID。

xcodeVersion

string

运行测试的 Xcode 版本。

IOS测试循环

iOS 应用程序的游戏循环测试。

JSON 表示
{
  "bundleId": string
}
领域
bundleId

string

应用程序的捆绑 ID。

IosRobo测试

该类型没有字段。

针对 iOS 应用程序的 Robo 测试。

方法

create

创建一个执行。

get

获得处决。

list

列出给定历史记录的执行情况。

patch

使用提供的部分实体更新现有执行。
,

资源:执行

执行代表步骤的集合。例如,它可以表示: - 在一系列设备配置上执行的移动测试 - 包含构建步骤和测试步骤的 jenkins 作业

执行消息的最大大小为 1 MiB。

可以更新执行,直到其状态设置为完成,此时它变得不可变。

JSON 表示
{
  "executionId": string,
  "state": enum (State),
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "outcome": {
    object (Outcome)
  },
  "dimensionDefinitions": [
    {
      object (MatrixDimensionDefinition)
    }
  ],
  "specification": {
    object (Specification)
  },
  "testExecutionMatrixId": string
}
领域
executionId

string

此执行的历史记录中的唯一标识符。

如果调用者设置或覆盖该字段,则返回 INVALID_ARGUMENT。

  • 在响应中总是设置
  • 在创建/更新请求中:从不设置
state

enum ( State )

初始状态为 IN_PROGRESS。

唯一合法的状态转换是从 IN_PROGRESS 到 COMPLETE。

如果请求无效转换,将返回 PRECONDITION_FAILED。

该状态只能设置为 COMPLETE 一次。如果多次将状态设置为 COMPLETE,将返回 FAILED_PRECONDITION。

如果状态设置为 COMPLETE,则执行中所有正在进行的步骤都将设置为 COMPLETE。如果未设置该步骤的结果,则结果将设置为“不确定”。

  • 在响应中总是设置
  • 在创建/更新请求中:可选
creationTime

object ( Timestamp )

创建执行的时间。

该值将在调用executions.create 时自动设置。

  • 响应:始终设置
  • 在创建/更新请求中:从不设置
completionTime

object ( Timestamp )

执行状态转变为 COMPLETE 的时间。

当状态转换为 COMPLETE 时,将自动设置该值。

  • 响应:如果执行状态为 COMPLETE,则设置。
  • 在创建/更新请求中:从不设置
outcome

object ( Outcome )

对结果进行分类,例如分为成功或失败

  • 响应:如果由创建/更新请求设置则存在
  • 在创建/更新请求中:可选
dimensionDefinitions[]

object ( MatrixDimensionDefinition )

此执行中不同步骤的维度可能会有所不同。这必须在执行的整个生命周期中保持固定。

如果在更新请求中设置了此字段,则返回 INVALID_ARGUMENT。

如果同名出现在多个维度定义中,则返回 INVALID_ARGUMENT。

如果列表大小超过 100,则返回 INVALID_ARGUMENT。

  • 响应:如果由 create 设置则存在
  • 在创建请求中:可选
  • 在更新请求中:从未设置
specification

object ( Specification )

有关执行请求的轻量级信息。

  • 响应:如果由 create 设置则存在
  • 在创建中:可选
  • 更新中:可选
testExecutionMatrixId

string

TestExecutionService 使用的 TestExecution Matrix ID。

  • 响应:如果由 create 设置则存在
  • 在创建中:可选
  • 更新中:从未设置

矩阵维度定义

该类型没有字段。

一个步骤的不同运行的矩阵的一维。

规格

有关如何运行执行的详细信息。

JSON 表示
{

  // Union field specification can be only one of the following:
  "androidTest": {
    object (AndroidTest)
  },
  "iosTest": {
    object (IosTest)
  }
  // End of list of possible types for union field specification.
}
领域

联盟字段specification

specification只能是以下之一:

androidTest

object ( AndroidTest )

Android 移动测试执行规范。

iosTest

object ( IosTest )

iOS 移动测试执行规范。

Android测试

Android 移动测试规范。

JSON 表示
{
  "androidAppInfo": {
    object (AndroidAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "androidInstrumentationTest": {
    object (AndroidInstrumentationTest)
  },
  "androidRoboTest": {
    object (AndroidRoboTest)
  },
  "androidTestLoop": {
    object (AndroidTestLoop)
  }
  // End of list of possible types for union field test.
}
领域
androidAppInfo

object ( AndroidAppInfo )

有关被测应用程序的信息。

testTimeout

object ( Duration )

测试在自动取消之前允许运行的最长时间。

联盟实地test

test只能是以下之一:

androidInstrumentationTest

object ( AndroidInstrumentationTest )

Android 仪器测试。

androidRoboTest

object ( AndroidRoboTest )

Android 机器人测试。

androidTestLoop

object ( AndroidTestLoop )

Android 测试循环。

Android应用程序信息

安卓应用程序信息。

JSON 表示
{
  "name": string,
  "packageName": string,
  "versionName": string,
  "versionCode": string
}
领域
name

string

应用程序的名称。选修的

packageName

string

应用程序的包名称。必需的。

versionName

string

应用程序的版本名称。选修的。

versionCode

string

应用程序的内部版本代码。选修的。

Android仪器测试

对 Android 应用程序的测试,该应用程序可以独立于正常生命周期控制 Android 组件。

有关 Android 测试类型的更多信息,请参阅https://developer.android.com/training/testing/fundamentals

JSON 表示
{
  "testPackageId": string,
  "testRunnerClass": string,
  "testTargets": [
    string
  ],
  "useOrchestrator": boolean
}
领域
testPackageId

string

要执行的测试的java包。必需的

testRunnerClass

string

InstrumentationTestRunner 类。必需的

testTargets[]

string

每个目标都必须使用包名称或类名称进行完全限定,采用以下格式之一: - "package packageName" - "class packageName.class_name" - "class packageName.class_name#method_name"

如果为空,则将运行模块中的所有目标。

useOrchestrator

boolean

该标志指示是否使用 Android Test Orchestrator 来运行测试。

AndroidRobo测试

对 Android 应用程序的测试,在虚拟或物理 Android 设备上探索该应用程序,在运行过程中查找罪魁祸首和崩溃情况。

JSON 表示
{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}
领域
appInitialActivity

string

应该用于启动应用程序的初始活动。选修的

bootstrapPackageId

string

引导程序的 java 包。选修的

bootstrapRunnerClass

string

引导程序的运行程序类。选修的

maxDepth

integer

Robo 可以探索的遍历堆栈的最大深度。选修的

maxSteps

integer

Robo 可以执行的最大步骤/操作数。默认为无限制 (0)。选修的

Android测试循环

该类型没有字段。

测试循环是可以由应用程序本身启动的测试,通过侦听意图来确定何时运行。

IOS测试

iOS 移动测试规范

JSON 表示
{
  "iosAppInfo": {
    object (IosAppInfo)
  },
  "testTimeout": {
    object (Duration)
  },

  // Union field test can be only one of the following:
  "iosXcTest": {
    object (IosXcTest)
  },
  "iosTestLoop": {
    object (IosTestLoop)
  },
  "iosRoboTest": {
    object (IosRoboTest)
  }
  // End of list of possible types for union field test.
}
领域
iosAppInfo

object ( IosAppInfo )

有关被测应用程序的信息。

testTimeout

object ( Duration )

测试在自动取消之前允许运行的最长时间。

联盟实地test

test只能是以下之一:

iosXcTest

object ( IosXcTest )

iOS XCTest。

iosTestLoop

object ( IosTestLoop )

iOS 测试循环。

iosRoboTest

object ( IosRoboTest )

iOS Robo 测试。

Ios应用程序信息

iOS 应用程序信息

JSON 表示
{
  "name": string
}
领域
name

string

应用程序的名称。必需的

IOSXc测试

使用 XCTest 框架对 iOS 应用程序进行测试。

JSON 表示
{
  "bundleId": string,
  "xcodeVersion": string
}
领域
bundleId

string

应用程序的捆绑 ID。

xcodeVersion

string

运行测试的 Xcode 版本。

IOS测试循环

iOS 应用程序的游戏循环测试。

JSON 表示
{
  "bundleId": string
}
领域
bundleId

string

应用程序的捆绑 ID。

IosRobo测试

该类型没有字段。

针对 iOS 应用程序的 Robo 测试。

方法

create

创建一个执行。

get

获得处决。

list

列出给定历史记录的执行情况。

patch

使用提供的部分实体更新现有执行。