Android Compatibility Test Suite Verifier (CTS Verifier) melengkapi Compatibility Test Suite (CTS). Sementara CTS memeriksa API dan fungsi yang dapat otomatis, CTS Verifier menyediakan pengujian untuk API dan fungsi yang tidak diuji pada perangkat statis tanpa input atau pemosisian manual, seperti audio kualitas, layar sentuh, akselerometer, dan kamera.
Persyaratan
Sebelum menjalankan CTS Verifier, pastikan Anda memiliki peralatan berikut:
- Perangkat Android yang telah memverifikasi kompatibilitas Android API dengan lulus CTS. Ini adalah perangkat yang sedang diuji (DUT).
- Komputer Linux dengan port yang kompatibel dengan USB 2.0. Semua koneksi ke DUT Go melalui porta ini.
- Perangkat Android kedua dengan Bluetooth, Wi-Fi langsung, dan Wi-Fi yang kompatibel Aware, UWB (jika DUT mendukung UWB), dan emulasi kartu host NFC (HCE) terlepas dari implementasi layanan.
- Router Wi-Fi yang dikonfigurasi dengan nama titik akses dan sandi. {i>Router<i} seharusnya dapat terputus dari internet, tetapi tidak bertenaga nonaktif.
Pastikan Anda juga menyiapkan tripod, dudukan perangkat, dan alat yang jarak yang diperlukan untuk uji pengukuran jarak (kedekatan) untuk UWB, Wi-Fi NAN, dan Bluetooth RSSI. Untuk mengetahui detailnya, lihat Kalibrasi kehadiran.
Persyaratan UICC untuk pengujian NFC
CTS Verifier memiliki kasus uji NFC berikut:
- Kolom nonaktif (menggunakan data transaksi dari 0x54)
- Batalkan pilihan (menggunakan data transaksi dari 0x52)
- Perintah HCI (0025000000) (menggunakan data transaksi dari 0x02)
Pengujian peristiwa transaksi memerlukan dua perangkat, salah satunya harus memiliki SecureElement UICC dengan aturan akses berikut:
- CtsVerifier APK hash: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- ID Aplikasi (AID) Resmi untuk akses peristiwa NFC: 0xA000000476416E64726F696443545341
Di sisi emulator, kita mengharapkan peristiwa transaksi mengirim metode aktivitas ke latar depan.
Penyiapan
Ubah mode navigasi sistem perangkat pengujian ke mode tiga tombol sebagai berikut ini:
- Buka Setelan.
- Buka Sistem > Gestur > Navigasi Sistem.
- Pilih mode navigasi berbasis tombol, jika mode tiga tombol lebih disukai, yang tersedia.
Untuk menyiapkan lingkungan pengujian CTS Verifier:
Di komputer Linux:
Jalankan perintah berikut sebelum menginstal CTS Verifier untuk memungkinkan akses ke antarmuka non-SDK.
adb shell settings put global hidden_api_policy 1
Instal Android Studio.
Download CTS Verifier APK untuk versi Android untuk diuji.
Hubungkan DUT ke komputer Linux.
Dari terminal di komputer Linux, instal
CtsVerifier.apk
di DUT.adb install -r -g CtsVerifier.apk
Untuk Android 10 dan yang lebih baru, jalankan perintah berikut untuk memberikan izin kepada aplikasi untuk membuat laporan.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Untuk Android 11 dan yang lebih baru, jalankan perintah berikut untuk memungkinkan laporan disimpan dalam direktori yang ditentukan sendiri di bawah direktori level atas eksternal perangkat.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Untuk Android 13 dan yang lebih baru, jalankan perintah berikut untuk mengizinkan akses API pengujian untuk CTS Verifier.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Untuk Android 14 dan yang lebih baru, jalankan perintah berikut untuk memberikan izin kepada aplikasi untuk mengaktifkan layar.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Pastikan tanggal dan waktu sistem DUT disetel dengan benar.
Jalankan CTS Verifier
Luncurkan aplikasi CTS Verifier dengan mengetuk ikon CTS Verifier pada DUT.
Gambar 1. Ikon CTS Verifier
Aplikasi menampilkan beberapa set pengujian yang tersedia untuk verifikasi manual.
Gambar 2. Menu pengujian CTS Verifier
Setiap pengujian berisi kumpulan elemen umum di bagian bawah layar.
Gambar 3. Layar uji dengan elemen pengujian umum ditandai
- Lulus (✓). Ketuk jika DUT memenuhi persyaratan pengujian sesuai Info petunjuk.
- Info (?). Ketuk untuk menampilkan petunjuk pengujian. Juga muncul secara otomatis saat pertama kali pengujian dibuka.
- Gagal (!). Ketuk jika DUT tidak memenuhi persyaratan pengujian sesuai Info petunjuk.
Beberapa pengujian, seperti mode aksesori USB dan uji kalibrasi kamera, memerlukan penyiapan dan petunjuk pengujian tambahan seperti yang dijelaskan di bagian berikut.
Menguji mode aksesori USB untuk 8.0 dan yang lebih baru
Gambar 4. Prosedur pengujian aksesori USB untuk 8.0 dan atas
Gambar 5. Menguji mode aksesori USB untuk 8.0 dan atas
Uji mode aksesori USB untuk 7.x dan yang lebih lama
Pengujian Aksesori USB memerlukan komputer Linux untuk menjalankan mesin desktop USB {i>host<i}.
- Hubungkan DUT ke komputer Linux.
Di komputer, jalankan program
cts-usb-accessory
dari CTS Paket pemverifikasi:./cts-usb-accessory
Tunggu hingga pesan pop-up muncul di DUT, lalu pilih Oke.
Gambar 6. Pengujian aksesori USB
Buka Uji Aksesori USB di aplikasi CTS Verifier di DUT.
Di komputer, tinjau output dari konsol. Contoh output:
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
Melakukan kalibrasi ruang pandang kamera
Gunakan prosedur kalibrasi ruang pandang untuk menentukan perangkat dengan cepat ruang pandang dengan akurasi sedang.
Menyiapkan lingkungan pengujian:
- Cetak target kalibrasi-pattern.pdf file pada kertas ukuran 11” x 17” atau A3.
- Pasang pola yang dicetak pada alas yang kuat.
Arahkan perangkat kamera dan target yang dicetak seperti ditunjukkan berikut ini seperti diagram.
Gambar 7. Target kamera yang dicetak
Tetapkan lebar target:
- Ukur jarak (dalam sentimeter) antara garis solid pada pola target untuk memperhitungkan ketidakakuratan pencetakan (~38 cm).
- Mulai aplikasi kalibrasi.
- Tekan tombol penyiapan dan pilih Jarak penanda.
- Ukur dan masukkan jarak ke pola target (~100 cm).
- Tekan tombol kembali untuk kembali ke pratinjau kalibrasi.
Pastikan perangkat dan target ditempatkan seperti yang ditunjukkan dalam gambar dan jarak yang benar telah dimasukkan ke dalam dialog pengaturan. Pratinjau menampilkan gambar dengan garis vertikal yang ditempatkan di atasnya; garis ini harus sejajar dengan garis tengah pola target. {i>Grid<i} transparan dapat digunakan dengan garis vertikal lainnya untuk memastikan sumbu optik ortogonal terhadap target.
Jalankan uji kalibrasi:
- Pilih resolusi gambar (menggunakan pemilih di kiri bawah), lalu ketuk layar untuk mengambil foto. Pengujian memasuki mode kalibrasi dan menampilkan foto dengan dua garis vertikal yang ditempatkan di atas gambar.
- Menentukan akurasi:
- Jika garis sejajar dengan garis vertikal pada pola target dalam beberapa sentimeter, ruang pandang yang dilaporkan untuk resolusi yang dipilih akurat.
- Jika garis tidak sejajar, ruang pandang yang dilaporkan tidak akurat. Untuk memperbaikinya, sesuaikan {i>slider<i} di bagian bawah layar sampai overlay akan sejajar dengan pola target sedekat mungkin. Bila overlay dan gambar pola target sejajar, yang ditampilkan adalah perkiraan yang mendekati dengan sejumlah nilai. Ruang pandang yang dilaporkan harus berada dalam +/-2 derajat dari nilai kalibrasinya.
- Tekan tombol kembali dan ulangi uji kalibrasi untuk semua gambar dan resolusi yang didukung oleh DUT.
Menjalankan CTS Verifier untuk mode alternatif
Mulai rilis CTS 10 R6 dan CTS 11 R2, CTS Verifier mendukung pengujian yang diperlukan untuk perangkat dengan mode alternatif, atau untuk perangkat dengan lebih dari satu mode layar.
Di bagian atas tampilan daftar utama di CTS Verifier, sebuah tombol ditampilkan untuk mengaktifkan pengguna untuk beralih antara mode tampilan bentang dan lipat. CTS Verifier akan menampilkan pengujian yang diperlukan untuk mode tampilan yang dipilih. Untuk menjalankan alternatif mode dalam CTS Verifier, Anda harus mengalihkan tombol ke tampilan yang sesuai dan menjalankan daftar pengujian yang ditampilkan.
Hasil pengujian lipat akan dicatat dalam laporan yang sama dengan layar yang dibentangkan pengujian. Untuk mengidentifikasi setiap hasil tes dari mana set pengujian itu berasal, akhiran ditambahkan ke setiap nama pengujian pada mode lipat.
<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>
Ekspor hasil
Setelah semua pengujian selesai, Anda dapat menyimpan hasilnya sebagai laporan dan mendownloadnya ke sebuah komputer. Nama laporan akan diberi stempel waktu secara otomatis berdasarkan DUT waktu sistem.
Untuk menyimpan hasil pengujian, ketuk ikon simpan (disk) di bagian atas daftar kategori pengujian.
Tunggu hingga muncul pesan pop-up yang menampilkan jalur file ke laporan tersimpan (untuk contoh,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
), lalu mencatat jalur.Hubungkan DUT ke komputer Linux.
Dari penginstalan Android SDK di komputer Linux, download laporan dari perangkat terhubung menggunakan
adb shell content read
atauadb pull CTSVerifierReportPath
.Untuk Android 7.x dan versi yang lebih baru, download semua laporan menggunakan perintah berikut:
adb pull /sdcard/verifierReports
Untuk Android 6.0 dan versi yang lebih lama, download semua laporan menggunakan perintah berikut:
adb pull /mnt/sdcard/ctsVerifierReports/
Untuk Android 10 dan yang lebih baru, menerapkan Otomotif dan perangkat yang berjalan sebagai pengguna sekunder, download laporan terbaru menggunakan perintah berikut:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
Untuk menampilkan daftar semua laporan yang tersedia di perangkat yang terhubung:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
Untuk mengunduh laporan dari daftar, Anda dapat menentukan ID Baris atau . Contoh:
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
Untuk menghapus hasil lulus/gagal, pilih hasil di aplikasi CTS Verifier dan pilih Menu > Hapus.