查看開發人員裝置平台測試結果

本指南說明如何找出按照「 開發人員裝置平台裝置執行」指南觸發的測試結果。

事前準備

這些步驟假設您已建立 Google Cloud 專案、完成「開發人員裝置平台快速入門」指南中的設定步驟，並在終端機中透過 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，工作階段中都會產生一個工作。工作索引會按照裝置 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

使用網路瀏覽器

如需完整詳細資料，請從測試輸出內容將測試結果所在的 bucket 網址載入。看起來應該像這樣： https://console.cloud.google.com/storage/browser/storage/browser/<your_project_id>/automation/sessions/<session_id>

如要在 Google Cloud 控制台網頁介面中瀏覽記錄，請按照下列步驟操作：

  1. 在瀏覽器中，將您在 gcloud config set project 指令中使用的專案名稱附加至網址 https://console.cloud.google.com/?project=，然後載入該網頁。
  2. 展開左上方的選單。
  3. 找到「Cloud Storage」。
  4. 在儲存空間選單中選取「Bucket」。
  5. 在第一欄中，按一下專案名稱。
  6. 按一下「自動化」。
  7. 按一下「工作階段」。
  8. 在「篩選器」欄位中，貼上最新測試執行的工作階段 ID (請參閱測試輸出內容)。
  9. 按一下產生的工作階段名稱。
  10. 選取「job-job-*」即可查看 test_result_merged.xml，其中包含所有測試案例的完整結果詳細資料。
  11. 開啟 execution-*，即可查看每個分片的明細。在這個資料夾中，請依序前往：
    • instrumentation.log
    • logcat.txt
    • test_result.xml
  12. 請前往公開和已驗證的網址，瞭解測試結果。

檔案結構

查看 Cloud Storage bucket 中的記錄檔，進一步瞭解測試失敗的原因。檔案結構如下所示：

-   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。