Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

Chạy các chương trình kiểm thử nhiều thiết bị của Trình xác minh CTS

Trang này chứa hướng dẫn về cách sử dụng các kiểm thử nhiều thiết bị CTS Verifier (CTS-V) cho Android 16 trở lên.

Thiết lập các kiểm thử trên nhiều thiết bị ở phía máy chủ

Phần này giải thích cách thiết lập các kiểm thử trên nhiều thiết bị.

Đảm bảo máy tính của bạn đáp ứng các yêu cầu về hệ điều hành đối với CTS.
Làm theo bước 2 và 5 của phần Cài đặt phần mềm máy tính để đảm bảo rằng adb, AAPT2 và Python được cài đặt đúng cách trên máy tính của bạn.
Chuẩn bị 2 thiết bị đang kiểm thử (DUT) trùng khớp, mỗi thiết bị có CTS-V được thiết lập.
- Để biết thông tin về cách thiết lập DUT, hãy xem bài viết Thiết lập DUT.
- Để biết hướng dẫn về cách thiết lập CTS-V, hãy xem phần Thiết lập.
Nếu bạn đang kiểm thử một mô-đun không phải là NFC, hãy làm theo hướng dẫn trong phần Thiết lập các quy trình kiểm thử tiêu chuẩn trên 2 thiết bị.
- Đối với các kiểm thử NFC, hãy làm theo hướng dẫn trong phần Thiết lập kiểm thử NFC.
Nếu bạn đang kiểm thử mô-đun CDM, hãy làm theo hướng dẫn trong phần Thiết lập các kiểm thử CDM ngoài chế độ thiết lập tiêu chuẩn gồm 2 thiết bị.

Thiết lập các bài kiểm thử tiêu chuẩn trên 2 thiết bị

Đối với chế độ thiết lập mặc định cho 2 thiết bị:

Đặt 2 DUT Android trùng khớp cách nhau khoảng 20 cm.
Để đảm bảo môi trường sạch sẽ, hãy đặt cả hai thiết bị vào hộp chắn.

Lưu ý: Nếu bạn gặp vấn đề với các kiểm thử này và cần được trợ giúp, hãy đảm bảo rằng bạn đã chạy kiểm thử với cả hai thiết bị trong hộp chắn.
(không bắt buộc) Thiết lập một trình theo dõi OTA để gỡ lỗi Wi-Fi.

Thiết lập các kiểm thử NFC

Các bài kiểm thử NFC sử dụng một DUT và một chip NFC PN532.

Cách thiết lập các kiểm thử NFC:

Mua một chip NFC PN532. Bạn nên dùng PN532 đa năng.
Trên DUT, hãy chuyển đến ứng dụng Cài đặt.
Bật NFC.
Đặt chip NFC:
- Đối với điện thoại, hãy đặt đầu đọc NFC của DUT như trong hình 1:
  
  Hình 1. Vị trí của chip NFC.
- Đối với các loại thiết bị khác, hãy đặt thẻ bên cạnh ăng-ten NFC của thiết bị.
Gắn chip NFC PN532 vào máy trạm kiểm thử bằng cáp USB.

Thiết lập các kiểm thử CDM

Trường hợp kiểm thử test_permissions_sync() có hành vi khác nhau tuỳ thuộc vào loại bản dựng của các thiết bị mà trên đó quá trình kiểm thử được thực thi. Điều quan trọng là nhà sản xuất thiết bị gốc phải kiểm thử cả bản dựng có thể gỡ lỗi (userdebug hoặc eng) và bản dựng không thể gỡ lỗi (user) và các kiểm thử đều phải vượt qua cho cả hai bản dựng.

Miễn trừ

