運行 CTS 測試

Trade Federation 是一個用於在 Android 設備上運行測試的持續測試框架。要運行兼容性測試套件 (CTS),請先閱讀Trade Federation 概述,了解 Tradefed 測試框架。

要運行測試計劃:

  1. 根據Android 設備設置設置待測設備 (DUT)。
  2. 確保您已安裝最新版本的Android Debug Bridge (adb)Android Asset Packaging Tool (AAPT) ,並將這些工具的位置添加到您機器的系統路徑中。有關安裝這些工具的信息,請參閱設置 CTS:ADB 和 AAPT。
  3. 將已發布的 CTS 構建下載到您的 Linux 主機上,並將構建解壓縮到主機位置。
  4. 至少連接一台設備。準備 DUT:
    • 主頁按鈕將設備設置為主屏幕。
    • 不要將 DUT 用於任何其他任務。
    • 將 DUT 保持在靜止位置以避免觸發傳感器活動。
    • 將設備攝像頭對準可聚焦的對象。
    • 請勿在 CTS 運行時按設備上的任何鍵。按鍵或觸摸 DUT 的屏幕會干擾正在運行的測試,並可能導致測試失敗。
  5. 從解壓 CTS 包的文件夾中啟動 CTS 控制台cts-tradefed腳本。在主機的命令行 shell 上,運行:

    ./android-cts/tools/cts-tradefed
  6. 運行默認測試計劃(包含所有測試包):

    cts-tradefed > run cts
    • 如果您想縮短測試執行時間,您可以跨多個設備分片測試。分片要求主機至少連接兩台設備,但為了提高效率,建議使用六台或更多設備。分片超過 1 個設備時:

      • 對於 Android 9 及更高版本,請使用命令選項

        --shard-count number_of_shards
      • 對於 Android 8.1 及更低版本,請使用命令選項

        --shards number_of_shards
    • 如果您不想運行整個測試套件,可以從命令行運行您選擇的CTS 計劃

      run cts --plan test_plan_name

      要查找測試計劃名稱:

      • 對於 Android 7.0 及更高版本,要查看測試模塊列表,請輸入

        list modules
      • 對於 Android 6.0 及更低版本,要查看存儲庫中的測試計劃列表,請輸入

        list plans
      • 對於 Android 6.0 及更低版本,要查看存儲庫中的測試包列表,請輸入

        list packages
    • 有關取決於 CTS 版本的其他命令選項,請參閱控制台命令參考或 Tradefed 控制台中的“全部幫助”下。

  7. 運行多個重試會話,直到完成所有測試模塊並且在最後兩個重試會話中測試失敗編號相同。

    • 對於 Android 9 及更高版本,請使用

      run retry --retry session_number --shard-count number_of_shards
    • 對於 Android 7.0–8.1,使用

      run cts --retry session_number --shards number_of_shards
    • 有關取決於 CTS 版本的其他重試命令選項,請參閱CTS v2 命令控制台

    • 要了解 CTS 重試的實施細節,請參閱Trade Federation Suite Retry

  8. 查看控制台上報告的測試進度和結果。

使用 Android 測試站運行 CTS

Android Test Station 是一個測試自動化工具,Android 開發人員和測試工程師可以使用它來使用用戶界面來運行標準測試套件。它適用於Android 兼容性測試套件 (CTS)

該工具可通過ATS 用戶指南公開獲得,其代碼在 AOSP( multitest_transporttradefed_cluster )中開源。

為備用模式運行 CTS

CTS 10 R4 版本為具有備用模式的設備或具有多個屏幕的設備添加了測試計劃。對於備用模式測試計劃,使用命令run cts-foldable執行測試計劃。

備用屏幕模式的通過或失敗的測試用例附加了來自 display_mode 的值,例如testcase1[display_mode=0]