testLab namespace

函式

函式 說明
testMatrix() 處理與 Test Lab 測試矩陣相關的事件。

類別

類別 說明
用戶端資訊 叫用測試的用戶端相關資訊。
結果儲存空間 測試結果的儲存位置。
TestMatrix TestMatrix 會擷取測試執行作業的詳細資料。
TestMatrixBuilder 建立 Test Lab for Test Lab 測試矩陣事件的建構工具。

型別別名

類型別名 說明
InvalidMatrixDetails 矩陣被認定為「無效」的詳細原因。
結果摘要 已完成的 TestMatrix 結果摘要。
TestState TestMatrix 的狀態 (即進度)。

testLab.testMatrix()

處理與 Test Lab 測試矩陣相關的事件。

簽名：

export declare function testMatrix(): TestMatrixBuilder;

傳回：

TestMatrixBuilder

testLab.InvalidMatrixDetails

矩陣被認定為「無效」的詳細原因。

可能的值：

  • DETAILS_UNAVAILABLE：矩陣無效，但無法提供進一步的詳細資料。

  • MALFORMED_APK：無法剖析輸入的應用程式 APK。

  • MALFORMED_TEST_APK：無法剖析輸入的測試 APK。

  • NO_MANIFEST：找不到 AndroidManifest.xml。

  • NO_PACKAGE_NAME：APK 資訊清單未宣告套件名稱。

  • INVALID_PACKAGE_NAME：APK 應用程式 ID 無效。

  • TEST_SAME_AS_APP：測試套件與應用程式套件相同。

  • NO_INSTRUMENTATION：測試 APK 未宣告檢測設備。

  • NO_SIGNATURE：輸入的應用程式 APK 沒有簽章。

  • INSTRUMENTATION_ORCHESTRATOR_INCOMPATIBLE：使用者或測試 APK 資訊清單檔案中指定的測試執行器類別與 Android Test Orchestrator 不相容。

  • NO_TEST_RUNNER_CLASS：測試 APK 中沒有使用者或在資訊清單檔案中指定的測試執行器類別。

  • NO_LAUNCHER_ACTIVITY：找不到主要啟動器活動。

  • FORBIDDEN_PERMISSIONS：應用程式宣告了一或多項禁止使用的權限。

  • INVALID_ROBO_DIRECTIVES：提供的 robo_directives 有衝突。

  • INVALID_RESOURCE_NAME：提供的 Robo 指令中至少有一個無效的資源名稱。

  • INVALID_DIRECTIVE_ACTION：針對 Robo 指令中的動作定義無效，例如點擊或略過動作會包含輸入文字欄位。

  • TEST_LOOP_INTENT_FILTER_NOT_FOUND：沒有測試迴圈意圖篩選器，或是提供的意圖格式不正確。

  • SCENARIO_LABEL_NOT_DECLARED：要求含有未在資訊清單中宣告的情境標籤。

  • SCENARIO_LABEL_MALFORMED：剖析標籤值時發生錯誤。

  • SCENARIO_NOT_DECLARED：要求含有未在資訊清單中宣告的情境編號。

  • DEVICE_ADMIN_RECEIVER：不允許使用裝置管理員應用程式。

  • MALFORMED_XC_TEST_ZIP：壓縮的 XCTest 格式錯誤。zip 不包含 ] 包含單一 .xctestrun 檔案和 DerivedData/Build/Products 目錄的內容。

  • BUILT_FOR_IOS_SIMULATOR：ZIP 壓縮的 XCTest 是專為 iOS 模擬器 (而非實體裝置) 所設計。

  • NO_TESTS_IN_XC_TEST_ZIP：.xctestrun 檔案未指定任何測試目標。

  • USE_DESTINATION_ARTIFACTS：.xctestrun 檔案中定義的一或多個測試目標，指定系統不允許的「UseDestinationArtifacts」。

  • TEST_NOT_APP_HOSTED：在實體裝置上執行的 XC 測試必須含有「IsAppHostedTestBundle」==「是」。

  • PLIST_CANNOT_BE_PARSED：無法剖析 XCTest ZIP 檔案中的 Info.plist 檔案。

  • NO_CODE_APK：APK 未包含程式碼。

  • INVALID_INPUT_APK：可能是提供的輸入 APK 路徑格式錯誤、APK 檔案不存在，或是使用者權限不足，無法存取 APK 檔案。

  • INVALID_APK_PREVIEW_SDK：APK 是為了預覽不支援的 SDK 所建立，

簽名：

export type InvalidMatrixDetails = "DETAILS_UNAVAILABLE" | "MALFORMED_APK" | "MALFORMED_TEST_APK" | "NO_MANIFEST" | "NO_PACKAGE_NAME" | "INVALID_PACKAGE_NAME" | "TEST_SAME_AS_APP" | "NO_INSTRUMENTATION" | "NO_SIGNATURE" | "INSTRUMENTATION_ORCHESTRATOR_INCOMPATIBLE" | "NO_TEST_RUNNER_CLASS" | "NO_LAUNCHER_ACTIVITY" | "FORBIDDEN_PERMISSIONS" | "INVALID_ROBO_DIRECTIVES" | "INVALID_RESOURCE_NAME" | "INVALID_DIRECTIVE_ACTION" | "TEST_LOOP_INTENT_FILTER_NOT_FOUND" | "SCENARIO_LABEL_NOT_DECLARED" | "SCENARIO_LABEL_MALFORMED" | "SCENARIO_NOT_DECLARED" | "DEVICE_ADMIN_RECEIVER" | "MALFORMED_XC_TEST_ZIP" | "BUILT_FOR_IOS_SIMULATOR" | "NO_TESTS_IN_XC_TEST_ZIP" | "USE_DESTINATION_ARTIFACTS" | "TEST_NOT_APP_HOSTED" | "PLIST_CANNOT_BE_PARSED" | "NO_CODE_APK" | "INVALID_INPUT_APK" | "INVALID_APK_PREVIEW_SDK";

testLab.OutcomeSummary

已完成的 TestMatrix 結果摘要。

可能的值：

  • SUCCESS：測試矩陣執行成功，例如：已通過所有測試案例。- Robo 未偵測到測試中應用程式的當機情形。

  • FAILURE：測試執行失敗，例如：- 一或多個測試案例失敗。- 測試逾時。- 受測應用程式當機。

  • INCONCLUSIVE：發生未預期的錯誤，系統應該仍會認為執行作業失敗，但這可能是暫時性問題，並重新執行測試也可能成功。

  • SKIPPED：已略過所有測試，例如：所有裝置設定都不相容。

簽名：

export type OutcomeSummary = "SUCCESS" | "FAILURE" | "INCONCLUSIVE" | "SKIPPED";

testLab.TestState

TestMatrix 的狀態 (即進度)。

可能的值：

  • VALIDATING：正在驗證矩陣。

  • PENDING：矩陣正在等待資源可供使用。

  • FINISHED：矩陣已正常終止。這表示矩陣層級處理程序正常，但個別執行可能處於 ERROR 狀態。

  • ERROR：矩陣已停止運作，因為基礎架構發生故障。

  • INVALID：提供的輸入內容無效，因此矩陣未執行。例如：輸入檔案的類型不是預期，或者格式錯誤/損毀。

簽名：

export type TestState = "VALIDATING" | "PENDING" | "FINISHED" | "ERROR" | "INVALID";