Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

Menjalankan pengujian multiperangkat Pemverifikasi CTS

Halaman ini berisi petunjuk untuk menggunakan pengujian multiperangkat CTS Verifier (CTS-V) untuk Android 16 dan yang lebih baru.

Menyiapkan pengujian multiperangkat sisi host

Bagian ini menjelaskan cara menyiapkan pengujian multiperangkat.

Pastikan komputer desktop Anda memenuhi persyaratan sistem operasi untuk CTS.
Ikuti langkah 2 dan 5 dari Menginstal software desktop untuk memastikan adb, AAPT2, dan Python diinstal dengan benar di desktop Anda.
Siapkan dua perangkat yang cocok yang sedang diuji (DUT), masing-masing dengan penyiapan CTS-V.
- Untuk informasi tentang cara menyiapkan DUT, lihat Menyiapkan DUT.
- Untuk petunjuk cara menyiapkan CTS-V, lihat Penyiapan.
Jika Anda menguji modul selain NFC, ikuti Menyiapkan pengujian dua perangkat standar.
- Untuk pengujian NFC, ikuti Menyiapkan pengujian NFC.
Jika Anda menguji modul CDM, ikuti Menyiapkan pengujian CDM selain penyiapan dua perangkat standar.

Menyiapkan pengujian dua perangkat standar

Untuk penyiapan dua perangkat default:

Letakkan dua DUT Android yang cocok dengan jarak sekitar 20 cm.
Untuk memastikan lingkungan yang bersih, tempatkan kedua perangkat dalam kotak pelindung.

Catatan: Jika Anda mengalami masalah dengan pengujian ini dan memerlukan bantuan, pastikan pengujian telah dijalankan dengan kedua perangkat dalam kotak pelindung.
(opsional) Siapkan sniffer OTA untuk proses debug Wi-Fi.

Menyiapkan pengujian NFC

Pengujian NFC menggunakan satu DUT dan chip NFC PN532.

Untuk menyiapkan pengujian NFC:

Beli chip NFC PN532. Sebaiknya gunakan All-In-One PN532.
Di DUT, buka aplikasi Setelan.
Aktifkan NFC.
Posisikan chip NFC:
- Untuk ponsel, posisikan pembaca NFC DUT seperti yang ditunjukkan pada gambar 1:
  
  Gambar 1. Pemosisi chip NFC.
- Untuk jenis perangkat lainnya, posisikan chip di samping antena NFC perangkat.
Pasang chip NFC PN532 ke workstation pengujian menggunakan kabel USB.

Menyiapkan pengujian CDM

Kasus pengujian test_permissions_sync() memiliki perilaku yang berbeda bergantung pada jenis build perangkat tempat pengujian dijalankan. Penting bagi OEM untuk menguji build yang dapat di-debug (userdebug atau eng) dan build yang tidak dapat di-debug (pengguna) keduanya dan pengujian tersebut lulus untuk keduanya.

Pengecualian

Klausul CDD untuk penerapan API sinkronisasi izin hanya mengharuskannya dapat berhasil mentransfer data antarperangkat melalui saluran yang aman. Karena implementasi saluran aman bukan persyaratan kepatuhan CDD, pengujian ini dapat dilewati pada build (pengguna) yang tidak dapat di-debug, tetapi hanya jika Anda memilih untuk tidak mendukung fitur sinkronisasi izin CDM.

Pengujian harus lulus pada build yang dapat di-debug tanpa pengecualian.

Prasyarat untuk pengujian pada build yang tidak dapat di-debug

Jika Anda tidak dikecualikan oleh klausul pengecualian sebelumnya, pastikan prasyarat berikut terpenuhi.

Saluran aman menggunakan AVF (AttestationVerificationFramework) untuk memverifikasi keandalan hardware. Pengesahan yang dibuat oleh kedua belah pihak berisi beberapa informasi tentang diri mereka sendiri untuk memastikan bahwa tidak ada perubahan yang tidak sah dalam sistem mereka. AVF memeriksa status berikut selama proses verifikasi:

Perangkat memiliki akses ke internet
Perangkat menggunakan booting terverifikasi dan build harus ditandatangani dengan kunci rilis, bukan kunci developer
Perangkat terkunci bootloader. Untuk petunjuk selengkapnya, lihat mengunci bootloader
OS, booting kunci, dan tingkat patch vendor kunci dalam waktu 12 bulan. Jangan gunakan build yang lebih lama dari satu tahun
Pengesahan perangkat didukung oleh salah satu sertifikat root yang disetujui vendor. Tentukan root certificate tepercaya Anda di overlay resource vendor_required_attestation_certificates.xml.

