Trình xác minh bộ kiểm tra khả năng tương thích Android (Bộ 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ể được tự động hóa, Trình xác minh CTS 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 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 khả năng tương thích API Android bằng cách vượt qua thành công CTS. Đâ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 với DUT đều đi qua cổng này.
- Thiết bị Android thứ hai có triển khai mô phỏng thẻ máy chủ (HCE), Bluetooth, Wi-Fi trực tiếp và NFC tương thích đã biết.
- Bộ định tuyến Wi-Fi được định cấu hình bằng 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.
Các yêu cầu của UICC đối với các bà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ó SecureElement UICC với các quy tắc truy cập sau:
- 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
- Số nhận dạng ứng dụng được ủy quyền (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.
Cài đặt
Thay đổi chế độ điều hướng hệ thống của thiết bị thử nghiệm sang chế độ ba nút như sau:
- Mở cài đặt.
- Điều hướng đến Hệ thống > Cử chỉ > Điều hướng hệ thống .
- 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 CTS Verifier:
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 AndroidStudio .
Tải xuống APK Trình xác minh CTS cho phiên bản Android để kiểm tra.
Kết nối DUT với máy tính Linux.
Từ một thiết bị đầu cuối trên máy tính Linux, hãy cài đặt
CtsVerifier.apktrên DUT.adb install -r -g CtsVerifier.apk
Đố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
Đố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
Để cấp quyền phù hợp cho hồ sơ công việc đã tạo, hãy bao gồm cờ
--user profileID, như sau:adb shell appops set --user profileID com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Đố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
Đảm bảo rằng DUT được đặt chính xác ngày và giờ hệ thống.
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.
Hình 1. Biểu tượng CTS Verifier
Ứng dụng hiển thị một số bộ kiểm tra có sẵn để xác minh thủ công.
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 yếu tố phổ biến ở cuối màn hình.
Hình 3. Màn hình kiểm tra với các yếu tố kiểm tra phổ biến được làm nổi bật
- Vượt qua ( ✓ ). Nhấn 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 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à thử nghiệm 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
Hình 4. Quy trình kiểm tra phụ kiện USB dành cho phiên bản 8.0 trở lên
Hình 5. Kiểm tra chế độ phụ kiện USB cho phiên bản 8.0 trở lên
Kiểm tra chế độ phụ kiện USB cho 7.x trở xuống
Bài kiểm tra Phụ kiện USB yêu cầu máy tính Linux chạy chương trình (máy chủ) máy tính để bàn USB.
- Kết nối DUT với máy tính Linux.
Trên máy tính, chạy chương trình
cts-usb-accessorytừ gói CTS Verifier:./cts-usb-accessory
Đợi một thông báo bật lên xuất hiện trên DUT, sau đó chọn OK .
Hình 6. Kiểm tra phụ kiện USB
Vào phần Kiểm tra phụ kiện USB trong ứng dụng CTS Verifier trên DUT.
Trên máy tính, xem lại đầu ra từ bàn đ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.
Thiết lập môi trường thử nghiệm:
- In tệp đích Calibration-pattern.pdf trên giấy khổ 11” x 17” hoặc A3.
- Gắn mẫu đã in trên một tấm nền cứng.
Định hướng thiết bị máy ảnh và mục tiêu được in như minh họa trong sơ đồ sau.
Hình 7. Mục tiêu được in trên máy ảnh
Đặt chiều rộng mục tiêu:
- Đo khoảng cách (tính bằng centimet) giữa các đường liền nét trên mẫu đích để tính đến độ không chính xác của bản in (~38 cm).
- Bắt đầu ứng dụng hiệu chuẩn.
- Nhấn nút thiết lập và chọn Khoảng cách điểm đánh dấu .
- Đo và nhập khoảng cách đến mẫu đích (~100 cm).
- Nhấn nút quay lại để quay lại phần xem trước hiệu chuẩn.
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 được phủ lên trên hình ảnh đó; đường này phải thẳng hàng với đường trung tâm của mẫu đích. 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 trực giao với mục tiêu.
Chạy kiểm tra hiệu chuẩn:
- 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. Kiểm tra vào chế độ hiệu chỉnh và hiển thị ảnh với hai đường thẳng đứng chồng lên ảnh.
- 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 đích 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, trường nhìn đượ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ủ căn chỉnh với mẫu mục tiêu càng gần càng tốt. Khi lớp phủ và hình ảnh mẫu đích đượ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 quan sát được báo cáo phải nằm trong khoảng +/-2 độ của giá trị hiệu chuẩn.
- Nhấn nút quay lại và lặp lại kiểm tra hiệu chỉnh 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 từ các bản phát hành CTS 10 R6 và CTS 11 R2, Trình xác minh CTS 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.
Ở trên cùng của 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ị được mở ra và được gập lại. Trình xác minh CTS 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 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 các kiểm tra được hiển thị.
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 không mở. Để xác định từng kết quả kiểm tra từ bộ kiểm tra đó, một hậu tố được thêm vào mỗi tên kiểm tra 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ả 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 đánh dấu thời gian tự động dựa trên thời gian của hệ thống DUT.
Để 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.
Đợ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.Kết nối DUT với máy tính Linux.
Từ bản cài đặt Android SDK trên máy tính Linux, hãy tải xuống các báo cáo từ thiết bị được kết nối bằng cách sử dụng
adb shell content readhoặcadb 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 cách sử dụ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ả các báo cáo bằng cách sử dụng lệnh sau:
adb pull /mnt/sdcard/ctsVerifierReports/
Đối với Android 10 trở lên, triển khai Ô tô và thiết bị chạy với tư cách là người dùng phụ , hãy tải xuống báo cáo mới nhất bằng cách sử dụ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
Để xóa kết quả đạt/không đạt, hãy chọn kết quả trong ứng dụng CTS Verifier và chọn Menu > Clear .