デベロッパー デバイス プラットフォームのテスト結果を確認する

このガイドでは、 Developer Device Platform デバイスランガイドに沿ってトリガーされたテストの結果を確認する方法について説明します。

始める前に

これらの手順は、 Google Cloud プロジェクトを作成し、Developer Device Platform のクイックスタート ガイドの設定手順を完了し、ターミナルで gcloud を使用して認証済みであることを前提としています。

コマンドラインで

次のコマンドとセッション ID を使用して、テスト結果の基本的な概要を確認します。

gcloud beta device-run sessions describe SESSION_ID

次のような結果が返されます。

Session SESSION_ID finished with result [FAILED].
Result files are stored at [https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/].
JOB NAME  EXECUTION NAME  EXECUTION RESULT
job-000   all             FAILED: 2 test cases failed, 5 passed
job-001   all             PASS

--device フラグで指定したデバイスタイプ ID ごとに、セッションで 1 つのジョブが生成されます。ジョブ インデックスは、デバイス ID の順序に従います。テストの失敗は想定内であり、反復的な改善と実行を通じて調査および解決する必要があります。

テスト セッションの詳細情報を取得するには、次のように、前に実行した describe コマンドに --full を追加します。

gcloud beta device-run sessions describe SESSION_ID --full

次のような結果が返されます。

name: projects/PROJECT_ID/locations/global/sessions/session-370961e1
sessionConfig:
  displayName: instrumentation-session
  jobConfigs:
  -   action:
      androidInstrumentationTest:
        testInstallable:
          files:
          -   gcsInputFile:
              path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name_test.apk
    allocationConfig:
      deviceConfigs:
      -   actions:
        -   androidInstallPackages:
            installables:
            -   files:
              -   gcsInputFile:
                  path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name.apk
        -   androidLogcat: {}
        requirement:
          deviceId: pa3q-35
    displayName: job-000
  outputDirectoryConfig:
    gcsOutputDirectory:
      path: gs://BUCKET_NAME/automation/sessions
sessionReport:
  endTime: '2026-07-30T03:30:05.838Z'
  id: 6587313f-fdf7-418a-a9b9-b6fa98dff838
  jobReports:
  -   displayName: job-000
    endTime: '2026-07-30T03:30:04.601Z'
    executionReports:
    -   displayName: all
      endTime: '2026-07-30T03:30:02.151Z'
      id: 29b167dd-dde9-4ea9-b2cd-738049083fc9
      outputFiles:
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/logcat.txt
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/instrument.log
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/junit.xml
      result:
        cause:
          summary:
            message: One or more test assertions or test methods failed. Inspect the
              test runner logs and structured test results for details.
            reason: TEST_CASE_FAILURE
            type: CUSTOMER
        resultType: FAILED
      startTime: '2026-07-30T03:29:32.769Z'
      status:
        progressMessages:
        -   2 test cases failed, 5 passed
        statusType: DONE
    id: 7974e37a-2928-4aaf-abba-3a8b6bae853b
    result:
      cause:
        summary:
          message: Job has one or more failed tests. See execution reports for details.
          reason: JOB_HAS_FAILED_TESTS
      resultType: FAILED
    startTime: '2026-07-30T03:28:53.756Z'
    status:
      statusType: DONE
  result:
    cause:
      summary:
        message: Session has one or more failed jobs. See job reports for details.
        reason: SESSION_HAS_FAILED_JOBS
    resultType: FAILED
  startTime: '2026-07-30T03:28:52.702Z'
  status:
    statusType: DONE

ウェブブラウザの場合

詳細については、テスト出力からテスト結果を含むバケットに URL を読み込みます。次のようになります。 https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/

セッションは、ストレージ内の次のパス形式で表示されます。 gs://BUCKET_NAME/automation/sessions/SESSION_ID/job-000/EXECUTION_ID/

Google Cloud コンソールのウェブ インターフェースでログを閲覧する手順は次のとおりです。

  1. ブラウザで、gcloud config set project コマンドで使用したプロジェクト名を URL https://console.cloud.google.com/?project= に追加して、ページを読み込みます。
  2. 左上のメニューを開きます。
  3. [Cloud Storage] を見つけます。
  4. ストレージ メニューから [バケット] を選択します。
  5. 最初の列で、プロジェクトの名前をクリックします。
  6. [自動化] をクリックします。
  7. [セッション] をクリックします。
  8. [フィルタ] フィールドに、最新のテスト実行のセッション ID を貼り付けます（テスト出力をご覧ください）。
  9. 表示されたセッション名をクリックします。
  10. job-* を選択して、すべてのテストケースの包括的な結果の詳細を含む junit.xml を表示します。
  11. execution-* を開くと、個々のシャードの内訳が表示されます。このフォルダ内で、次の場所に移動します。
    • instrumentation.log: Android 計測テストの未加工のログ。
    • system.log: デバイスとフレームワークのログを含む未加工の iOS システム syslog。
    • logcat.txt: Android の logcat ファイル。
    • junit.xml: 成功または失敗したテストケースの詳細を示す JUnit XML レポート。
    • *.ips: 診断用の iOS クラッシュログ（クラッシュが発生した場合）。
  12. 公開 URL と認証済み URL にアクセスして、テスト結果を確認します。

ファイル構造

Cloud Storage バケット内のログファイルを調べて、テスト失敗について詳しく理解します。ファイル構造は次のようになります。

-   gs://BUCKET_NAME/automation
  -   inputs/
    -   2026-05-29_10:13.026220_JZTM
      -   app.apk
      -   test.apk
  -   sessions/
    -   SESSION_ID
      -   job-000/
        -   junit.xml
        -   execution-000/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
        -   execution-001/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
      -   job-001/
    -   SESSION_ID

結果を把握する

出力で生成される junit.xml ファイルは、標準の JUnit XML ファイルです。これらのファイルにはテストメソッドごとの結果が含まれているため、個々のテストメソッドの合格または不合格のステータス、実行時間、エラー トレースを確認できます。このファイルは、ほとんどの継続的インテグレーションと継続的デリバリー（CI/CD）システムおよびテスト レポート ツールで簡単に統合して解析できます。

サポート ドキュメント

次のステップ

次に、デベロッパー デバイス プラットフォームの Device Streaming API をお試しください。