進行我們的可用性調查以改進此站點。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

使用CTS驗證程序

Android兼容性測試套件驗證程序(CTS驗證程序)對兼容性測試套件(CTS)進行了補充。 CTS會檢查可以自動化的API和功能,而CTS Verifier會提供對API和功能的測試,這些API和功能在沒有手動輸入的情況下無法在固定設備上進行測試,例如音頻質量,觸摸屏,加速度計和相機。

要求

在運行CTS Verifier之前,請確保您具有以下設備:

  • 通過成功通過CTS驗證了Android API兼容性的Android設備。這是被測設備(DUT)。
  • 具有USB 2.0兼容端口的Linux計算機。與DUT的所有連接都通過此端口。
  • 第二款具有已知兼容藍牙,Wi-Fi Direct和NFC主機卡仿真(HCE)實現的Android設備。
  • 使用訪問點名稱和密碼配置的Wi-Fi路由器。路由器應具有斷開Internet連接的能力,但不能關閉電源。

配置

如下將測試設備的系統導航模式更改為三鍵模式:

  1. 打開設置。
  2. 導航至系統>手勢>系統導航
  3. 選擇任何基於按鈕的導航模式,如果有的話,最好選擇三按鈕模式。

要設置CTS驗證程序測試環境,請執行以下操作:

  1. 在Linux計算機上:
    • 在安裝CTS驗證程序之前,請運行以下命令以允許訪問非SDK接口。
      adb shell settings put global hidden_api_policy 1
      
    • 安裝Android Studio
    • 下載適用於Android版本的CTS驗證程序APK進行測試。
  2. 將DUT連接到Linux計算機。
  3. 在Linux計算機的終端上,在DUT上安裝CtsVerifier.apk
    adb install -r -g CtsVerifier.apk
    
  4. 對於Android 10及更高版本,請運行以下命令,以授予該應用創建報告的權限。
    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. 對於Android 11或更高版本,運行以下命令以允許將報告保存在設備外部頂級目錄下的自定義目錄中。

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. 確保DUT正確設置了系統數據和時間。

跑步

通過點擊DUT上的CTS Verifier圖標啟動CTS Verifier應用程序。

啟動器中的CTS Verifier圖標
圖1. CTS Verifier圖標

該應用程序顯示幾個可用於手動驗證的測試集。

CTS驗證程序的測試菜單
圖2. CTS Verifier測試菜單

每個測試在屏幕底部都包含一組公共元素(信息,通過,失敗)。

流式視頻質量驗證器
圖3.測試元素
  • 信息(?)。點擊以顯示測試說明。首次打開測試時也會自動出現。
  • 通過(✓)。根據信息說明,如果DUT滿足測試要求,請點擊。
  • 失敗(!)。如果DUT不符合信息說明中的測試要求,請點擊。

某些測試(例如USB附件模式和相機校準測試)需要其他測試設置和說明,如以下部分所述。

測試8.0及以上版本的USB附件模式

CTS Verifier USB附件測試
圖4. 8.0及更高版本的USB附件測試步驟
CTS Verifier USB附件測試
圖5.測試8.0及更高版本的USB附件模式

測試7.x及以下版本的USB附件模式

USB附件測試需要Linux計算機才能運行USB台式機(主機)程序。

  1. 將DUT連接到Linux計算機。
  2. 在計算機上,從CTS驗證程序包中執行cts-usb-accessory程序:
    ./cts-usb-accessory
  3. 等待彈出消息出現在DUT上,然後選擇OK
    CTS Verifier USB附件測試
    圖6. USB附件測試
  4. 轉到DUT上CTS驗證程序應用程序中的USB附件測試。
  5. 在計算機上,查看控制台的輸出。輸出示例:
    CTS USB Accessory Tester
    Found possible Android device (413c:2106) - attempting to switch to accessory
    mode...
    Failed to read protocol versionfigure3
    Found Android device in accessory mode (18d1:2d01)...
    [RECV] Message from Android device #0
    [SENT] Message from Android accessory #0
    [RECV] Message from Android device #1
    [SENT] Message from Android accessory #1
    [RECV] Message from Android device #2
    [SENT] Message from Android accessory #2
    [RECV] Message from Android device #3
    [SENT] Message from Android accessory #3
    [RECV] Message from Android device #4
    [SENT] Message from Android accessory #4
    [RECV] Message from Android device #5
    [SENT] Message from Android accessory #5
    [RECV] Message from Android device #6
    [SENT] Message from Android accessory #6
    [RECV] Message from Android device #7
    [SENT] Message from Android accessory #7
    [RECV] Message from Android device #8
    [SENT] Message from Android accessory #8
    [RECV] Message from Android device #9
    [SENT] Message from Android accessory #9
    [RECV] Message from Android device #10
    [SENT] Message from Android accessory #10
    