Menjalankan pengujian multiperangkat sisi host (AOSP 16 atau yang lebih baru)

CTS Verifier 16 memperkenalkan dukungan untuk pengujian multiperangkat sisi host. Pengujian ini dapat dijalankan menggunakan skrip otomatis di host, bukan operasi pengujian manual di perangkat. Setelah setiap pengujian selesai, hasilnya otomatis diupload ke DUT dan ditampilkan di aplikasi CTS Verifier.

Bagian ini menjelaskan cara menjalankan pengujian multiperangkat sisi host.

Menjalankan pengujian multiperangkat

Untuk menjalankan pengujian multiperangkat:

Di workstation pengujian, luncurkan cts-v-host console dari direktori tempat paket zip CTS-V diekstrak:
```
./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
```
Dari dalam aplikasi CTS Verifier di DUT, klik Pengujian sisi Host. Gambar 2 menunjukkan pengujian sisi host di aplikasi CTS Verifier:

Gambar 2. Pengujian multiperangkat sisi host di aplikasi CTS Verifier.

Daftar modul pengujian multiperangkat sisi host pengujian akan ditampilkan.
Identifikasi nama modul pengujian yang ingin Anda jalankan. Misalnya, modul CompanionDeviceManager tercantum sebagai CtsCompanionDeviceManagerMultiDeviceTestCases.
Di konsol cts-v-host, jalankan perintah berikut: Catatan: Jika mengetuk modul sisi host di aplikasi CTS Verifier, Anda tidak akan melihat daftar setiap kasus pengujian. Sebagai gantinya, UI akan otomatis diisi dengan hasil kasus pengujian setelah modul dieksekusi di host.
Di konsol xTS, jalankan perintah berikut:
```
run cts-v-host -m test_module_name
```
Contoh:
```
run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
```
Catatan: Jika Anda menjalankan cts-v-host tanpa menggunakan -m test_module_name, perintah akan mencoba menjalankan semua modul pengujian, mengabaikan penyimpangan dalam persyaratan perangkat dan hardware. Sebagai gantinya, jalankan perintah run cts-v-host-default-devices untuk menjalankan pengujian dengan penyiapan standar sebagai satu sub-rencana.
Catatan: Anda dapat menunjukkan DUT tertentu untuk diuji menggunakan nomor serinya: run cts-v-host -m test_module_name -s device1_serial -s device2_serial ...

Setelah konsol xTS selesai menjalankan pengujian, hasilnya akan muncul di aplikasi CTS Verifier. Pengujian yang ditandai hijau telah lulus. Pengujian yang ditandai dengan warna merah telah gagal. Gambar 3 menunjukkan contoh hasil untuk pengujian CtsCompanionDeviceManager:

Gambar 3. Hasil pengujian multiperangkat sisi host di aplikasi CTS Verifier.

Catatan: Hasil sisi host akan otomatis ditambahkan ke laporan pengujian CTS-V keseluruhan.

Memecahkan masalah pengujian multiperangkat

Bagian ini memberikan bantuan pemecahan masalah untuk kemungkinan masalah.

Memperbaiki Tidak ada respons untuk GetFirmwareVersion selama pengujian NFC

Jika Anda menerima pesan verify_firmware_version RuntimeError: No response for GetFirmwareVersion saat menjalankan pengujian multiperangkat, pengujian tidak dapat mengakses board NFC PN532.

Untuk memperbaiki masalah ini, identifikasi jalur serial yang digunakan oleh board NFC PN532 di host Anda, seperti dev/ttyUSB1, lalu tentukan secara manual menggunakan argumen --module-arg di konsol:

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

Memperbaiki pesan error Transaksi gagal selama pengujian NFC

Jika Anda menerima pesan Transaction failed, check device logs for more information. untuk semua kasus pengujian NFC, kemungkinan karena chip NFC DUT tidak dapat mendeteksi PN532.

Jika Anda memiliki beberapa perangkat yang terhubung ke host, dan beberapa di antaranya tidak memiliki PN532 yang ditempatkan di atasnya, DUT yang salah mungkin telah dipilih. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan pengujian NFC.

Untuk memperbaiki masalah ini, lakukan salah satu tindakan berikut:

Tetapkan serial DUT yang benar dalam perintah pengujian sisi host menggunakan flag -s.
Putuskan koneksi semua perangkat non-DUT dari host.

Kasus pengujian CDM `test_permissions_sync` diabaikan

Jika pengujian dijalankan di perangkat yang tidak dapat di-debug, lihat apakah Anda dikecualikan. Jika tidak, pastikan kedua perangkat memenuhi prasyarat.