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

このガイドでは、 デベロッパー デバイス プラットフォーム デバイス実行ガイドに沿ってトリガーされたテストの結果を確認する方法について説明します。

始める前に

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

コマンドラインで

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

gcloud beta device-run sessions describe your_session_id

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

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

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

gcloud beta device-run sessions describe your_session_id --full

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

name: projects/your-project-id/locations/global/sessions/session-370961e1
sessionConfig:
  displayName: instrumentation-session
  jobConfigs:
  -   action:
      androidInstrumentationTest:
        testInstallable:
          files:
          -   gcsInputFile:
              path: gs://your-project-id-devicerun/automation/inputs/2026-07-30_11:28.31915956_8514/app_name_test.apk
    allocationConfig:
      deviceConfigs:
      -   actions:
        -   androidInstallPackages:
            installables:
            -   files:
              -   gcsInputFile:
                  path: gs://your-project-id-devicerun/automation/inputs/2026-07-30_11:28.31915956_8514/app_name.apk
        -   androidLogcat: {}
        requirement:
          deviceId: pa3q-35
    displayName: job-000
  outputDirectoryConfig:
    gcsOutputDirectory:
      path: gs://your-project-id-devicerun/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://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/logcat.txt
      -   gcsOutputFile:
          path: gs://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/instrument.log
      -   gcsOutputFile:
          path: gs://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/test_result.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/storage/browser/<your_project_id>/automation/sessions/<session_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-*] を選択して test_result_merged.xml を表示します。これには、すべてのテストケースにわたる包括的な結果の詳細が含まれています。
  11. execution-* を開くと、個々のシャードの内訳が表示されます。このフォルダ内で、次の場所に移動します。
    • instrumentation.log
    • logcat.txt
    • test_result.xml
  12. 公開 URL と認証済み URL にアクセスして、テスト結果を確認します。

ファイル構造

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

-   gs://my_project_id_devicerun/automation
  -   inputs/
    -   2026-05-29_10:13.026220_JZTM
      -   app.apk
      -   test.apk
  -   sessions/
    -   session-number
      -   job-000/
        -   test_results_merged.xml
        -   execution-000/
          -   instrumentation.log
          -   test_result.xml
          -   logcat.txt
          -   video.mp4
        -   execution-001/
          -   instrumentation_output.txt
          -   junit.xml
          -   logcat.txt
          -   video.mp4
      -   job-001/
    -   session-number

結果を把握する

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

サポート ドキュメント

次のステップ

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