校準相機視場

使用視場校準程序以中等精度快速確定設備的視場。

  1. 設置測試環境:
    1. 在11英寸x 17英寸或A3尺寸的紙張上打印Calibration-pattern.pdf目標文件。
    2. 將打印的圖案安裝在剛性背襯上。
    3. 如下所示調整相機設備和打印目標的方向。
      相機打印目標
      圖7.相機打印的目標
  2. 設置目標寬度:
    1. 測量目標圖案上的實線之間的距離(以厘米為單位),以解決打印不准確的問題(〜38 cm)。
    2. 啟動校準應用程序。
    3. 按設置按鈕,然後選擇標記距離
    4. 測量並輸入到目標圖案的距離(約100厘米)。
    5. 按返回按鈕返回到校準預覽。
  3. 驗證是否已如圖所示放置設備和目標,並且在設置對話框中輸入了正確的距離。預覽顯示圖像,並在其上覆蓋一條垂直線。該線應與目標圖案的中心線對齊。透明柵格可以與其他垂直線一起使用,以確保光軸與目標正交。
  4. 運行校準測試:
    1. 選擇圖像分辨率(使用左下方的選擇器),然後點擊屏幕拍攝照片。測試進入校準模式,並在照片上顯示兩條垂直線。
    2. 確定精度:
      • 如果這些線與目標圖案上的垂直線在幾厘米內對齊,則選定的重新佈置的報告視野是準確的。
      • 如果線條不對齊,則報告的視野不正確。要解決此問題,請調整屏幕底部的滑塊,直到覆蓋圖與目標圖案盡可能接近為止。當覆蓋圖和目標圖案圖像對齊時,顯示的視場非常接近正確值。報告的視野應在校準值的+/- 1度範圍內。
    3. 按返回按鈕,然後對DUT支持的所有圖像分辨率重複進行校準測試。

匯出結果

完成所有測試後,您可以將結果另存為報告,並將其下載到計算機。報告名稱會根據DUT系統時間自動加上時間戳。

  1. 點擊保存(磁盤)圖標。
    CTS驗證程序保存圖標
    圖8. CTS Verifier Save圖標
  2. 等待彈出消息顯示已保存報告的路徑(例如/sdcard/verifierReports/ctsVerifierReport-date-time.zip ),然後記錄該路徑。
    保存報告的CTS驗證程序路徑
    圖9. CTS驗證程序到保存報告的路徑
  3. 將DUT連接到Linux計算機。
  4. 在Linux計算機上的Android SDK安裝中,使用adb shell content readadb pull CTSVerifierReportPath從連接的設備下載報告。
    • 對於Android 7.x和更高版本,請使用以下命令下載所有報告:
      adb pull /sdcard/verifierReports
      
    • 對於Android 6.0及更低版本,請使用以下語言下載所有報告:
      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • 對於Android 10及更高版本(實現了Automotive和作為次要用戶運行的設備),請使用以下命令下載最新報告:

      adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip

      要列出已連接設備中的所有可用報告:

      adb shell content query --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports

      要從列表中下載報告,您可以指定行ID或文件名。例如:

      adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
      adb shell content read --user CURRENT_USER --uri
      content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
  5. 要清除通過/失敗結果,請在CTS Verifier應用中選擇結果,然後選擇菜單>清除