本頁面由 Cloud Translation API 翻譯而成。

執行 CTS 測試

貿易聯盟是一個在 Android 上執行測試的持續測試架構裝置。如要執行 Compatibility Test Suite (CTS)，請先參閱貿易聯盟總覽：進行交易測試架構的解釋

如何執行測試計畫：

設定處於測試狀態的裝置 (DUT)，如下所示： Android 裝置設定。
確認您已安裝 Android Debug Bridge (ADB) 和 Android 資產封裝工具 (AAPT) 並且將這些工具的位置新增至機器的系統路徑。如要進一步瞭解如何安裝這些工具，請參閱設定 CTS：ADB 和 AAPT
將已發布的 CTS 版本下載至 Linux 主體機器，並將版本解壓縮至主機位置。
請至少連接一部裝置。準備 DUT：
- 按下主畫面按鈕，將裝置設為主畫面。
- 請不要將 DUT 用於任何其他工作。
- 將 DUT 固定在靜止位置，以免觸發感應器活動。
- 將裝置相機鏡頭對準可聚焦的物件。
- 請勿在 CTS 執行期間按下裝置上的任何鍵。按下按鍵或觸碰 DUT 螢幕，幹擾執行中的測試可能會導致測試失敗
從 CTS 的資料夾啟動 CTS 控制台 cts-tradefed 指令碼已解壓縮。在主機的指令列殼層中，執行下列指令：
```
./android-cts/tools/cts-tradefed
```
執行預設測試計畫 (包含所有測試套件)：
```
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 版本而定的其他指令選項，請參閱控制台指令參考資料，或「全部說明」部分就能進入交易中心。
  
  **注意：** 在 Android 7.0 中，您可以節省執行時間 (Nougat) 以上版本，方法是使用 `run cts-dev` 指令，而不要使用 `run cts`。這個指令會略過先決條件、裝置資訊的收集程序和所有系統狀態檢查工具它也會在單一 ABI。對於裝置驗證，請避免此最佳化，並加入全部先決條件和檢查
執行多個重試工作階段，直到所有測試模組均完成且過去兩個重試工作階段中，測試失敗次數相同。
- 如果是 Android 9 以上版本，請使用
```
run retry --retry session_number --shard-count number_of_shards
```
  **注意：**「--include-filter」選項不適用新的重試指令支援哪些選項。
- 如果是 Android 7.0 - 8.1，請使用
```
run cts --retry session_number --shards number_of_shards
```
- 如需不同 CTS 版本的其他重試指令選項，請參閱 CTS v2 指令主控台。
- 如要瞭解 CTS 重試的實作詳細資料，請參閱重試聯盟套件重試。
只在失敗的參數化測試執行重試工作階段。通過系統不會重試參數化測試。
- 如果是 Android 11 以上版本，系統會啟用下列重試指令選項安裝在 run cts 指令中：
```
run retry --retry  --new-parameterized-handling
```
透過控制台查看測試進度和結果。

使用 Android Test Station 執行 CTS

Android Test Station 是 Android 開發人員的測試自動化工具工程師可利用使用者介面執行標準測試例如 1、21、11、414 以及可與 Android Compatibility Test Suite (CTS)。

這項工具會經由 ATS 使用手冊、而且相關程式碼的開放原始碼 (multitest_transport、 tradefed_cluster)。

針對替代模式執行 CTS

CTS 10 R4 版本針對提供替代模式的裝置新增測試計畫，提供多個螢幕的裝置使用下列指令執行替代模式測試計畫 run cts-foldable。

通過或失敗的替代螢幕模式測試案例會附加值display_mode，例如 testcase1[display_mode=0]。

在 CTS 13 中，DeviceStateManager API 允許含有下列屬性的測試模組針對摺疊式裝置的不同狀態執行設定選項。根據螢幕折疊狀態，CTS 會自動執行測試執行作業您無需執行 cts-foldable 測試計畫。

<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />

CTS 中的多裝置測試

Android 13 以上版本支援多裝置測試。要求多部裝置在 CTS 執行期間自動執行的測試。 CTS 13 包含部分在資料分割時自動觸發的多裝置測試雖然測試時不必對實體設定進行額外變更，必須安裝「virtualenv」才能正確執行測試詳情請參閱「多裝置套件。

執行多裝置測試

如要獨立執行多裝置測試，請使用下列程式碼：

  cts-tradefed > run cts-multidevice

支援所有一般選項。如要指定特定裝置，請加入裝置的數量為 --serial <serial1> --serial <serial2>，以此類推鎖定目標。

如要自動觸發多裝置測試，請使用資料分割 (如 --shard-count 2 中所示)。