Điều khoản CDD cho việc triển khai API đồng bộ hoá quyền chỉ yêu cầu API này có thể chuyển dữ liệu thành công giữa các thiết bị qua một kênh bảo mật. Vì việc triển khai kênh bảo mật không phải là yêu cầu tuân thủ CDD, nên bạn có thể bỏ qua kiểm thử này trên các bản dựng không gỡ lỗi (người dùng), nhưng chỉ khi bạn muốn chọn không hỗ trợ tính năng đồng bộ hoá quyền CDM.

Các kiểm thử phải vượt qua các bản dựng có thể gỡ lỗi mà không có ngoại lệ.

Điều kiện tiên quyết để kiểm thử trên các bản dựng không thể gỡ lỗi

Nếu bạn không thuộc diện được miễn theo các điều khoản miễn trừ trước đó, hãy đảm bảo bạn đáp ứng các điều kiện tiên quyết sau.

Kênh bảo mật sử dụng AVF (AttestationVerificationFramework) để xác minh độ tin cậy của phần cứng. Chứng thực do cả hai bên tạo ra chứa một số thông tin về chính họ để đảm bảo rằng không có bất kỳ thay đổi trái phép nào trong hệ thống của họ. AVF kiểm tra các trạng thái sau đây trong quy trình xác minh:

Thiết bị có quyền truy cập Internet
Thiết bị sử dụng quy trình khởi động đã xác minh và bản dựng phải được ký bằng khoá phát hành, chứ không phải khoá nhà phát triển
Thiết bị đã khoá trình tải khởi động. Để biết hướng dẫn chi tiết, hãy xem phần khoá trình tải khởi động
Hệ điều hành, quy trình khởi động khoá và cấp độ bản vá của nhà cung cấp khoá nằm trong vòng 12 tháng. Không sử dụng bản dựng cũ hơn một năm
Quy trình chứng thực thiết bị được hỗ trợ bằng một trong các chứng chỉ gốc do nhà cung cấp phê duyệt. Chỉ định chứng chỉ gốc đáng tin cậy trong lớp phủ tài nguyên vendor_required_attestation_certificates.xml.

Chạy các kiểm thử trên nhiều thiết bị ở phía máy chủ lưu trữ (AOSP 16 trở lên)

CTS Verifier 16 hỗ trợ các kiểm thử nhiều thiết bị phía máy chủ. Bạn có thể thực thi các kiểm thử này bằng cách sử dụng tập lệnh tự động trên máy chủ lưu trữ, thay vì thao tác kiểm thử thủ công trên thiết bị. Sau khi mỗi bài kiểm thử hoàn tất, kết quả sẽ tự động được tải lên DUT và hiển thị trong ứng dụng CTS Verifier.

Phần này giải thích cách chạy các kiểm thử trên nhiều thiết bị ở phía máy chủ.

Chạy kiểm thử trên nhiều thiết bị

Cách chạy một kiểm thử trên nhiều thiết bị:

Trên máy trạm kiểm thử, hãy chạy bảng điều khiển cts-v-host từ thư mục nơi gói zip CTS-V được giải nén:
```
./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
```
Trong ứng dụng CTS Verifier trên DUT, hãy nhấp vào Host-side Tests (Các kiểm thử phía máy chủ). Hình 2 cho thấy các kiểm thử phía máy chủ lưu trữ trong ứng dụng CTS Verifier:

Hình 2. Các kiểm thử đa thiết bị phía máy chủ trong ứng dụng CTS Verifier.

Một danh sách các mô-đun kiểm thử nhiều thiết bị phía máy chủ lưu trữ kiểm thử sẽ xuất hiện.
Xác định tên của mô-đun kiểm thử mà bạn muốn chạy. Ví dụ: mô-đun CompanionDeviceManager được liệt kê là CtsCompanionDeviceManagerMultiDeviceTestCases.

