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 sử dụng các chương trình kiểm thử nhiều thiết bị của Trình xác minh CTS (CTS-V) cho Android 16 trở lên.

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

Phần này giải thích cách thiết lập 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 các bước 2 và 5 trong 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 chính xác trên máy tính.
Chuẩn bị hai thiết bị phù hợp đang được kiểm thử (DUT), mỗi thiết bị đều được thiết lập CTS-V.
- Để biết thông tin về cách thiết lập DUT, hãy xem phần Thiết lập DUT.
- Để biết hướng dẫn 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ác ngoài NFC, hãy làm theo hướng dẫn Thiết lập kiểm thử hai thiết bị tiêu chuẩn.
- Đối với kiểm thử NFC, hãy làm theo hướng dẫ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 Thiết lập kiểm thử CDM ngoài chế độ thiết lập hai thiết bị tiêu chuẩn.

Thiết lập kiểm thử tiêu chuẩn trên hai thiết bị

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

Đặt hai DUT Android phù hợ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 bài kiểm thử này và cần được trợ giúp, hãy đảm bảo rằng bạn đã chạy các bài 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 trình quan sát OTA để gỡ lỗi Wi-Fi.

Thiết lập 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 kiểm thử NFC:

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

Thiết lập 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à kiểm thử được thực thi. Điều quan trọng là OEM 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ả hai bản dựng đều phải vượt qua kiểm thử.

Miễn trừ

Mục CDD để 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 quy trình 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 chương trình 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 gỡ lỗi được

Nếu bạn không đượ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. Giấy 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 hệ thống của họ không có bất kỳ thay đổi trái phép nào. AVF kiểm tra các trạng thái sau trong quá trình xác minh:

Thiết bị có quyền truy cập Internet
Thiết bị sử dụng tính năng khởi động đã xác minh và bản dựng phải được ký bằng khoá phát hành, không phải khoá nhà phát triển
Trình tải khởi động của thiết bị đang bị khoá. Để 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, khởi động chính và cấp bản vá chính của nhà cung cấp trong vòng 12 tháng. Không sử dụng bản dựng cũ hơn 1 năm
Quy trình chứng thực thiết bị được hỗ trợ bởi 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 kiểm thử nhiều thiết bị phía máy chủ (AOSP 16 trở lên)

CTS Verifier 16 ra mắt tính năng hỗ trợ kiểm thử nhiều thiết bị ở phía máy chủ. Bạn có thể thực thi các chương trình 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 lần 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 kiểm thử 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 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 đã giải nén gói zip CTS-V:
```
./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 Kiểm thử phía máy chủ. Hình 2 cho thấy các kiểm thử phía máy chủ trong ứng dụng CTS Verifier:

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

Danh sách các mô-đun kiểm thử nhiều thiết bị phía máy chủ kiểm thử sẽ hiển thị.
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.
Trong bảng điều khiển cts-v-host, hãy chạy lệnh sau: Lưu ý: Nếu nhấn vào một mô-đun phía máy chủ 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ả 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 xTS, 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 sử dụng -m test_module_name, lệnh này sẽ cố gắng chạy tất cả các mô-đun kiểm thử, bỏ qua các sai lệch về yêu cầu 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 chương trình 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ể để 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 bài kiểm thử, kết quả sẽ xuất hiện trong ứng dụng CTS Verifier. Các bài kiểm thử được đánh dấu màu xanh lục đã đạt. Các bài kiểm thử được đánh dấu màu đỏ không đạt. Hình 3 cho thấy kết quả mẫu cho các bài kiểm thử CtsCompanionDeviceManager:

Hình 3. Kết quả kiểm thử đa 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ố kiểm thử trên nhiều thiết bị

Phần này cung cấp trợ giúp khắc phục sự cố có thể xảy ra.

Khắc phục lỗi Không có phản hồi cho GetFirmwareVersion trong quá trình kiểm thử 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 chương trình kiểm thử nhiều thiết bị, thì các chương trình kiểm thử này sẽ không thể truy cập vào bo mạch 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ủ, chẳng hạn như dev/ttyUSB1, sau đó chỉ định đường dẫn đó theo cách thủ công bằ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 thể phát hiện PN532.

Nếu bạn có nhiều thiết bị được kết nối với máy chủ 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 phần 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ủ bằng cờ -s.
Ngắt kết nối tất cả thiết bị không phải DUT khỏi máy chủ.

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

Nếu kiểm thử đang chạy trên các thiết bị không gỡ lỗi được, hãy xem liệu 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.