testLab namespace

関数

関数 説明
testMatrix() Test Lab のテスト マトリックスに関連するイベントを処理します。

クラス

クラス 説明
ClientInfo テストを呼び出したクライアントに関する情報。
ResultStorage テスト結果を保存する場所。
TestMatrix TestMatrix はテスト実行の詳細を取得します。
TestMatrixBuilder Test Lab のテスト マトリックス イベント用の Cloud Functions の関数を作成するビルダー。

型エイリアス

型エイリアス 説明
InvalidMatrixDetails マトリックスが INVALID と見なされた詳細な理由。
結果の概要 完成した TestMatrix の結果の概要。
TestState TestMatrix の状態(進行状況)。

testLab.testMatrix()

Test Lab のテスト マトリックスに関連するイベントを処理します。

署名:

export declare function testMatrix(): TestMatrixBuilder;

戻り値:

TestMatrixBuilder

testLab.InvalidMatrixDetails

マトリックスが INVALID と見なされた詳細な理由。

値は次のいずれかです。

  • 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: 許可されていない権限が 1 つ以上宣言されています。

  • INVALID_ROBO_DIRECTIVES: 指定された robo_directives が競合しています。

  • INVALID_RESOURCE_NAME: 指定された robo ディレクティブに無効なリソース名が 1 つ以上あります。

  • 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: 圧縮された XCTest は、実機用ではなく iOS シミュレータ用にビルドされています。

  • NO_TESTS_IN_XC_TEST_ZIP: .xctestrun ファイルにテスト ターゲットが指定されていません。

  • USE_DESTINATION_ARTIFACTS: .xctestrun ファイルで定義された 1 つ以上のテスト ターゲットで、許可されていない「UseDestinationArtifacts」が指定されています。

  • TEST_NOT_APP_HOSTED: 実機で実行される XC テストには「IsAppHostedTestBundle」が必要== "true"xctestrun の中で指定します。

  • PLIST_CANNOT_BE_PARSED: XCTest zip 内の Info.plist ファイルを解析できませんでした。

  • NO_CODE_APK: APK にコードが含まれていません。

  • INVALID_INPUT_APK: 指定された入力 APK パスの形式が正しくないか、APK ファイルが存在しないか、ユーザーに APK ファイルへのアクセス権限がありません。

  • INVALID_APK_PREVIEW_SDK: サポートされていないプレビュー SDK 用に APK がビルドされています。

署名:

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: テストの実行が失敗しました。例: - 1 つ以上のテストケースが失敗しました。- テストがタイムアウトした。- テスト対象のアプリケーションがクラッシュした。

  • 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";