Menjalankan pengujian multiperangkat Pemverifikasi CTS

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

Menyiapkan pengujian multiperangkat sisi host

Bagian ini menjelaskan cara menyiapkan pengujian multiperangkat.

1. Pastikan mesin desktop Anda memenuhi persyaratan sistem operasi untuk CTS.
2. Ikuti langkah 2 dan 5 pada Menginstal software desktop untuk memastikan adb, AAPT2, dan Python diinstal dengan benar di desktop Anda.

3. Siapkan dua perangkat yang akan diuji (DUT) yang cocok, masing-masing dengan CTS-V yang telah disiapkan.

   • Untuk mengetahui informasi tentang cara menyiapkan DUT, lihat Menyiapkan DUT.
   • Untuk mengetahui petunjuk tentang cara menyiapkan CTS-V, lihat Penyiapan.

4. Jika Anda menguji modul selain NFC, ikuti Menyiapkan pengujian dua perangkat standar.

   • Untuk pengujian NFC, ikuti Menyiapkan pengujian NFC.

5. Jika Anda menguji modul CDM, ikuti Menyiapkan pengujian CDM selain penyiapan dua perangkat standar.

Menyiapkan pengujian dua perangkat standar

Untuk penyiapan dua perangkat default:

1. Letakkan dua DUT Android yang cocok dengan jarak sekitar 20 cm.

2. Untuk memastikan lingkungan yang bersih, letakkan kedua perangkat di dalam kotak pelindung.

   Catatan: Jika Anda mengalami masalah dengan pengujian ini dan memerlukan bantuan, pastikan pengujian telah dijalankan dengan kedua perangkat dalam kotak pelindung.

3. (opsional) Siapkan OTA sniffer untuk proses debug Wi-Fi.

Menyiapkan pengujian NFC

Pengujian NFC menggunakan satu DUT dan chip NFC PN532.

Untuk menyiapkan pengujian NFC:

1. Beli chip NFC PN532. Sebaiknya gunakan All-In-One PN532.

2. Di DUT, buka aplikasi Setelan.

3. Aktifkan NFC.

4. Posisikan chip NFC:

   • Untuk ponsel, posisikan pembaca NFC DUT seperti yang ditunjukkan pada gambar 1:

     

     Gambar 1. Penempatan chip NFC.

   • Untuk jenis perangkat lainnya, posisikan chip di samping antena NFC perangkat.

5. Hubungkan 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. Sangat penting agar build yang dapat di-debug (userdebug atau eng) dan yang tidak dapat di-debug (user) diuji oleh OEM dan lulus pengujian untuk keduanya.

Pengecualian

Klausul CDD untuk penerapan API sinkronisasi izin hanya mewajibkan API tersebut dapat mentransfer data antarperangkat melalui saluran yang aman. Karena penerapan saluran aman bukan merupakan persyaratan kepatuhan CDD, pengujian ini dapat dilewati pada build yang tidak dapat di-debug (pengguna), tetapi hanya jika Anda ingin memilih 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 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 dev
• Bootloader perangkat terkunci. Untuk mendapatkan petunjuk terperinci, lihat mengunci bootloader
• Tingkat patch OS, boot kunci, dan vendor kunci berada dalam waktu 12 bulan. Jangan gunakan build yang lebih lama dari setahun

• Pengesahan perangkat didukung oleh salah satu sertifikat root yang disetujui vendor. Tentukan sertifikat root 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, hasil akan 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:

1. Di workstation pengujian, luncurkan konsol cts-v-host dari direktori tempat paket CTS-V yang di-unzip:

   ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
   

2. Dari dalam aplikasi CTS Verifier di DUT, klik Host-side Tests. 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 ditampilkan.

3. Identifikasi nama modul pengujian yang ingin Anda jalankan. Misalnya, modul CompanionDeviceManager dicantumkan sebagai CtsCompanionDeviceManagerMultiDeviceTestCases.

   Catatan: Jika Anda mengetuk modul sisi host di aplikasi CTS Verifier, Anda tidak akan melihat daftar kasus pengujian individual. Sebagai gantinya, UI akan otomatis diisi dengan hasil kasus pengujian setelah modul dijalankan di host.

4. Di konsol cts-v-host, 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, dengan mengabaikan perbedaan dalam persyaratan perangkat dan hardware. Sebagai gantinya, jalankan perintah run cts-v-host-default-devices untuk menjalankan pengujian dengan penyiapan standar sebagai satu subrencana.
   Catatan: Anda dapat menunjukkan DUT tertentu yang akan 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 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 otomatis ditambahkan ke laporan pengujian CTS-V secara 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 papan NFC PN532.

Untuk memperbaiki masalah ini, identifikasi jalur serial yang digunakan oleh papan 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 ada beberapa perangkat yang terhubung ke host, dan beberapa di antaranya tidak memiliki PN532 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:

• Setel serial DUT yang benar dalam perintah pengujian sisi host menggunakan tanda -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.