Sử dụng Trình xác minh CTS

Trình xác minh Bộ kiểm tra khả năng tương thích của Android (Trình xác minh CTS) bổ sung cho Bộ kiểm tra khả năng tương thích (CTS). Trong khi CTS kiểm tra các API và chức năng có thể tự động hóa, CTS Verifier cung cấp các thử nghiệm cho các API và chức năng không thể kiểm tra trên thiết bị cố định nếu không có đầu vào hoặc định vị thủ công, chẳng hạn như chất lượng âm thanh, màn hình cảm ứng, gia tốc kế và máy ảnh.

Yêu cầu

Trước khi chạy CTS Verifier, hãy đảm bảo rằng bạn có các thiết bị sau:

  • Thiết bị Android đã xác minh khả năng tương thích API Android bằng cách vượt qua CTS thành công. Đây là thiết bị đang được thử nghiệm (DUT).
  • Máy tính Linux có cổng tương thích USB 2.0. Tất cả các kết nối đến DUT đều đi qua cổng này.
  • Thiết bị Android thứ hai có Bluetooth, Wi-Fi direct, Wi-Fi Aware, UWB tương thích đã biết (nếu DUT hỗ trợ UWB) và triển khai mô phỏng thẻ máy chủ NFC (HCE).
  • Bộ định tuyến Wi-Fi được định cấu hình với tên và mật khẩu điểm truy cập. Bộ định tuyến phải có khả năng ngắt kết nối Internet nhưng không tắt nguồn.

Đảm bảo bạn cũng chuẩn bị chân máy, giá đỡ thiết bị và khoảng cách đo trước cần thiết cho các bài kiểm tra đo khoảng cách (khoảng cách) dành cho UWB, Wi-Fi NAN và Bluetooth RSSI. Để biết chi tiết, hãy xem Hiệu chỉnh hiện diện .

Yêu cầu UICC cho các bài kiểm tra NFC

Trình xác minh CTS có các trường hợp kiểm tra NFC sau:

  • Tắt nguồn (sử dụng dữ liệu giao dịch từ 0x54)
  • Bỏ chọn (sử dụng dữ liệu giao dịch từ 0x52)
  • Lệnh HCI (0025000000) (sử dụng dữ liệu giao dịch từ 0x02)

Kiểm tra sự kiện giao dịch yêu cầu hai thiết bị, một trong số đó phải có SecureElement UICC với các quy tắc truy cập sau:

  • Hàm băm APK của CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • Mã định danh ứng dụng được ủy quyền (AID) để truy cập sự kiện NFC: 0xA000000476416E64726F696443545341

Về phía trình mô phỏng, chúng tôi mong đợi sự kiện giao dịch sẽ đẩy hoạt động tương ứng lên nền trước.

Cài đặt

Thay đổi chế độ điều hướng hệ thống của thiết bị kiểm tra sang chế độ ba nút như sau:

  1. Mở cài đặt.
  2. Điều hướng đến Hệ thống > Cử chỉ > Điều hướng hệ thống .
  3. Chọn bất kỳ chế độ điều hướng dựa trên nút nào, ưu tiên chế độ ba nút, nếu có.

Để thiết lập môi trường thử nghiệm Trình xác minh CTS:

  1. Trên máy tính Linux:

    • Chạy lệnh sau trước khi cài đặt Trình xác minh CTS để cho phép truy cập vào các giao diện không phải SDK.

      adb shell settings put global hidden_api_policy 1
      
    • Cài đặt Android Studio .

    • Tải xuống APK CTS Verifier cho phiên bản Android để kiểm tra.

  2. Kết nối DUT với máy tính Linux.

  3. Từ thiết bị đầu cuối trên máy tính Linux, hãy cài đặt CtsVerifier.apk trên DUT.

    adb install -r -g CtsVerifier.apk
    
  4. Đối với Android 10 trở lên, hãy chạy lệnh sau để cấp quyền cho ứng dụng tạo báo cáo.

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. Đối với Android 11 trở lên, hãy chạy lệnh sau để cho phép lưu báo cáo vào thư mục tự xác định trong thư mục cấp cao nhất bên ngoài của thiết bị.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. Đối với Android 13 trở lên, hãy chạy lệnh sau để cho phép truy cập API thử nghiệm cho Trình xác minh CTS.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. Đối với Android 14 trở lên, hãy chạy lệnh sau để cấp quyền cho ứng dụng bật màn hình.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
    
  8. Đảm bảo rằng DUT có ngày và giờ hệ thống được đặt chính xác.

