執行 CTS 驗證器多裝置測試

本頁說明如何使用 Better Together CTS Verifier (CTS-V) 測試，適用於 Android 16 QPR2 以上版本。

設定主機端多裝置測試

本節說明如何設定多裝置測試。

1. 確認桌上型電腦符合 CTS 的作業系統需求。

2. 請按照「安裝電腦軟體」一文中的步驟 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 套件。

3. 準備兩部相符的受測裝置 (DUT)，並分別設定 CTS-V。

   • 如要瞭解如何設定 DUT，請參閱「設定 DUT」一文。
   • 如需設定 CTS-V 的操作說明，請參閱「設定」。

4. 前往測試類型的設定專區：

   • 如要進行 NFC 測試，請參閱「設定 NFC 測試」。
   • 如要進行 Wi-Fi AP 連線測試，請參閱「設定 Wi-Fi AP 連線測試」。
   • 如要測試 CDM 模組，請參閱「設定標準雙裝置測試」和「設定 CDM 測試」。

   如果清單中沒有您的測試，請繼續進行「設定標準雙裝置測試」

設定 NFC 測試

NFC 測試會使用一個 DUT 和一個 PN532 NFC 晶片。

如何設定 NFC 測試：

1. 購買 PN532 NFC 晶片。建議使用多合一 PN532。

2. 在 DUT 上前往「設定」應用程式。

3. 啟用「NFC」。

4. 放置 NFC 晶片：

   • 如果是手機，請如圖 1 所示放置 DUT 的 NFC 讀取器：

     

     圖 1. NFC 晶片位置。

   • 如果是其他裝置類型，請將晶片放在裝置的 NFC 天線旁。

5. 使用 USB 傳輸線將 PN532 NFC 晶片連接至測試工作站。

選用步驟：設定 Wi-Fi AP 連線測試

Wi-Fi 存取點 (AP) 連線測試 (CtsWifiConnectionTests) 會測試 DUT 與 AP 之間的連線。強烈建議您執行這些測試，但 CTS-V Android 16 16 QPR2 並未強制要求。

這些測試需要 DUT 和 OpenWrt Banana Pi R3 AP。

如要設定 Wi-Fi AP 連線測試，請按照下列步驟操作：

1. 購買下表列出的 Banana Pi R3 AP 和配件：

   產品	數量
   BPi-R3 電路板，類似於 Banana Pi BPI-R3 路由器電路板，搭載 MediaTek MT7986 晶片設計，支援 Wi-Fi 6、2G DDR RAM、8G eMMC 快閃記憶體	1
   BPi-R3 鋁製錶殼，類似於 BPI-R3 Iron 錶殼	1
   BPi-R3 鋁合金散熱器 (冷卻風扇)，類似於附風扇的 BPI-R3 鋁合金散熱器	1
   2 和 5 GHz 天線 (含纜線)，類似於 BPI 商店中的 5DB 天線	8
   電源變壓器，類似於 12V/2A DC 電源供應器	1

   如要購買，請參閱 Banana Pi BPI-R3 頁面的「輕鬆購買」一節。

2. 設定存取點。如要瞭解如何設定存取點，請參閱「設定 Banana Pi BPI-R3 AP」。

3. 選用：如果沒有遮蔽盒，建議使用 JTP-SR101 遮蔽盒。請使用下列資訊購買這款機上盒：

   東莞正盛電子科技有限公司LTD
   中國廣東省東莞市寮步鎮蟠龍路博匯工業園
   聯絡人：Forest Pan
   電子郵件地址：[e-mail]
   電話 (中國)：[phone]

   注意： 遮蔽盒可隔離外部訊號，並讓 DUT 和 AP 相距 10 公分

4. 將 DUT 和 AP 連接至主機，然後放入 RF 遮蔽盒。DUT 和 AP 之間應間隔至少 10 公分。圖 2 顯示這項設定：

   

   圖 2. 防護盒中的 DUT 和 AP。

5. 使用 SSH 確認主機可以存取 AP。

設定標準雙裝置測試

預設的雙裝置設定：

1. 將兩部相符的 Android DUT 放在相距約 20 公分的位置。

2. 如要設定乾淨的環境，請將兩部裝置放入遮蔽盒。

   注意： 如果這些測試有問題且需要協助，請確認測試是在兩個裝置都放在遮蔽盒中時執行。

3. 選用：設定 OTA 封包嗅探器，進行 Wi-Fi 除錯。

設定 CDM 測試

test_permissions_sync() 測試案例的行為會因執行測試的裝置建構類型而異。原始設備製造商必須同時測試可偵錯 (userdebug 或 eng) 和不可偵錯 (user) 的建構版本，且兩者都必須通過測試。

豁免

