Trình xác minh Bộ kiểm tra tính tương thích với Android (Trình xác minh CTS) bổ sung cho 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ể được tự động hoá, nhưng Trình xác minh CTS cung cấp các bài kiểm thử cho các API và hàm không thể được kiểm thử trên thiết bị cố định mà không cần nhập hoặc định vị theo cách 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 bạn có các thiết bị sau:
- Thiết bị Android đã xác minh khả năng tương thích với API Android bằng cách vượt qua thành công CTS. Đây là thiết bị đang được kiểm thử (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 đều đi qua cổng này.
- Thiết bị Android thứ hai có hỗ trợ Bluetooth, Wi-Fi trực tiếp, Wi-Fi Nhận biết, UWB (nếu DUT hỗ trợ UWB) và triển khai quy trình mô phỏng thẻ máy chủ NFC (HCE).
- 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 với Internet nhưng không tắt nguồn.
Hãy nhớ chuẩn bị sẵn chân máy, giá đỡ thiết bị và khoảng cách đo trước cần thiết cho các thử nghiệm đo khoảng cách (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 phần 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 thử NFC sau:
- Tắt trường (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)
Các thử nghiệm 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 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 hoạt động tương ứng vào nền trước.
Thiết lập
Thay đổi chế độ điều hướng của hệ thống trên thiết bị thử nghiệm thành chế độ ba nút như sau:
- Mở phần Cài đặt.
- Chuyển đến System (Hệ thống) > Gesture (Cử chỉ) > System Navigation (Di chuyển trên hệ thống).
- Chọn chế độ thao tác dựa trên nút bất kỳ, ưu tiên chế độ 3 nút (nếu có).
Cách thiết lập môi trường kiểm thử của Trình xác minh CTS:
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 APK Trình xác minh CTS xuống cho phiên bản Android cần kiểm thử.
Kết nối DUT với máy tính Linux.
Trên một cửa sổ dòng lệnh 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 trong một thư mục tự xác định trong thư mục cấp cao nhất ngoài của thiết bị.
adb shell appops set 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 kiểm thử cho Trình xác minh CTS.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Đố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
Đảm bảo rằng DUT đã đặt ngày và giờ hệ thống chính xác.
Chạy CTS Verifier
Khởi chạy ứng dụng CTS Verifier bằng cách nhấn vào biểu tượng CTS Verifier trên DUT.
Hình 1. Biểu tượng CTS Verifier
Ứng dụng này hiển thị một số bộ kiểm thử có sẵn để xác minh thủ công.
Hình 2. Trình đơn kiểm thử của CTS Verifier
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.
Hình 3. Màn hình kiểm thử với 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 kiểm thử theo hướng dẫn Thông tin.
- Thông tin (?). Nhấn để hiển thị hướng dẫn kiểm thử. Cũng tự động xuất hiện trong lần đầu tiên mở kiểm thử.
- Không đạt (!). Nhấn vào nếu DUT không đáp ứng các yêu cầu kiểm thử theo hướng dẫn Thông tin.
Một số hoạt động kiểm thử, chẳng hạn như kiểm tra chế độ phụ kiện USB và kiểm tra hiệu chỉnh máy ảnh, yêu cầu thiết lập kiểm thử bổ sung và hướng dẫn như được nêu chi tiết trong các phần sau.
Kiểm thử chế độ phụ kiện USB cho Android 8.0 trở lên
Hình 4. Quy trình kiểm thử phụ kiện USB cho phiên bản 8.0 trở lên
Hình 5. Kiểm thử chế độ phụ kiện USB cho Android 8.0 trở lên
Kiểm thử chế độ phụ kiện USB cho phiên bản 7.x trở xuống
Quy trình kiểm thử 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ủ).
- Kết nối DUT với máy tính Linux.
Trên máy tính, hãy thực thi chương trình
cts-usb-accessorytừ gói CTS Verifier:./cts-usb-accessory
Đợi thông báo bật lên xuất hiện trên DUT, sau đó chọn OK.
Hình 6. Kiểm thử phụ kiện USB
Chuyển đến USB Accessory Test (Kiểm thử phụ kiện USB) trong ứng dụng CTS Verifier trên DUT.
Trên máy tính, hãy xem lại kết quả từ 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 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.
Thiết lập môi trường kiểm thử:
- In tệp đích calibration-pattern.pdf trên giấy có kích thước 11” x 17” hoặc A3.
- Gắn hoa văn đã in lên mặt sau cứng.
Định hướng thiết bị máy ảnh và mục tiêu in như trong sơ đồ sau.
Hình 7. Đích nhắm in bằng máy ảnh
Đặt chiều rộng mục tiêu:
- Đ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 trường hợp in không chính xác (~38 cm).
- Khởi động ứng dụng hiệu chỉnh.
- Nhấn nút thiết lập rồi chọn Khoảng cách điểm đánh dấu.
- Đo và nhập khoảng cách tới mẫu mục tiêu (~100 cm).
- Nhấn nút quay lại để quay lại chế độ xem trước hiệu chỉnh.
Xác minh rằng thiết bị và mục tiêu được đặt như trong hình và bạn đã nhập đúng khoảng cách vào hộp thoại thiết lập. Bản xem trước sẽ hiển thị hình ảnh có một đường dọc phủ lên hình ảnh đó; đường này phải căn chỉnh với đường giữa của mẫu mục tiêu. Bạn có thể sử dụng lưới trong suốt với các đường dọc khác để đảm bảo trục quang học vuông góc với mục tiêu.
Chạy kiểm tra hiệu chỉnh:
- Chọn độ phân giải hình ảnh (bằng bộ chọn ở dưới cùng bên trái), sau đó nhấn vào màn hình để chụp ảnh. Quy trình kiểm thử sẽ chuyển sang chế độ hiệu chuẩn và hiển thị ảnh có hai đường dọc phủ lên hình ảnh.
- Xác định độ chính xác:
- Nếu các đường thẳng đó nằm trên các đường thẳng dọc của mẫu mục tiêu trong vòng 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 này không thẳng hàng, thì trường nhìn được báo cáo không chính xác. Để khắc phục vấn đề này, hãy điều chỉnh thanh trượt ở cuối màn hình cho đến khi lớp phủ khớp với mẫu mục tiêu gần 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 hiển thị sẽ là lần 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.
- 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ả độ phân giải hình ảnh mà DUT hỗ trợ.
Chạy Trình xác minh CTS cho các chế độ thay thế
Kể từ các bản phát hành CTS 10 R6 và CTS 11 R2, CTS Verifier hỗ trợ các thử nghiệm bắt buộc đối với thiết bị có chế độ thay thế hoặc đối với thiết bị có nhiều chế độ màn hình.
Ở đầu chế độ xem danh sách chính trong CTS Verifier, một nút sẽ xuất hiện để cho phép người dùng chuyển đổi giữa chế độ hiển thị mở ra và gập lại. Công cụ xác minh CTS sẽ hiển thị các bài kiểm thử cần thiết cho chế độ hiển thị đã chọn. Để thực thi các chế độ thay thế trong Trình xác minh CTS, bạn nên chuyển nút sang chế độ hiển thị thích hợp và chạy danh sách kiểm thử hiển thị.
Kết quả của các kiểm thử gập lại sẽ được ghi lại trong cùng một báo cáo với các kiểm thử mở ra. Để xác định từng kết quả kiểm thử mà từ đó tập hợp kiểm thử, một hậu tố sẽ đượ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ả các bài kiểm thử hoàn tất, bạn có thể lưu kết quả dưới dạng báo cáo và tải 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 hệ thống của DUT.
Để lưu kết quả kiểm thử, hãy nhấn vào biểu tượng lưu (ổ đĩa) ở đầu danh sách danh mục kiểm thử.
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 đó.Kết nối DUT với máy tính Linux.
Từ quá trình 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ị đã kết nối bằng
adb shell content readhoặcadb 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, hãy triển khai tính năng Ô tô và các thiết bị chạy dưới dạng người dùng phụ, hãy tải báo cáo mới nhất xuống 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ả 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 một báo cáo trong 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
Để xoá kết quả đạt/không đạt, hãy chọn kết quả trong ứng dụng CTS Verifier rồi chọn Menu > Clear (Trình đơn > Xoá).