REST Resource: projects.histories.executions

資源： Execution

「執行」代表一組步驟。舉例來說，這可以代表：- 針對各種裝置設定執行的行動測試 - 使用建構步驟的 jenkins 工作，隨後執行測試步驟

執行訊息的大小上限為 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

此執行作業歷史記錄中的專屬 ID。

如果呼叫端設定或覆寫這個欄位，則傳回 INVALID_src。

  • 一律設定回應
  • 在建立/更新要求中：永不設定
state

enum (State)

初始狀態為 IN_PROGRESS。

唯一法律狀態轉換的時間點從 IN_PROGRESS 至 COMPLETE。

如果要求無效的轉換，則會傳回 PRECONDITION_FAILED。

狀態只能設為 COMPLETE 一次。如果狀態設為 COMPLETE 多次，系統會傳回 FAILED_PRECONDITION。

如果狀態設為 COMPLETE，系統會將執行作業中的所有處理步驟都設為 COMPLETE。如未設定步驟結果，結果會設為「INCONCLUSIVE」。

  • 一律設定回應
  • 在建立/更新要求中：選填
creationTime

object (Timestamp)

執行作業的建立時間。

呼叫 runs.create 時，系統會自動設定這個值。

  • 回應：一律設定
  • 在建立/更新要求中：永不設定
completionTime

object (Timestamp)

執行狀態變成 COMPLETE 的時間。

當狀態轉換為 COMPLETE 時，系統會自動設定這個值。

  • 回應：如果執行狀態是 COMPLETE，就會設定此參數。
  • 在建立/更新要求中：永不設定
outcome

object (Outcome)

將結果分類，例如「成功」或「失敗」

  • 回應：如果由建立/更新要求設定，就會顯示這個元素
  • 在建立/更新要求中：選填
dimensionDefinitions[]

object (MatrixDimensionDefinition)

這項執行中不同步驟的維度可能不盡相同。在執行期間，此值必須保持固定。

如果更新要求中設有此欄位，則傳回 INVALID_src。

如果相同的名稱出現在多個 dimension_definition 中，則傳回 INVALID_src。

如果名單大小超過 100，則傳回 INVALID_src。

  • 回應：如果建立
  • 建立要求：選填
  • 在更新要求中：永不設定
specification

object (Specification)

執行要求的輕量資訊。

  • 回應：如果建立
  • 建立中：選用
  • 更新中：選填
testExecutionMatrixId

string

TestExecutionService 使用的 TestExecution Matrix ID。

  • 回應：如果建立
  • 建立中：選用
  • 更新中：永不設定

矩陣維度定義

這個類型沒有任何欄位。

包含不同步驟執行作業矩陣的一個維度。

規格

執行方式的詳細資料。

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 行動測試執行規格。

AndroidTest

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 Robo 測試。
androidTestLoop

object (AndroidTestLoop)

Android 測試迴圈。

AndroidAppInfo

Android 應用程式資訊。

JSON 表示法 
{
  "name": string,
  "packageName": string,
  "versionName": string,
  "versionCode": string
}
欄位
name

string

應用程式名稱。選用
packageName

string

應用程式的套件名稱。這是必要項目。
versionName

string

應用程式的版本名稱。選用。
versionCode

string

應用程式的內部版本代碼。選用。

AndroidInstrumentationTest

測試可單獨控制 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#methodName"

如果留空，系統會執行模組中的所有目標。
useOrchestrator

boolean

這個標記可指出是否要使用 Android Test Orchestrator 執行測試。

AndroidRoboTest

在虛擬或實體 Android 裝置上探索應用程式的 Android 應用程式測試，在過程中找出問題和當機問題。

JSON 表示法 
{
  "appInitialActivity": string,
  "bootstrapPackageId": string,
  "bootstrapRunnerClass": string,
  "maxDepth": integer,
  "maxSteps": integer
}
欄位
appInitialActivity

string

應用來啟動應用程式的初始活動。選用
bootstrapPackageId

string

Bootstrap 的 Java 套件。選用
bootstrapRunnerClass

string

Bootstrap 的執行器類別。選用
maxDepth

integer

Robo 可探索的周遊堆疊深度上限。選用
maxSteps

integer

Robo 可執行的步驟/動作數量上限。預設值為無限制。選用

AndroidTestLoop

這個類型沒有任何欄位。

測試迴圈是可由應用程式自行啟動的測試，透過監聽意圖來判斷何時執行。

IosTest

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

應用程式名稱。必要

IosXcTest

採用 XCTest 架構的 iOS 應用程式測試。

JSON 表示法 
{
  "bundleId": string,
  "xcodeVersion": string
}
欄位
bundleId

string

應用程式的軟體包 ID。
xcodeVersion

string

Xcode 版本。

IosTestLoop

iOS 應用程式的遊戲迴圈測試。

JSON 表示法 
{
  "bundleId": string
}
欄位
bundleId

string

應用程式的軟體包 ID。

IosRoboTest

這個類型沒有任何欄位。

iOS 應用程式的 Robo 測試。

方法

create

 建立執行作業。

get

 取得執行作業。

list

 列出特定記錄的執行作業。

patch

 使用提供的部分實體更新現有執行作業。