本頁說明如何設定及執行 CTS Verifier (CTS-V) 主機端 Android 16 QPR2 和 Android 17 測試。主機端測試分為兩種：多裝置測試 (Android 17 之前推出) 和互動式測試 (Android 17 新增)：
- 多裝置測試是全自動化測試。
- 互動式測試屬於半自動化測試，您必須在受測裝置 (DUT) 上執行一些手動步驟。
除了新的互動式測試，手動測距準確度和電信測試現在是主機端多裝置測試，且必須進行 Wi-Fi 連線測試。
設定主機端測試
請按照下列步驟設定主機端測試 (多裝置測試需要額外設定)：
確認桌機符合 CTS 的作業系統需求。
按照「安裝電腦軟體」的步驟 2 和 5 操作，在電腦上安裝 adb、AAPT2 和 Python，並確認安裝正確。
電腦的 Python 版本必須為 3.11 以上。如要判斷 Python 版本，請執行
python3 --version。如果版本低於 3.11，請安裝最新的 Python 正式版本。詳情請參閱「python.org」的「下載」部分。部分測試需要主機具備 Python
venv模組。在 Debian 和 Ubuntu 系統上，這個模組可能不會預設安裝。如要判斷電腦版 Python 是否有venv模組，請執行python3 -m venv venv。如果這個指令失敗，系統會顯示錯誤訊息。按照提示安裝python3.x-venv套件。
如果只執行主機端互動式測試，請繼續執行「執行主機端測試」。不過，如要執行多裝置測試，請繼續設定主機端多裝置測試。
設定主機端多裝置測試
如要設定主機端多裝置測試，請按照下列步驟操作：
確認桌機符合 CTS 的作業系統需求。
按照「安裝電腦軟體」的步驟 2 和 5 操作，在電腦上安裝 adb、AAPT2 和 Python，並確認安裝正確。
電腦的 Python 版本必須為 3.11 以上。如要判斷 Python 版本，請執行
python3 --version。如果版本低於 3.11，請安裝最新的 Python 正式版本。詳情請參閱「python.org」的「下載」部分。- 部分測試需要主機具備 Python
venv模組。在 Debian 和 Ubuntu 系統上，這個模組可能不會預設安裝。如要判斷電腦版 Python 是否有venv模組，請執行python3 -m venv venv。如果這個指令失敗，系統會顯示錯誤訊息。按照提示安裝python3.x-venv套件。
- 部分測試需要主機具備 Python
準備兩部相符的 DUT，並分別設定 CTS-V。
前往測試類型的設定章節：
- 如要進行 NFC 測試，請參閱「設定 NFC 測試」。
- 如要進行 Wi-Fi AP 連線測試，請參閱「設定 Wi-Fi AP 連線測試」。
- 如要進行測距準確度測試，請參閱「設定測距準確度測試」。
- 如要測試 CDM 模組，請先參閱「設定標準雙裝置測試」，然後參閱「設定 CDM 測試」。
如果測試不在清單中，請繼續進行「設定標準雙裝置測試」。
設定 NFC 測試
NFC 測試會使用一個 DUT 和一個 PN532 NFC 晶片。
如要設定 NFC 測試，請按照下列步驟操作：
- 購買 PN532 NFC 晶片。建議使用多合一 PN532。
- 在 DUT 上前往「設定」應用程式。
- 啟用「NFC」。
放置 NFC 晶片：
如果是手機，請如圖 1 所示放置 DUT 的 NFC 讀取器：
圖 1. NFC 晶片位置。
如果是其他裝置類型，請將晶片放在裝置的 NFC 天線旁。
使用 USB 傳輸線將 PN532 NFC 晶片連接至測試工作站。
設定 Wi-Fi AP 連線測試
Wi-Fi 存取點 (AP) 連線測試 (CtsWifiConnectionTests) 會測試 DUT 與 AP 之間的連線。您可以透過下列兩種方式設定這些測試：
- 方法 1：使用為 CTS-V 設定的現有 Wi-Fi 網路。
- 方法 2：設定可程式化的存取點 (AP)。
對於 Android 17，我們強烈建議使用選項 2，但這並非必要。以下兩節將說明各個選項。
方法 1：使用為 CTS-V 設定的現有 Wi-Fi 網路
選項 1 需要一個位於 Wi-Fi 網路涵蓋範圍內的 Android DUT。如果 DUT 位於遮蔽盒中，且無法連上 Wi-Fi 網路，請從遮蔽盒中取出 DUT。
方法 2：設定可程式化的 AP
如要設定可程式化 AP 進行 Wi-Fi 連線測試，請按照下列步驟操作：
購買並設定 Banana Pi R3 AP。如要瞭解如何購買及設定 Banana Pi R3 AP，請參閱「設定 Banana Pi BPI-R3 AP」。
(選用) 如果沒有遮蔽盒，建議使用 JTP-SR101 遮蔽盒。請使用下列資訊購買這款盒子：
東莞正聲電子科技有限公司LTD
中國廣東省東莞市寮步鎮蟠龍路博匯工業園
聯絡人：Forest Pan
電子郵件地址：forest.pan@jtpmak.cn
電話 (中國)：+86 18676993556
將 DUT 和 AP 連接至主機，然後放入 RF 遮蔽盒。DUT 和 AP 之間應間隔至少 10 公分。圖 2 顯示這種設定：
圖 2. 盾牌盒中的 DUT 和 AP。
使用 SSH 確認主機可存取 AP。
設定測距準確度測試
如要設定測距準確度測試，請按照下列步驟操作：
將兩部相符的 Android DUT 放在同一高度，彼此相距 1 公尺，且兩部裝置背面相對，中間沒有任何阻礙。圖 3 顯示這種方向：
圖 3. 裝置螢幕方向。
使用 USB 傳輸線將兩部裝置連接至桌上型電腦。
設定標準雙裝置測試
預設的雙裝置設定：
將兩個相符的 Android DUT 放在約 20 公分處。
強烈建議：將兩部裝置都放入防護盒。防護盒可提升測試穩定性，並簡化測試失敗的偵錯作業。
如要進行電信測試，每個 DUT 都必須有 SIM 卡和行動網路訊號。如果 DUT 位於遮蔽盒中，則必須將蜂巢式訊號耦合至該盒。否則，請將裝置移出防護盒。
選用：設定 OTA 封包嗅探器，進行 Wi-Fi 偵錯。
設定 CDM 測試
test_permissions_sync 測試案例的行為會因執行測試的裝置建構類型而異。OEM 必須同時測試可偵錯 (userdebug 或 eng) 和不可偵錯 (user) 的建構版本，並確保兩者都通過測試。
豁免資格
權限同步 API 實作的 CDD 條款僅要求 API 能夠透過安全管道在裝置之間順利傳輸資料。由於安全管道實作並非 CDD 規範要求，因此在非可偵錯 (使用者) 建構版本中，可以略過這項測試，但前提是您想選擇不支援 CDM 權限同步功能。
測試必須在可偵錯的建構版本上通過，不得有例外狀況。
在無法偵錯的建構版本上進行測試的事前準備
如果沒有豁免，請確認您符合下列先決條件。
安全管道會使用 AVF (AttestationVerificationFramework) 驗證硬體的可靠性。雙方產生的認證都包含自身的幾項資訊，以驗證系統未經授權變更。AVF 會在驗證程序中檢查下列狀態：
裝置可連上網際網路
裝置使用驗證開機程序，且建構版本是使用發布金鑰 (而非開發金鑰) 簽署
裝置已鎖定系統啟動載入程式。詳情請參閱「鎖定開機載入程式」。
OS、主要啟動和主要供應商修補程式層級在 12 個月內。請勿使用超過一年的舊版建構版本。
裝置驗證是由供應商核准的根憑證之一所支援。在
vendor_required_attestation_certificates.xml資源疊加層中指定信任的根憑證。
執行主機端測試
部分多裝置測試 (例如 NFC 測試) 需要額外設定。如需額外設定的測試，則會分別執行每項測試。如果測試不需要額外設定，您可以在群組中執行測試。
在測試工作站上，從解壓縮 CTS-V zip 封裝的目錄啟動
cts-v-host控制台：./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed在 DUT 上的 CTS-V 應用程式中，按一下「主機端測試」。圖 4 顯示 CTS-V 應用程式中的主機端測試：
圖 4. CTS-V 應用程式中的主機端測試。
畫面上會顯示主機端多裝置測試模組清單。
在 CTS-V 主機控制台中，使用下列指令執行多裝置測試，並採用標準的雙裝置設定：
run cts-v-host-multidevice-default測試結果會顯示在 DUT 上 CTS-V 應用程式的每個測試模組下方。綠色標示的測試已通過，紅色標示的測試則失敗。
圖 5 顯示 CtsCompanionDeviceManager 測試的結果範例：
圖 5. CTS-V 應用程式中的主機端多裝置測試結果。
在 CTS-V 主機控制台中，使用下列指令執行互動式測試：
run cts-v-host-interactive測試結果會顯示在 DUT 上 CTS-V 應用程式的每個測試模組下方。綠色標示的測試已通過，紅色標示的測試則失敗。
針對需要額外設定的每項測試，請使用下列指令分別執行測試：
run cts-v-host -m test_module_name舉例來說，如要執行 NFC 測試，請使用下列指令：
run cts-v-host -m CtsNfcHceMultiDeviceTestCases測試結果會顯示在 DUT 上 CTS-V 應用程式的每個測試模組下方。綠色標示的測試已通過，紅色標示的測試則失敗。
執行 Wi-Fi AP 連線測試
你可以透過下列兩種方式執行 Wi-Fi AP 連線測試：
- 方法 1：使用為 CTS-V 設定的現有 Wi-Fi 網路。
- 方法 2：設定可程式化的 AP。
方法 1：使用為 CTS-V 設定的現有 Wi-Fi 網路
如要在現有 Wi-Fi 網路上執行 Wi-Fi AP 連線測試，請按照下列步驟操作：
編輯測試平台設定檔 (
WifiConnectionTestbed.yaml)。這個檔案位於解壓縮 CTS-Verifier 的目錄中。例如：./android-cts-verifier/android-cts-v-host/testcases/CtsWifiConnectionTests/x86_64/connection/WifiConnectionTestbed.yaml將
wifi_ssid和wifi_password欄位的值變更為 Wi-Fi 網路的 SSID 和密碼。以下範例顯示這些設定的位置：TestBeds: - Name: WifiConnectionTestbed Controllers: AndroidDevice: '*' TestParams: use_programmable_ap: False wifi_ssid: WIFI-SSID wifi_password: WIFI-PASSWORD在 CTS-V 主機控制台中，執行下列指令：
run cts-v-host -m CtsWifiConnectionTests
選項 2：使用可程式化的 AP 執行
如要在可程式化 AP 上執行 Wi-Fi AP 連線測試，請按照下列步驟操作：
編輯測試平台設定檔 (
WifiConnectionTestbed.yaml)。這個檔案位於解壓縮 CTS-Verifier 的目錄中。例如：./android-cts-verifier/android-cts-v-host/testcases/CtsWifiConnectionTests/x86_64/connection/WifiConnectionTestbed.yaml根據本機 SSH 設定，將
hostname的值變更為 AP 的 IP 位址。如要找出 IP 位址，請參閱「找出 AP 的 IP 位址」。以下範例顯示hostname設定的位置：TestBeds: - Name: WifiConnectionTestbed Controllers: AndroidDevice: '*' # Specify settings for the AP. OpenWrtDevice: - hostname: AP-IP skip_init_reboot: True TestParams: use_programmable_ap: True在 CTS-V 主機控制台中，執行下列指令：
run cts-v-host -m CtsWifiConnectionTests
執行 USB 主機端測試
Android 17 包含 USB CTS-V 主機端測試，需要透過 Wi-Fi 執行 adb。
部分 USB 測試需要使用 CTS-V 主機存取 SystemAPI，這些 API 具有一般 CTS-V 應用程式無法存取的權限。這類測試不需要連接線，且必須透過 Wi-Fi 使用 adb。
如果 DUT 支援在 UsbPort.java 中回報連接埠合作夥伴 BC 1.2 類型或 USB 電源設定檔，則必須使用下列 Type-C 配件：
- USB Type-C Power Delivery (PD) 充電器
- USB 電池充電 1.2 (BC 1.2) 標準下游連接埠 (SDP)。這些連接埠只能為 DUT 提供 500 mA 或 900 mA，常見於外部集線器的 USB 連接埠。
- USB BC 1.2 充電下游連接埠 (CDP)。這些連接埠可為 DUT 提供 1.5 安培的電流和資料。筆電或電腦上的 Type-C 連接埠很可能就是 CDP。
- USB BC 1.2 專用充電埠 (DCP)。這些通訊埠可為 DUT 提供 1.5 安培電流，但不傳輸資料。這份清單中的 USB Type-C PD 充電器很可能是 DCP。
使用
adb透過 Wi-Fi 連線至 DUT。如需設定詳情，請參閱「透過 Wi-Fi 連線至裝置」。從所有 USB 連接埠拔除裝置。如果執行測試指令時，裝置連接任何 USB 主機或配件，測試就會失敗。
執行下列測試指令：
run cts-v-host -m CtsUsbTypecTestCases
測試完成後，結果會顯示在 CTS-V 應用程式的「主機端測試」下方，如下圖所示：
圖 6. CTS-V 應用程式中的主機端 USB 測試。
圖 7. 主機端 USB CTS-V 應用程式中的 CtsUsbTypecTestCases 套件。
排解多裝置測試問題
本節說明常見問題的疑難排解方式。
在 CtsTelecomTest 期間無法取得電話號碼
如果收到「Failed to get phone number for <serial>」錯誤訊息，請按照下列步驟操作：
確認每個 DUT 都已安裝 SIM 卡。
如果錯誤持續發生，可能是因為 SIM 卡不支援自動擷取號碼，因此您必須在指令中明確提供電話號碼。
舉例來說，如果是 DUT 1 (序號
17011FDEE0002N，電話號碼555-0000) 和 DUT 2 (序號R3CN90YNAR，電話號碼555-1111)，請將下列引數附加至run cts-v-host指令：--module-arg CtsTelecomTest:dut_serial:17011FDEE0002N \ --module-arg CtsTelecomTest:dut_phone_number:555-0000 \ --module-arg CtsTelecomTest:ref_phone_number:555-1111
在 CtsMultiDeviceGenericRangingAccuracyTests 期間，伺服器沒有回應
如果收到下列錯誤訊息，表示測試應用程式可能在特定裝置上凍結或終止，這是因為 OEM 專屬的背景程序管理所致：
mobly.snippet.errors.ProtocolError: <AndroidDevice|Initiator> No response from server. Check the device logcat for crashes.
如要解決這個問題，請停用背景限制，或將下列套件加入允許清單：
| 套件 | 顯示名稱 |
|---|---|
com.google.snippet.uwb |
CtsUwbSnippetApp |
com.google.snippet.ranging |
CtsRangingSnippetApp |
com.google.snippet.bluetooth |
CtsBluetoothMultiDeviceSnippetApp |
com.google.android.mobly.snippet.bundled |
androidx.multidex.MultDexApplication |
修正 NFC 測試期間「GetFirmwareVersion」沒有回應的問題
如果在執行多裝置測試時收到 verify_firmware_version RuntimeError: No response
for GetFirmwareVersion 訊息，表示測試無法存取 PN532 NFC 板。
如要修正這個問題，請找出主機上 PN532 NFC 板使用的序列路徑 (例如 dev/ttyUSB1)，然後在控制台中使用 --module-arg 引數手動指定該路徑：
run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1
修正 NFC 測試期間顯示的「交易失敗」錯誤訊息
如果所有 NFC 測試案例都收到 Transaction failed, check device logs for more
information. 訊息，可能是因為 DUT 的 NFC 晶片無法偵測到 PN532。
如果有多部裝置連線至主機，且部分裝置未放置 PN532，系統可能選取了錯誤的 DUT。詳情請參閱「設定 NFC 測試」。
如要修正這個問題，請採取下列任一做法：
使用
-s標記，在主機端測試指令中設定正確的 DUT 序號。從主機拔除所有非 DUT 裝置。