testLab namespace

機能

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

クラス

クラス説明
クライアント情報テストを呼び出したクライアントに関する情報。
結果ストレージテスト結果が保存される場所。
テストマトリックスTestMatrix は、テスト実行に関する詳細をキャプチャします。
テストマトリックスビルダーCloud Functions for Test Lab テスト マトリックス イベントの作成に使用されるビルダー。

タイプエイリアス

タイプエイリアス説明
無効なマトリックスの詳細マトリックスが無効であるとみなされた詳細な理由。
結果の概要完成した TestMatrix の結果の概要。
テスト状態TestMatrix の状態 (つまり、進行状況)。

testLab.testMatrix()

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

サイン：

export declare function testMatrix(): 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 : アプリは、許可されていない 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 : 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 ファイルで定義されている 1 つ以上のテスト ターゲットで「UseDestinationArtifacts」が指定されていますが、これは許可されていません。

  • TEST_NOT_APP_HOSTED注：物理デバイス上で実行される XC テストでは、xctestrun ファイルに「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.結果の概要

完成した TestMatrix の結果の概要。

可能な値:

  • SUCCESS : テスト マトリックスの実行は成功しました。たとえば、次のとおりです。 - すべてのテスト ケースが合格しました。 - Robo はテスト中のアプリケーションのクラッシュを検出しませんでした。

  • FAILURE : テストの実行は失敗しました。たとえば、次のとおりです。 - 1 つ以上のテスト ケースが失敗しました。 - テストがタイムアウトになりました。 - テスト中のアプリケーションがクラッシュしました。

  • INCONCLUSIVE ：予期せぬことが起こりました。実行は依然として失敗したとみなされますが、これは一時的な問題である可能性が高く、テストを再実行すると成功する可能性があります。

  • SKIPPED : すべてのテストがスキップされました。たとえば、次のとおりです。 - すべてのデバイス構成に互換性がありませんでした。

サイン：

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

testLab.TestState

TestMatrix の状態 (つまり、進行状況)。

可能な値:

  • VALIDATING : マトリックスは検証中です。

  • PENDING : マトリックスはリソースが使用可能になるのを待っています。

  • FINISHED ：マトリクスは正常に終了しました。これは、マトリックス レベルの処理は正常に完了しましたが、個々の実行がエラー状態になる可能性があることを意味します。

  • ERROR : インフラストラクチャ障害が発生したため、マトリックスが停止しました。

  • INVALID : 指定された入力が無効であるため、マトリックスは実行されませんでした。たとえば、入力ファイルが予期されたタイプではないか、形式が不正または破損しています。

サイン：

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