Lưu ý: Nếu nhấn vào một mô-đun phía máy chủ lưu trữ trong ứng dụng CTS Verifier, bạn sẽ không thấy danh sách các trường hợp kiểm thử riêng lẻ. Thay vào đó, giao diện người dùng sẽ tự động điền kết quả của trường hợp kiểm thử sau khi mô-đun đã được thực thi trên máy chủ.
Trong bảng điều khiển cts-v-host, hãy chạy lệnh sau:
```
run cts-v-host -m test_module_name
```
Ví dụ:
```
run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
```
Lưu ý: Nếu bạn chạy cts-v-host mà không dùng -m test_module_name, thì lệnh sẽ cố gắng chạy tất cả các mô-đun kiểm thử, bỏ qua các điểm khác biệt về yêu cầu đối với thiết bị và phần cứng. Thay vào đó, hãy thực thi lệnh run cts-v-host-default-devices để chạy các kiểm thử bằng chế độ thiết lập tiêu chuẩn dưới dạng một kế hoạch phụ duy nhất.
Lưu ý: Bạn có thể chỉ định các DUT cụ thể cần kiểm thử bằng số sê-ri của chúng: run cts-v-host -m test_module_name -s device1_serial -s device2_serial ...

Sau khi bảng điều khiển xTS chạy xong các kiểm thử, kết quả sẽ xuất hiện trong ứng dụng CTS Verifier. Các kiểm thử được đánh dấu màu xanh lục là đã đạt. Các kiểm thử được đánh dấu màu đỏ là kiểm thử không đạt. Hình 3 cho thấy ví dụ về kết quả cho các kiểm thử CtsCompanionDeviceManager:

Hình 3. Kết quả kiểm thử nhiều thiết bị phía máy chủ trong ứng dụng CTS Verifier.

Lưu ý: Kết quả phía máy chủ lưu trữ sẽ tự động được thêm vào báo cáo kiểm thử CTS-V tổng thể.

Khắc phục sự cố trong các bài kiểm thử trên nhiều thiết bị

Phần này cung cấp thông tin khắc phục sự cố cho các vấn đề có thể xảy ra.

Khắc phục lỗi Không có phản hồi cho GetFirmwareVersion trong các bài kiểm tra NFC

Nếu bạn nhận được thông báo verify_firmware_version RuntimeError: No response for GetFirmwareVersion trong khi chạy các kiểm thử trên nhiều thiết bị, thì các kiểm thử không thể truy cập vào bảng NFC PN532.

Để khắc phục vấn đề này, hãy xác định đường dẫn nối tiếp mà bo mạch NFC PN532 sử dụng trên máy chủ của bạn, chẳng hạn như dev/ttyUSB1, sau đó chỉ định đường dẫn đó theo cách thủ công bằng cách sử dụng đối số --module-arg trong bảng điều khiển:

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

Khắc phục thông báo lỗi Giao dịch không thành công trong quá trình kiểm thử NFC

Nếu bạn nhận được thông báo Transaction failed, check device logs for more information. cho tất cả các trường hợp kiểm thử NFC, thì có thể là do chip NFC của DUT không phát hiện được PN532.

Nếu bạn có nhiều thiết bị kết nối với máy chủ lưu trữ và một số thiết bị không có PN532 ở trên cùng, thì có thể bạn đã chọn sai DUT. Để biết thêm thông tin, hãy xem bài viết Thiết lập kiểm thử NFC.

Để khắc phục vấn đề này, hãy làm theo một trong những cách sau:

Đặt số sê-ri chính xác của DUT trong lệnh kiểm thử phía máy chủ lưu trữ bằng cách sử dụng cờ -s.
Ngắt kết nối tất cả các thiết bị không phải DUT khỏi máy chủ lưu trữ.

Trường hợp kiểm thử CDM `test_permissions_sync` bị bỏ qua

Nếu bạn đang chạy thử nghiệm trên các thiết bị không thể gỡ lỗi, hãy xem bạn có được miễn trừ hay không. Nếu không, hãy đảm bảo cả hai thiết bị đều đáp ứng các điều kiện tiên quyết.