REST Resource: projects.histories.executions

リソース: 実行

実行はステップのコレクションを表します。たとえば、次のようなものを表すことができます。 - さまざまなデバイス構成にわたって実行されるモバイル テスト - ビルド ステップとその後にテスト ステップが続くジェンキンス ジョブ

実行メッセージの最大サイズは 1 MiB です。

実行は、その状態が COMPLETE に設定されるまで更新でき、その時点で不変になります。

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 に設定できるのは 1 回のみです。状態が COMPLETE に複数回設定されると、FAILED_PRECONDITION が返されます。

状態が COMPLETE に設定されている場合、実行内の進行中のステップはすべて COMPLETE に設定されます。ステップの結果が設定されていない場合、結果は INCONCLUSIVE に設定されます。

  • 応答では常に設定されます
  • 作成/更新リクエストの場合: オプション
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 マトリックス ID。

  • 応答: create で設定されている場合は存在します
  • 作成時: オプション
  • 更新時: 設定しない

行列次元定義

このタイプにはフィールドがありません。

ステップのさまざまな実行のマトリックスの 1 次元。

仕様

実行方法の詳細。

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次のいずれか 1 つだけです。

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次のいずれか 1 つだけです。

androidInstrumentationTest

object ( AndroidInstrumentationTest )

Android インストルメンテーション テスト。

androidRoboTest

object ( AndroidRoboTest )

Androidのロボテストです。

androidTestLoop

object ( AndroidTestLoop )

Android のテスト ループ。

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 を使用するかどうかを示します。

AndroidRoboTest

仮想または物理 Android デバイス上でアプリケーションを探索し、進行中に原因とクラッシュを見つける Android アプリケーションのテスト。

JSON表現
{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}
田畑
appInitialActivity

string

アプリの起動に使用する必要がある最初のアクティビティ。オプション

bootstrapPackageId

string

ブートストラップ用の Java パッケージ。オプション

bootstrapRunnerClass

string

ブートストラップのランナー クラス。オプション

maxDepth

integer

ロボが探索できるトラバーサル スタックの最大深さ。オプション

maxSteps

integer

Robo が実行できるステップ/アクションの最大数。デフォルトは制限なし (0) です。オプション

AndroidTestLoop

このタイプにはフィールドがありません。

テスト ループは、アプリ自体によって起動できるテストであり、インテントをリッスンしていつ実行するかを決定します。

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次のいずれか 1 つだけです。

iosXcTest

object ( IosXcTest )

iOS XCTest。

iosTestLoop

object ( IosTestLoop )

iOS テスト ループ。

iosRoboTest

object ( IosRoboTest )

iOSロボテスト。

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。

IosRoboTest

このタイプにはフィールドがありません。

iOS アプリケーションの Robo テスト。

メソッド

create

実行を作成します。

get

実行を取得します。

list

特定の履歴の実行をリストします。

patch

指定された部分エンティティで既存の実行を更新します。