使用 CTS v2 控制台
如果是 Android 7.0 以上版本，請使用 CTS v2。
選取方案
可用的測試方案如下：
- cts：從既有的 CTS 安裝執行 CTS。
- cts-camera：在既有的 CTS 安裝環境中執行 CTS-camera。
- cts-java：從現有 CTS 安裝項目執行 Core Java 測試。
- cts-pdk：執行測試，有助於驗證 PDK 融合版本。
- 所有設定 - 相容性套件的常見設定。
其他可用設定包括：
- basic-reporters：設定基本 CTS 回報器。
- collect-tests-only：從現有安裝的 CTS 執行 CTS。
- common-compatibility-config：相容性套件的常見設定。
- cts-filtered-sample：相容性套件的常見設定。
- cts-known-failures：具有 CTS 已知失敗的設定。
- cts-preconditions：CTS 先決條件設定。
- host：對現有裝置執行一項主機式測試。
- instrument - 在現有裝置上執行一項 Android 檢測設備測試。
- native-benchmark：在現有裝置上執行原生壓力測試。
- native-stress：在現有裝置上執行原生壓力測試。
- recharge - 虛假測試，等待即將充電的裝置充電，並保留裝置充電。
- testdef：在現有裝置上執行 test_def.xml 檔案內含的測試。
- util/wifi：公用程式設定：在裝置上設定 Wi-Fi。
- util/抹除：抹除裝置上的使用者資料。
上述所有方案和設定都可以使用 run cts 指令執行。
CTS v2 控制台指令參考資料
下表摘要列出 用途相當廣泛
| 主辦 | 說明 |
|---|---|
help |
顯示最常用的指令摘要 |
help all |
顯示可用指令的完整清單 |
version |
顯示版本。 |
exit |
安全結束 CTS 控制台。控制台會在以下時間關閉： 以及目前執行中的測試已完成 |
extdir |
壓縮的下載檔案已解壓縮為
如要解壓縮至目前的目錄，請勿使用
|
| 執行 | 說明 |
run cts |
在 Android 10 中，執行預設的 CTS 方案和 CTS-Instant ，也就是完整的 CTS 叫用。如果是 Android 9 以下版本，請執行預設值 僅適用於 CTS 方案。使用這個全面的選項 (包括先決條件) 驗證裝置。 如要瞭解納入資訊，請參閱 cts.xml。 CTS 主控台可以在測試進行時接受其他指令。 如果沒有連接任何裝置，CTS 桌機 (或主機) 會等候 ，在開始測試前可連線的裝置。如有多個 裝置連線，CTS 主機會選擇一部裝置 。 |
run cts-instant |
如果是 Android 9，請執行預設的 CTS-Instant 方案。 |
run cts --module-parameter INSTANT_APP |
在 Android 10 中執行預設的 CTS-Instant 方案。 |
run cts --module-parameter INSTANT_APP --module/-m test_module_name |
在 Android 10 中執行指定的 CTS-Instant 測試模組 或模組 |
run retry |
僅限 Android 9 以上版本。重試所有失敗或未執行的測試
以及先前的工作階段例如
|
run cts-sim |
適用於 Android 11 以上版本。對 安裝 SIM 卡的裝置。 |
--device-token |
適用於 Android 8.1 以下版本。指出特定裝置已具備
產生下一個符記例如： |
--enable-token-sharding |
僅適用於 Android 10 以上版本。自動
符合
需要對應的 SIM 卡類型。不需提供要執行的裝置序號
SIM 卡相關測試案例。支援的 SIM 卡： |
run cts-dev |
執行預設 CTS 方案 (也就是完整的 CTS 叫用)，但
略過先決條件，以便反覆開發新的
測試。這樣會略過裝置的
例如推送媒體檔案或檢查 Wi-Fi
則與使用 CTS 主控台可以在測試進行時接受其他指令。 如果沒有連接任何裝置，CTS 桌機 (或主機) 會等候 ，在開始測試前可連線的裝置。如有多個 裝置連線，CTS 主機會選擇一部裝置 。 |
--subplan subplan_name |
執行指定的子計畫。 |
--module/-m test_module_name --test/-t test_name |
執行指定的模組並進行測試。例如：
run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes
執行特定套件、類別或測試
|
--retry |
重試所有先前工作階段中失敗或未執行的測試。
請使用 list results 取得工作階段 ID。 |
--retry-type NOT_EXECUTED |
只重試先前工作階段未執行的測試。
請使用 list results 取得工作階段 ID。 |
--shards number_of_shards |
Android 8.1 以下版本。分割 CTS 並在多部裝置上執行的獨立區塊 平行處理 |
--shard-count number_of_shards |
Android 9。將 CTS 資料分割至指定的數量 多部獨立區塊，因此可在多部裝置上並行執行。 |
--serial/-s deviceID |
在特定裝置上執行 CTS。 |
--include-filter "test_module_name test_name" |
使用指定模組執行，或測試套件、類別和案例。例如：
run cts --include-filter
"CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"
包含指定的模組
執行重試時不支援這個指令選項。 |
--exclude-filter "test_module_name test_name" |
從執行作業中排除指定模組，或測試套件、類別和案例。例如：
run cts --exclude-filter "CtsCalendarcommon2Test
android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"
排除指定的模組。
|
--log-level-display/-l log_level |
執行時，會以顯示最低指定的記錄檔層級
STDOUT。有效值：[VERBOSE,
DEBUG、INFO、WARN、
ERROR，ASSERT]。 |
--abi abi_name |
強制測試在指定的 ABI、32 或 64 上執行。預設 CTS 而是針對裝置支援的每個 ABI 執行一次測試。 |
--logcat-on-failure、--bugreport-on-failure、--screenshoot-on-failure |
深入掌握故障情形，有助於診斷。 |
--device-token |
指定特定裝置具有特定權杖，例如
--device-token 1a2b3c4d:sim-card。 |
--skip-device-info |
略過收集裝置資訊的步驟。 |
--skip-preconditions |
略過先決條件，以便反覆開發 新的測試。這樣會略過裝置的 例如推送媒體檔案或檢查 Wi-Fi 以獲得最佳效能和最安全的連線 |
| 清單 | 說明 |
list modules |
列出存放區中所有可用的測試模組。 |
list plans 或 list configs |
列出存放區中所有可用的測試計畫 (設定)。 |
list subplans |
列出存放區中所有可用的子方案。 |
list invocations |
列出目前在裝置上執行的 run 指令。 |
list commands |
列出佇列中目前正在等待指派給裝置的所有 run 指令。 |
list results |
列出目前儲存在存放區中的 CTS 結果。 |
list devices |
列出目前連結的裝置及其狀態。
可用裝置可正常運作且處於閒置狀態，可用於執行測試。
無法使用的裝置是透過 ADB 顯示，卻沒有回應 ADB。 而不會為測試分配。
已分配的裝置是指正在執行測試的裝置。 |
| 傾印 | 說明 |
dump logs |
傾印所有執行中叫用的換購記錄。 |
| 新增 | 說明 |
add subplan --name/-n subplan_name |
根據前一個工作階段建立子計畫；這個選項會產生
可用來執行部分測試的子計畫。 唯一 必要選項為 --session。有些是選填欄位，但如果
後面必須加上一個值
「--result-type」選項可重複；例如
「add subplan --session 0 --result-type passed --result-type
failed」有效。 |