權限同步 API 實作的 CDD 條款僅要求能夠透過安全管道在裝置之間順利傳輸資料。由於安全通道實作並非 CDD 相容性規定，因此您可以在無法偵錯 (使用者) 的建構版本中略過這項測試，但前提是您要選擇不支援 CDM 權限同步功能。

測試必須在可偵錯的建構版本中通過，不得有例外狀況。

在無法偵錯的建構版本上進行測試的事前準備

如果先前豁免條款不適用於您，請確認您符合下列先決條件。

安全管道會使用 AVF (AttestationVerificationFramework) 驗證硬體的可靠性。雙方產生的認證都包含多項自身資訊，確保系統未經授權遭到變更。AVF 會在驗證程序中檢查下列狀態：

• 裝置可連上網際網路
• 裝置使用已驗證的啟動程序，且建構版本必須以發布金鑰簽署，而非開發人員金鑰
• 裝置已鎖定系統啟動載入程式。如需詳細操作說明，請參閱鎖定系統啟動載入程式。
• OS、主要啟動和主要供應商修補程式層級在 12 個月內。請勿使用超過一年的舊版

• 裝置認證是由供應商核准的根憑證之一做為後盾。在 vendor_required_attestation_certificates.xml 資源疊加層中指定信任的根憑證。

執行主機端多裝置測試 (Android 開放原始碼計畫 16 以上版本)

CTS Verifier 16 支援主機端多裝置測試。這些測試可在主機上使用自動化指令碼執行，不必在裝置上進行手動測試作業。每項測試完成後，結果會自動上傳至 DUT，並顯示在 CTS 驗證器應用程式中。

本節說明如何執行主機端多裝置測試。

執行多裝置測試

如要執行多裝置測試，請按照下列步驟操作：

1. 在測試工作站上，從解壓縮 CTS-V zip 封裝的目錄啟動 cts-v-host 控制台：

   ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
   

2. 在 DUT 上的 CTS Verifier 應用程式中，按一下「Host-side Tests」。 圖 3 顯示 CTS 驗證器應用程式中的主機端測試：

   

   圖 3. 在 CTS 驗證器應用程式中進行主機端多裝置測試。

   畫面上會顯示測試主機端多裝置測試模組清單。

3. 找出要執行的測試模組名稱。舉例來說，CompanionDeviceManager 模組會列為 CtsCompanionDeviceManagerMultiDeviceTestCases。

   注意： 在 CTS Verifier 應用程式中輕觸主機端模組時，不會看到個別測試案例清單。模組在主機上執行後，UI 會自動填入測試案例結果。

4. 在 cts-v-host 控制台中，執行下列指令：

   run cts-v-host -m test_module_name
   

   例如：

   run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
   

   注意： 如果執行 cts-v-host 時未使用 -m test_module_name，指令會嘗試執行所有測試模組，並忽略裝置和硬體需求方面的差異。請改為執行 run cts-v-host-default-devices 指令，以標準設定做為單一子方案執行測試。
   注意： 您可以使用序號指定要測試的特定 DUT： run cts-v-host -m test_module_name -s\ device1_serial -s device2_serial ...

   xTS 控制台完成測試後，結果會顯示在 CTS 驗證器應用程式中。標示為綠色的測試表示已通過。標示為紅色的測試失敗。圖 4 顯示 CtsCompanionDeviceManager 測試的結果範例：

   

   圖 4. 主機端多裝置測試結果會顯示在 CTS 驗證器應用程式中。

   注意： 主機端結果會自動新增至整體 CTS-V 測試報告。

選用：執行 Wi-Fi AP 連線測試

如要執行 Wi-Fi AP 連線測試，請按照下列步驟操作：

1. 編輯測試平台設定檔 (WifiConnectionTestbed.yaml)。這個檔案位於解壓縮 CTS-Verifier 的目錄中：

   ./android-cts-verifier/android-cts-v-host/testcases/CtsWifiConnectionTests/x86_64/connection/WifiConnectionTestbed.yaml
   

2. 根據本機 SSH 設定，將 hostname 欄位的值變更為 AP 的 IP 位址。如要找出 IP 位址，請參閱「找出存取點的 IP 位址」。

   以下範例顯示 WifiConnectionTestbed.yaml 檔案中 hostname 欄位的位置：

   TestBeds:
   - Name: WifiConnectionTestbed
     Controllers:
       # Specify settings for the AP.
       OpenWrtDevice:
       - hostname: AP-IP
         skip_init_reboot: True
   

3. 在 cts-v-host 控制台中，執行下列指令：

   run everything -m CtsWifiConnectionTests
   

   注意： 如要進一步瞭解 cts-v-host 控制台，請參閱「執行多裝置測試」。

排解多裝置測試問題

本節提供可能問題的疑難排解說明。

修正 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 裝置的連線。

已忽略 CDM 測試案例 test_permissions_sync

如果測試是在無法偵錯的裝置上執行，請確認您是否獲得豁免。如果不是，請確認兩部裝置都符合必要條件。