Chạy Trình xác minh CTS

Khởi chạy ứng dụng Trình xác minh CTS bằng cách nhấn vào biểu tượng Trình xác minh CTS trên DUT.

Biểu tượng Trình xác minh CTS trong trình khởi chạy

Hình 1. Biểu tượng Trình xác minh CTS

Ứng dụng hiển thị một số bộ thử nghiệm có sẵn để xác minh thủ công.

Danh mục các bài kiểm tra của CTS Verifier

Hình 2. Menu kiểm tra của CTS Verifier

Mỗi bài kiểm tra chứa một tập hợp các phần tử phổ biến ở cuối màn hình.

Trình kiểm tra chất lượng video trực tuyến

Hình 3. Màn hình kiểm tra với các thành phần kiểm tra phổ biến được tô sáng

  • Đạt ( ✓). Nhấn vào nếu DUT đáp ứng các yêu cầu kiểm tra theo hướng dẫn Thông tin.
  • Thông tin (?). Nhấn để hiển thị hướng dẫn kiểm tra. Cũng tự động xuất hiện khi mở bài kiểm tra lần đầu tiên.
  • Thất bại (!). Nhấn vào nếu DUT không đáp ứng các yêu cầu kiểm tra theo hướng dẫn Thông tin.

Một số thử nghiệm, chẳng hạn như chế độ phụ kiện USB và kiểm tra hiệu chỉnh máy ảnh, yêu cầu thiết lập thử nghiệm bổ sung và hướng dẫn chi tiết trong các phần sau.

Kiểm tra chế độ phụ kiện USB cho 8.0 trở lên

Kiểm tra phụ kiện USB CTS Verifier

Hình 4. Quy trình kiểm tra phụ kiện USB cho phiên bản 8.0 trở lên

Kiểm tra phụ kiện USB CTS Verifier

Hình 5. Kiểm tra chế độ phụ kiện USB cho 8.0 trở lên

Kiểm tra chế độ phụ kiện USB cho phiên bản 7.x trở xuống

Kiểm tra Phụ kiện USB yêu cầu máy tính Linux chạy chương trình máy tính để bàn USB (máy chủ).

  1. Kết nối DUT với máy tính Linux.
  2. Trên máy tính, thực thi chương trình cts-usb-accessory từ gói CTS Verifier:

    ./cts-usb-accessory
  3. Đợi thông báo bật lên xuất hiện trên DUT, sau đó chọn OK .
    Kiểm tra phụ kiện USB CTS Verifier

    Hình 6. Kiểm tra phụ kiện USB

  4. Đi tới Kiểm tra phụ kiện USB trong ứng dụng Trình xác minh CTS trên DUT.

  5. Trên máy tính, xem lại kết quả đầu ra từ bảng điều khiển. Đầu ra ví dụ:

    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
    

Hiệu chỉnh trường nhìn của camera

