Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Bộ xác minh bộ kiểm tra khả năng tương thích của Android (CTS Verifier) ​​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ể được tự động hóa, CTS Verifier cung cấp các bài kiểm tra cho các API và chức năng không thể kiểm tra trên thiết bị tĩnh mà không cần nhập 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 Trình xác minh CTS, hãy đảm bảo rằng bạn có các thiết bị sau:

  • Thiết bị Android đã xác minh tính tương thích của 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ó triển khai mô phỏng thẻ chủ Bluetooth, Wi-Fi direct và NFC tương thích đã biết (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 được tắt nguồn.

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

CTS Verifier có các trường hợp kiểm tra NFC sau:

  • Field-off (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ó UICC SecureElement với các quy tắc truy cập sau:

  • CtsVerifier APK băm: 61: ED: 37: 7E: 85: D3: 86: A8: DF: EE: 6B: 86: 4B: D8: 5B: 0B: FA: A5: AF: 81
  • Số phân định ứng dụng được phép (AID) để truy cập sự kiện NFC: 0xA000000476416E64726F696443545341

Về phía trình giả lập, chúng tôi hy vọng sự kiện giao dịch sẽ đẩy hoạt động tương ứng lên nền trước.

Thành lập

Thay đổi chế độ điều hướng hệ thống của thiết bị thử nghiệm thành 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 kiểm tra 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ừ một thiết bị đầu cuối trên máy tính Linux, 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. Đảm bảo rằng DUT có dữ liệu hệ thống và thời gian đượ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.

Trình đơn kiểm tra trình xác minh CTS

Hình 2. Trình đơn kiểm tra CTS Verifier

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

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

Hình 3. Màn hình thử nghiệm với các phần tử thử nghiệm phổ biến được đánh dấu

  • Vượt qua (✓). 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 lần đầu tiên một bài kiểm tra được mở.
  • Không đạt (!). Nhấn 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ố bài kiểm tra, chẳng hạn như chế độ phụ kiện USB và kiểm tra hiệu chuẩn máy ảnh, yêu cầu thiết lập kiểm tra bổ sung và hướng dẫn như 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 8.0 trở lên

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

Hình 5. Thử nghiệm chế độ phụ kiện USB cho 8.0 trở lên

Kiểm tra chế độ phụ kiện USB cho 7.x và thấp hơn

Kiểm tra USB Accessory yêu cầu một 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. Chờ 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 CTS Verifier trên DUT.

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

    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 chuẩn trường nhìn để nhanh chóng xác định trường nhìn 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 trên một tấm nền cứng.
    3. Định hướng thiết bị máy ảnh và mục tiêu được in như thể hiện trong sơ đồ sau.
      Mục tiêu được in trên máy ảnh

      Hình 7. Mục tiêu được in trên máy ảnh

  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 để xem xét việc in không chính xác (~ 38 cm).
    2. Khởi động ứ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 đích (~ 100 cm).
    5. Nhấn nút quay lại để quay lại bản xem trước hiệu chuẩn.
  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 rằng trục quang học là trực giao với mục tiêu.

  4. Chạy kiểm tra hiệu chuẩn:

    1. Chọn độ phân giải hình ảnh (sử dụng bộ chọn ở dưới cùng bên trái), sau đó nhấn vào màn hình để chụp ảnh. Thử nghiệm chuyển sang chế độ hiệu chuẩn và hiển thị ảnh với 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 vòng vài cm, trường nhìn được báo cáo cho việc thay đổi đã chọn là chính xác.
      • Nếu các dòng không thẳng hàng, trường xem được báo cáo là 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 khi lớp phủ phù hợp với mẫu mục tiêu 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 xem được hiển thị là một giá trị gần đúng với giá trị chính xác. Trường xem được báo cáo phải nằm trong phạm vi +/- 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 chuẩn cho tất cả cá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 hơn một chế độ màn hình.

Ở đầu giao diện 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ị mở ra và gấp lại. CTS Verifier sẽ hiển thị các kiểm tra cần thiết cho chế độ hiển thị đã chọn. Để thực hiện các chế độ thay thế trong CTS Verifier, người ta nên chuyển nút sang chế độ hiển thị thích hợp và chạy danh sách các thử nghiệm được hiển thị.

Công tắc chuyển đổi CTS-V

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

<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 đánh 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 hạng mục kiểm tra.

  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 (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ừ cài đặt Android SDK trên máy tính Linux, tải xuống báo cáo từ thiết bị được kết nối bằng cách sử dụ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, 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, việc 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 .