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

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

Yêu cầu

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

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

Đừng quên chuẩn bị giá ba chân, giá đỡ thiết bị và giá đỡ được đo trước khoảng cách cần thiết cho các bài kiểm tra đo khoảng cách (độ gần) cho UWB, Wi-Fi NAN và Bluetooth RSSI. Để biết thông tin chi tiết, hãy xem Hiệu chỉnh sự hiện diện.

Yêu cầu của UICC đối với bài kiểm tra NFC

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

  • Trường tắt (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)

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

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

Về phía trình mô phỏng, chúng tôi dự kiến sự kiện giao dịch sẽ đẩy giá trị hoạt động vào nền trước.

Thiết lập

Thay đổi chế độ thao tác trên hệ thống của thiết bị thử nghiệm thành chế độ ba nút như sau:

  1. Mở phần Cài đặt.
  2. Chuyển đến phần Hệ thống > Cử chỉ > Di chuyển trên hệ thống.
  3. Chọn chế độ thao tác dựa trên nút bất kỳ, ưu tiên chế độ ba nút, nếu sẵn có.

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

  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 quyền truy cập vào giao diện không phải SDK.

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

    • Tải APK Trình xác minh CTS cho phiên bản Android để kiểm thử.

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

  3. Trên một cửa sổ dòng lệnh 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 trong 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 Người 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 đã đặt ngày và giờ hệ thống chính xác.

Chạy trình xác minh CTS

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 chạy

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

Ứng dụng hiển thị một số tập hợp bài kiểm tra có thể sử dụng để xác minh thủ công.

Trình đơn thử nghiệm Trình xác minh CTS

Hình 2. Trình đơn thử nghiệm Trình xác minh CTS

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

Trình xác minh chất lượng video phát trực tuyến

Hình 3. Màn hình kiểm thử các thành phần kiểm thử phổ biến được làm nổi bật

  • Đạt (✓). Nhấn vào nếu DUT đáp ứng các yêu cầu xét nghiệm theo phần Thông tin .
  • Thông tin (?). Nhấn để xem hướng dẫn kiểm tra. Cũng tự động xuất hiện lần đầu tiên mở thử nghiệm.
  • Không đạt (!). Nhấn vào nếu DUT không đáp ứng các yêu cầu xét nghiệm theo phầ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 hướng dẫn và cách thiết lập thử nghiệm bổ sung như được nêu chi tiết trong các phần sau.

Kiểm thử chế độ phụ kiện USB cho phiên bản 8.0 trở lên

Kiểm tra phụ kiện USB xác minh CTS

Hình 4. Quy trình kiểm tra phụ kiện USB dành cho phiên bản 8.0 và phía trên

Kiểm tra phụ kiện USB xác minh CTS

Hình 5. Kiểm tra chế độ phụ kiện USB cho 8.0 và phía trên

Kiểm tra chế độ phụ kiện USB từ 7.x trở xuống

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

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

    ./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 xác minh CTS

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

  4. Chuyển đến 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, hãy xem lại kết quả trong bảng điều khiển. Kết quả điểm dữ liệu:

    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 máy ảnh

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

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

    1. In mục tiêu calibration-pattern.pdf hồ sơ trên giấy khổ 11” x 17” hoặc A3.
    2. Gắn hoa văn đã in lên mặt sau cứng.
    3. Hướng thiết bị camera và mục tiêu được in như minh hoạ sau đây biểu đồ.
      Đích in của máy ảnh

      Hình 7. Đích in của máy ảnh

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

    1. Đo khoảng cách (tính bằng centimet) giữa các đường liền nét trên mẫu mục tiêu để tính đến lỗi in không chính xác (khoảng 38 cm).
    2. Khởi động ứng dụng hiệu chỉnh.
    3. Nhấn nút thiết lập rồi chọn Khoảng cách đánh dấu.
    4. Đo và nhập khoảng cách tới mẫu mục tiêu (~100 cm).
    5. Nhấn nút quay lại để quay lại chế độ 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 có một đường dọc phủ lên trên; dòng này sẽ căn chỉnh với đường giữa của mẫu mục tiêu. Lưới trong suốt có thể được sử dụng cùng với các đường thẳng đứng khác để đảm bảo rằng trục quang học trực giao với mục tiêu.

  4. Chạy kiểm tra hiệu chỉnh:

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

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

Bắt đầu từ bản phát hành CTS 10 R6 và CTS 11 R2, Trình xác minh CTS hỗ trợ các bài kiểm tra bắt buộc cho các thiết bị có cá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, bạn sẽ thấy một nút để bật người dùng chuyển đổi giữa chế độ màn hình mở và gập. Trình xác minh CTS sẽ hiển thị các kiểm thử cần thiết cho chế độ hiển thị đã chọn. Để thực thi mã thay thế chế độ trong CTS Verifier, người dùng nên chuyển nút sang màn hình thích hợp và chạy danh sách các bài kiểm thử được hiển thị.

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

Kết quả của thử nghiệm gập sẽ được ghi lại trong cùng một báo cáo với kiểm thử. Để xác định từng kết quả kiểm thử mà từ đó tập hợp kiểm thử, hậu tố được thêm vào mỗi tên kiểm thử trong 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ả thử nghiệm 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 đến máy tính. Tên báo cáo được tự động đóng dấu thời gian dựa trên DUT giờ hệ thống.

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

  2. Chờ thông báo bật lên hiển thị đường dẫn tệp đến báo cáo đã lưu (cho 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. Trong phần cài đặt SDK Android trên máy tính Linux, hãy tải báo cáo xuống 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 tất cả báo cáo xuống bằng lệnh sau:

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

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Đối với Android 10 trở lên, việc triển khai Automotive và các thiết bị chạy dưới dạng người dùng phụ, 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
      

      Cách liệt kê tất cả các báo cáo có trong thiết bị đã kết nối:

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

      Để tải báo cáo từ danh sách xuống, bạn có thể chỉ định Mã 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. Để xoá kết quả đạt/không đạt, hãy chọn kết quả trong ứng dụng CTS Verifier (Trình xác minh CTS) chọn Trình đơn > Xóa.