Sử dụng quy trình hiệu chỉnh trường quan sát để nhanh chóng xác định trường quan sát của thiết bị với độ chính xác vừa phải.

  1. Thiết lập môi trường thử nghiệm:

    1. In tệp đích Calibration-pattern.pdf trên giấy khổ 11” x 17” hoặc A3.
    2. Gắn mẫu đã in lên một tấm nền cứng.
    3. Định hướng thiết bị camera và mục tiêu được in như minh họa trong sơ đồ sau.
      Mục tiêu in của máy ảnh

      Hình 7. Mục tiêu được in bằng camera

  2. Đặt chiều rộng mục tiêu:

    1. Đo khoảng cách (tính bằng cm) giữa các đường liền nét trên mẫu mục tiêu để tính đến độ chính xác khi in (~38 cm).
    2. Bắt đầu ứng dụng hiệu chuẩn.
    3. Nhấn nút thiết lập và chọn Khoảng cách đánh dấu .
    4. Đo và nhập khoảng cách đến mẫu mục tiêu (~100 cm).
    5. Nhấn nút quay lại để quay lại bản xem trước hiệu chỉnh.
  3. Xác minh rằng thiết bị và mục tiêu được đặt như trong hình và khoảng cách chính xác đã được nhập vào hộp thoại thiết lập. Bản xem trước hiển thị hình ảnh với một đường thẳng đứng phủ lên nó; đường này phải thẳng hàng với đường trung tâm của mẫu mục tiêu. Lưới trong suốt có thể được sử dụng với các đường thẳng đứng khác để đảm bảo trục quang trực giao với mục tiêu.

  4. Chạy thử nghiệm hiệu chuẩn:

    1. Chọn độ phân giải hình ảnh (sử dụng bộ chọn ở phía dưới bên trái), sau đó chạm vào màn hình để chụp ảnh. Quá trình kiểm tra sẽ chuyển sang chế độ hiệu chỉnh và hiển thị ảnh có hai đường thẳng đứng phủ lên ảnh.
    2. Xác định độ chính xác:
      • Nếu các đường thẳng hàng với các đường thẳng đứng trên mẫu mục tiêu trong phạm vi vài cm thì trường nhìn được báo cáo cho độ phân giải đã chọn là chính xác.
      • Nếu các đường không thẳng hàng thì trường nhìn được báo cáo là không chính xác. Để khắc phục điều này, hãy điều chỉnh thanh trượt ở cuối màn hình cho đến khi lớp phủ căn chỉnh với mẫu mục tiêu càng sát càng tốt. Khi lớp phủ và hình ảnh mẫu mục tiêu được căn chỉnh, trường xem được hiển thị gần đúng với giá trị chính xác. Trường nhìn được báo cáo phải nằm trong khoảng +/- 2 độ của giá trị hiệu chuẩn.
    3. Nhấn nút quay lại và lặp lại kiểm tra hiệu chỉnh cho tất cả độ phân giải hình ảnh được DUT hỗ trợ.

Chạy Trình xác minh CTS cho các chế độ thay thế

Bắt đầu phát hành CTS 10 R6 và CTS 11 R2, CTS Verifier hỗ trợ các thử nghiệm cần thiết cho các thiết bị có chế độ thay thế hoặc cho các thiết bị có nhiều chế độ màn hình.

Ở đầu chế độ xem danh sách chính trong Trình xác minh CTS, một nút được hiển thị để cho phép người dùng chuyển đổi giữa chế độ hiển thị khi mở và gập. CTS Verifier sẽ hiển thị các bài kiểm tra cần thiết cho chế độ hiển thị đã chọn. Để thực hiện các chế độ thay thế trong Trình xác minh CTS, người ta phải chuyển nút sang chế độ hiển thị thích hợp và chạy danh sách kiểm tra được hiển thị.

Công tắc bật tắt CTS-V

Kết quả của bài kiểm tra gấp sẽ được ghi trong cùng một báo cáo với bài kiểm tra chưa mở. Để xác định từng kết quả kiểm tra mà bộ kiểm tra xuất phát, một hậu tố được thêm vào mỗi tên kiểm tra ở chế độ gấp.

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

Xuất kết quả

Sau khi tất cả các bài kiểm tra hoàn tất, bạn có thể lưu kết quả dưới dạng báo cáo và tải chúng xuống máy tính. Tên báo cáo được tự động đóng dấu thời gian dựa trên thời gian của hệ thống DUT.

  1. Để lưu kết quả kiểm tra của bạn, hãy nhấn vào biểu tượng lưu (đĩa) ở đầu danh sách các danh mục kiểm tra.

  2. Đợi thông báo bật lên hiển thị đường dẫn tệp đến báo cáo đã lưu (ví dụ: /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), sau đó ghi lại đường dẫn.

  3. Kết nối DUT với máy tính Linux.

  4. Từ quá trình cài đặt SDK Android trên máy tính Linux, hãy tải xuống báo cáo từ thiết bị được kết nối bằng adb shell content read hoặc adb pull CTSVerifierReportPath .

    • Đối với Android 7.x trở lên, hãy tải xuống tất cả các báo cáo bằng lệnh sau:

      adb pull /sdcard/verifierReports
      
    • Đối với Android 6.0 trở xuống, hãy tải xuống tất cả báo cáo bằng lệnh sau:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Đối với Android 10 trở lên, triển khai Ô tô và các thiết bị chạy với tư cách người dùng phụ , hãy tải xuống báo cáo mới nhất bằng lệnh sau:

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

      Để liệt kê tất cả các báo cáo có sẵn trong thiết bị được kết nối:

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

      Để tải xuống báo cáo từ danh sách, bạn có thể chỉ định ID hàng hoặc tên tệp. Ví dụ:

      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. Để xóa kết quả đạt/không đạt, hãy chọn kết quả trong ứng dụng Trình xác minh CTS và chọn Menu > Xóa .