函数
| 函数 | 说明 |
|---|---|
| testMatrix() | 处理与 Test Lab 测试矩阵相关的事件。 |
类
| 类 | 说明 |
|---|---|
| ClientInfo | 对测试进行调用的客户端的相关信息。 |
| ResultStorage | 存储测试结果的位置。 |
| TestMatrix | TestMatrix 可捕获有关测试运行的详细信息。 |
| TestMatrixBuilder | 用于创建 Cloud Functions for Test Lab 测试矩阵事件的构建器。 |
类型别名
| 类型别名 | 说明 |
|---|---|
| InvalidMatrixDetails | 矩阵被视为 INVALID 的详细原因。 |
| OutputSummary（结果摘要） | 已完成的 TestMatrix 的结果摘要。 |
| TestState | TestMatrix 的状态（即进度）。 |
testLab.testMatrix()
处理与 Test Lab 测试矩阵相关的事件。
签名：
export declare function testMatrix(): TestMatrixBuilder;
返回：
testLab.InvalidMatrixDetails
矩阵被视为 INVALID 的详细原因。
可能的值：
DETAILS_UNAVAILABLE：矩阵为 INVALID，但没有更多详细信息。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：找不到主启动器 activity。FORBIDDEN_PERMISSIONS：应用声明了一项或多项不允许使用的权限。INVALID_ROBO_DIRECTIVES：提供的 robo_directives 存在冲突。INVALID_RESOURCE_NAME：提供的 robo 指令中至少有一个无效的资源名称。INVALID_DIRECTIVE_ACTION：robo 指令中的操作定义无效，例如点击或忽略操作包含一个输入文本字段。TEST_LOOP_INTENT_FILTER_NOT_FOUND：没有测试循环 intent 过滤器，或者提供的过滤器格式不正确。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：压缩后的 XCTest 是针对 iOS 模拟器（而不是实体设备）构建的。NO_TESTS_IN_XC_TEST_ZIP：.xctestrun 文件未指定任何测试目标。USE_DESTINATION_ARTIFACTS：.xctestrun 文件中定义的一个或多个测试目标指定了“UseDestinationArtifacts”，但这是不允许的。TEST_NOT_APP_HOSTED：在实体设备上运行的 XC 测试必须具有“IsAppHostedTestBundle”==“true”每个命令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";