Untuk menjalankan CTS, pertama-tama persiapkan lingkungan fisik Anda, mesin desktop Anda, dan perangkat Android yang Anda gunakan untuk pengujian.
Lingkungan fisik
Suar Bluetooth LE
Jika perangkat yang diuji (DUT) mendukung Bluetooth LE, letakkan setidaknya tiga suar Bluetooth LE dalam jarak 5 meter dari DUT untuk pengujian pemindaian Bluetooth LE. Beacon tersebut tidak perlu dikonfigurasi atau memancarkan sesuatu yang spesifik, dan dapat berupa apa saja, termasuk iBeacon, Eddystone, atau bahkan perangkat yang mensimulasikan beacon BLE.
Pita lebar ultra
Jika DUT mendukung ultra-wideband (UWB), perangkat lain yang mendukung UWB harus diposisikan cukup dekat dan berorientasi agar tidak terdapat antena dan zona mati radio. Untuk pengujian akurasi jarak, terdapat kebutuhan penentuan posisi dan orientasi tertentu. Untuk detail pengaturan, lihat Persyaratan UWB . Tes UWB harus dijalankan secara manual, dengan menentukan pada baris perintah dua perangkat mana yang berjarak satu meter. Untuk detail tentang sharding yang diperlukan untuk pengujian ini, lihat Sharding lokal .
Kamera
Saat menjalankan CTS kamera, gunakan kondisi pencahayaan normal dengan bagan pola uji (seperti pola kotak-kotak). Tempatkan bagan pola pengujian sesuai dengan jarak fokus minimum DUT untuk memastikannya tidak terlalu dekat dengan lensa.
Arahkan sensor kamera ke pemandangan dengan pencahayaan yang cukup untuk memungkinkan sensor yang diuji mencapai dan tetap pada target frame per detik (FPS) maksimum yang dikonfigurasi seperti yang ditentukan dalam CONTROL_AE_TARGET_FPS_RANGE
. Hal ini berlaku untuk semua sensor kamera yang dilaporkan oleh getCameraIdList
saat pengujian dilakukan pada perangkat yang terdaftar dan mengukur kinerja satu per satu.
Jika DUT mendukung kamera eksternal, seperti webcam USB, sambungkan kamera eksternal saat menjalankan CTS. Jika tidak, pengujian CTS akan gagal.
GPS/GNSS
Jika DUT mendukung fitur sistem penentuan posisi global/sistem satelit navigasi global (GPS/GNSS), berikan sinyal GPS/GNSS ke DUT pada tingkat sinyal yang sesuai untuk penerimaan dan penghitungan lokasi GPS. Porsi GPS harus sesuai dengan ICD-GPS-200C. Jika tidak, sinyal GPS/GNSS dapat berupa apa saja, termasuk simulator satelit atau repeater GPS/GNSS untuk sinyal luar ruangan, atau Anda dapat menempatkan DUT cukup dekat dengan jendela sehingga dapat langsung menerima sinyal GPS/GNSS yang cukup.
Wi-Fi dan IPv6
Pengujian CTS memerlukan jaringan Wi-Fi yang mendukung IPv4 dan IPv6, memiliki koneksi internet dengan DNS yang berfungsi untuk IPv4 dan IPv6, mendukung IP multicast, dan dapat memperlakukan DUT sebagai klien terisolasi. Klien terisolasi adalah konfigurasi di mana DUT tidak memiliki visibilitas ke pesan siaran/multijaringan di subjaringan tersebut. Hal ini terjadi dengan konfigurasi titik akses (AP) Wi-Fi atau dengan menjalankan DUT pada subjaringan terisolasi tanpa perangkat lain tersambung.
Jika Anda tidak memiliki akses ke jaringan IPv6 asli, jaringan operator IPv6, atau VPN untuk lulus beberapa pengujian bergantung pada IPv6, Anda dapat menggunakan titik akses Wi-Fi dan terowongan IPv6.
Untuk melewati CTS, DUT memerlukan flag UP
, BROADCAST
, dan MULTICAST
yang disetel pada antarmuka Wi-Fi. Antarmuka Wi-Fi memerlukan alamat IPv4 dan IPv6 yang ditetapkan. Periksa properti antarmuka Wi-Fi dengan adb shell ifconfig
.
Untuk perangkat yang mendukung Konkurensi Wi-Fi STA/STA , diperlukan beberapa jaringan Wi-Fi (minimal 2). Untuk melewati CTS, jaringan Wi-Fi harus berjalan pada band berbeda dengan SSID berbeda atau pada SSID yang sama dengan BSSID berbeda.
RTT Wi-Fi
Android menyertakan API RTT Wi-Fi untuk kemampuan waktu perjalanan pulang pergi (RTT) Wi-Fi . Hal ini memungkinkan perangkat mengukur jaraknya ke titik akses dengan akurasi 1 hingga 2 meter, sehingga meningkatkan akurasi lokasi dalam ruangan secara signifikan. Dua perangkat yang direkomendasikan mendukung Wi-Fi RTT adalah Google Wifi dan titik akses fitlet2 Compulab (disetel ke bandwidth 40 MHz pada 5 GHz).
Titik akses harus dihidupkan, namun tidak memerlukan koneksi jaringan. Titik akses tidak perlu berada di sebelah perangkat pengujian namun disarankan berada dalam jarak 40 kaki dari DUT. Satu titik akses biasanya cukup.
Pengaturan mesin desktop
Perhatian : CTS mendukung mesin Linux 64-bit. CTS tidak didukung di OS Windows atau MacOS.
FFMPEG
Instal paket ffmpeg versi 5.1.3 (atau lebih baru) di mesin host.
Peningkatan mesin host
Sangat disarankan untuk meningkatkan RAM mesin host CTS menjadi 128GB dan HDD menjadi 256GB. Hal ini diperlukan untuk mengakomodasi peningkatan jumlah kasus uji CTS dan peningkatan reservasi ruang heap Java di tradefed.
ADB dan AAPT2
Sebelum menjalankan CTS, pastikan Anda telah menginstal versi terbaru Android Debug Bridge (adb) dan Android Asset Packaging Tool (AAPT2) dan menambahkan lokasi alat tersebut ke jalur sistem mesin Anda.
Untuk menginstal ADB dan AAPT2, unduh Android SDK Platform Tools dan Android SDK Build Tools terbaru dari SDK Manager Android Studio atau dari alat baris perintah sdkmanager .
Pastikan adb
dan aapt2
berada di jalur sistem Anda. Perintah berikut mengasumsikan bahwa Anda telah mengunduh arsip paket ke subdirektori bernama android-sdk
di direktori home Anda:
export PATH=$PATH:$HOME/android-sdk/platform-tools:$HOME/android-sdk/build-tools/<tools version number>
Kit Pengembangan Java untuk Ubuntu
Instal versi Java Development Kit (JDK) yang tepat.
- Untuk Android 11, instal OpenJDK11.
- Untuk Android 9 dan Android 10, instal OpenJDK9.
- Untuk Android 7.0, 7.1, 8.0 dan 8.1, instal OpenJDK8.
Untuk detailnya, lihat persyaratan JDK .
Penyiapan untuk dukungan Python
Instal virtualenv
untuk platform Anda dengan mengikuti petunjuk Instalasi .
Anda dapat memverifikasi bahwa instalasi berhasil dengan memanggil virtualenv -h
.
file CTS
Unduh dan buka paket CTS dari Compatibility Test Suite Downloads yang cocok dengan versi Android perangkat Anda dan semua antarmuka biner aplikasi (ABI) yang didukung perangkat Anda.
Unduh dan buka file media CTS versi terbaru.
Deteksi perangkat
Ikuti langkah ini untuk menyiapkan sistem agar dapat mendeteksi perangkat Anda .
Batas memori
Anda mungkin ingin meningkatkan memori maksimum yang tersedia selama uji coba di skrip cts-tradefed . Lihat contoh CL untuk informasi lebih lanjut.
Penyiapan perangkat Android
Pengguna membangun
Perangkat yang kompatibel didefinisikan sebagai perangkat dengan build bertanda tangan pengguna/kunci pelepas. Perangkat Anda harus menjalankan citra sistem berdasarkan build pengguna yang diketahui kompatibel (Android 4.0 atau lebih tinggi) dari Nama Kode, Tag, dan Nomor Build .
Properti build level API pertama
Persyaratan CTS tertentu bergantung pada versi awal perangkat dikirimkan. Misalnya, perangkat yang dikirimkan dengan versi sebelumnya mungkin dikecualikan dari persyaratan sistem yang berlaku untuk perangkat yang dikirimkan dengan versi lebih baru.
Agar informasi ini tersedia bagi CTS, produsen perangkat dapat menentukan properti waktu pembuatan ro.product.first_api_level
. Nilai properti ini adalah level API pertama yang digunakan perangkat untuk diluncurkan secara komersial.
Produsen perangkat dapat menggunakan kembali implementasi umum yang mendasarinya untuk meluncurkan produk baru sebagai peningkatan dari produk yang sudah ada di grup perangkat yang sama. Produsen perangkat secara opsional dapat mengatur level API produk yang ada ke ro.product.first_api_level
, sehingga persyaratan peningkatan diterapkan untuk CTS dan Treble/VTS.
Produsen perangkat dapat menentukan PRODUCT_SHIPPING_API_LEVEL
di file device.mk
mereka untuk menyetel properti ini, seperti yang ditunjukkan dalam contoh berikut:
# PRODUCT_SHIPPING_API_LEVEL sets ro.product.first_api_level to indicate
# the first api level that the device has been commercially launched on.
PRODUCT_SHIPPING_API_LEVEL := 21
Level API pertama untuk Android 9 atau lebih tinggi
Untuk perangkat yang diluncurkan dengan Android 9 atau lebih tinggi, setel properti ro.product.first_api_level
ke nilai yang valid dari Codenames, Tags, dan Build Numbers .
Level API pertama untuk Android 8.x atau lebih rendah
Untuk perangkat yang diluncurkan pada Android 8.x atau lebih rendah, hapus (hapus) properti ro.product.first_api_level
untuk build pertama produk. Untuk semua build berikutnya, setel ro.product.first_api_level
ke nilai API level yang benar. Hal ini memungkinkan properti mengidentifikasi produk baru dengan benar dan menyimpan informasi tentang API level pertama produk tersebut. Jika tandanya tidak disetel, Android akan menetapkan Build.VERSION.SDK_INT
ke ro.product.first_api_level
.
Paket shim CTS
Android 10 atau lebih tinggi menyertakan format paket yang disebut APEX . Untuk menjalankan pengujian CTS untuk API manajemen APEX (seperti memperbarui ke versi baru atau melaporkan APEX aktif), Anda harus melakukan pra-instal paket CtsShimApex
pada partisi /system
.
Uji validasi shim APEX memverifikasi penerapan CtsShimApex
.
persyaratan ro.apex.dapat diperbarui
Jika properti
ro.apex.updatable
diatur ketrue
,CtsShimApex
diperlukan untuk semua perangkat yang mendukung manajemen paket APEX.Jika properti
ro.apex.updatable
tidak ada atau tidak disetel,CtsShimApex
tidak perlu diinstal sebelumnya di perangkat.
Uji validasi shim APEX memverifikasi penerapan CtsShimApex
.
Prainstal dan pramuat CtsShim
Dimulai dengan Android 11, CtsShimApex
berisi dua aplikasi bawaan (yang dibuat dari build source ), yang tidak berisi kode apa pun kecuali manifes. CTS menggunakan aplikasi ini untuk menguji hak istimewa dan izin.
Jika perangkat tidak mendukung manajemen paket APEX (yaitu, properti ro.apex.updatable
tidak ada atau tidak disetel), atau jika perangkat menjalankan versi 10 atau lebih rendah, kedua aplikasi bawaan tersebut harus diinstal sebelumnya di sistem secara terpisah.
Jika APEX didukung, prainstal untuk rilis yang sesuai harus ditempatkan sebagai /system/apex/com.android.apex.cts.shim.apex
.
Jika aplikasi bawaan biasa digunakan, CtsShim
dan CtsShimPriv
untuk rilis yang sesuai harus ditempatkan masing-masing sebagai /system/app/CtsShimPrebuilt.apk
dan /system/priv-app/CtsShimPrivPrebuilt.apk
.
Tabel berikut mencantumkan prainstal dan pramuat yang tersedia untuk setiap versi dan arsitektur perangkat.
Versi Perangkat | Pra-instal (jika APEX didukung) | Pramuat | ||
---|---|---|---|---|
LENGAN | x86 | LENGAN | x86 | |
Android 14 | android14-arm-release | rilis android14-x86 | android14-arm-CtsShim.apk | android14-x86-CtsShim.apk |
Android 13 | android13-arm-release | rilis android13-x86 | android13-arm-CtsShim.apk | android13-x86-CtsShim.apk |
Android 12 | android12-arm-release | rilis android12-x86 | android12-arm-CtsShim.apk | android12-x86-CtsShim.apk |
Android 11 | android11-arm-release | rilis android11-x86 | android11-arm-CtsShim.apk | android11-x86-CtsShim.apk |
Android 10 | rilis android10 | android10-arm-CtsShim.apk | android10-x86-CtsShim.apk | |
Android 9, O, dan O-MR1 | T/A | T/A | lengan-CtsShim.apk | x86-CtsShim.apk |
Untuk lulus pengujian, muat aplikasi terlebih dahulu ke direktori yang sesuai pada image sistem tanpa perlu menandatangani ulang aplikasi.
Contoh applet
Android 9 memperkenalkan Open Mobile API. Untuk perangkat yang melaporkan lebih dari satu elemen aman, CTS menambahkan kasus pengujian untuk memvalidasi perilaku Open Mobile API. Kasus uji ini memerlukan instalasi satu kali applet sampel ke dalam Elemen Aman tertanam (eSE) dari DUT atau ke dalam kartu SIM yang digunakan oleh DUT. Applet sampel eSE dan applet sampel SIM dapat ditemukan di AOSP.
Lihat Pengujian CTS untuk Elemen Aman untuk informasi lebih detail tentang kasus pengujian Open Mobile API dan kasus pengujian Kontrol Akses.
Persyaratan penyimpanan
Tes stres media CTS mengharuskan klip video berada di penyimpanan eksternal ( /sdcard
). Sebagian besar klip berasal dari Big Buck Bunny , yang merupakan hak cipta Blender Foundation di bawah lisensi Creative Commons Attribution 3.0 .
Ruang yang diperlukan tergantung pada resolusi pemutaran video maksimum yang didukung oleh perangkat. Lihat bagian 5 dalam dokumen Definisi Kompatibilitas Android untuk versi platform dari resolusi yang diperlukan.
Berikut adalah persyaratan penyimpanan berdasarkan resolusi pemutaran video maksimum:
- 480x360: 98 MB
- 720x480: 193MB
- 1280x720: 606 MB
- 1920x1080: 1863 MB
Layar dan penyimpanan
- Perangkat apa pun yang tidak memiliki layar tertanam harus terhubung ke layar.
Jika perangkat memiliki slot kartu memori, colokkan kartu SD kosong. Gunakan kartu SD yang mendukung bus berkecepatan ultra tinggi (UHS) dengan kapasitas SDHC atau SDXC atau yang memiliki setidaknya kelas kecepatan 10 atau lebih tinggi untuk memastikan dapat melewati CTS.
Jika perangkat memiliki slot kartu SIM, colokkan kartu SIM yang diaktifkan ke setiap slot. Jika perangkat mendukung SMS, setiap kartu SIM harus diisi kolom nomornya sendiri. Untuk perangkat yang menjalankan Android 12 atau lebih tinggi, semua kartu SIM harus memiliki dukungan untuk menyimpan nomor panggilan singkat (ADN). Kartu GSM dan USIM dengan file khusus telekomunikasi (DF Telecom ) memenuhi persyaratan ini.
Pengembang UICC
Untuk menjalankan pengujian API operator CTS, perangkat perlu menggunakan SIM dengan hak istimewa operator CTS yang memenuhi persyaratan yang ditentukan dalam Mempersiapkan UICC .
Konfigurasi perangkat Android
Reset data pabrik pada perangkat: Pengaturan > Cadangkan & setel ulang > Reset data pabrik .
Atur bahasa perangkat Anda ke Bahasa Inggris ( Amerika Serikat ): Pengaturan > Bahasa & masukan > Bahasa .
Jika perangkat mendukung penyesuaian font default, atur keluarga font
sans-serif
default keRoboto
(keluarga fontsans-serif
default yang digunakan dalam build AOSP).Aktifkan pengaturan lokasi jika terdapat fitur GPS atau Wi-Fi/jaringan seluler di perangkat: Pengaturan > Lokasi > Aktif .
Menyambungkan ke jaringan Wi-Fi yang mendukung IPv6, dapat memperlakukan DUT sebagai klien terisolasi (lihat Lingkungan fisik di atas), dan memiliki koneksi internet: Pengaturan > Wi-Fi .
Pastikan tidak ada pola kunci atau kata sandi yang disetel pada perangkat: Pengaturan > Keamanan > Kunci layar > Tidak Ada .
Aktifkan USB debugging di perangkat Anda: Pengaturan > Opsi pengembang > USB debugging .
Atur waktu ke format 12 jam: Pengaturan > Tanggal & waktu > Gunakan format 24 jam > Mati .
Mengatur perangkat agar tetap terjaga: Setelan > Opsi pengembang > Tetap Terjaga > Aktif .
Khusus di Android 5.x dan 4.4.x , atur perangkat agar mengizinkan lokasi tiruan: Setelan > Opsi pengembang > Izinkan lokasi tiruan > Aktif .
Di Android 4.2 atau lebih tinggi , matikan verifikasi aplikasi USB: Setelan > Opsi pengembang > Verifikasi aplikasi melalui USB > Mati .
Di Android 13 atau lebih tinggi , atur perangkat untuk mengizinkan modem tiruan: Setelan > Opsi pengembang > Izinkan Modem Tiruan > Aktif .
Luncurkan browser dan tutup layar pengaktifan/pengaturan apa pun.
Hubungkan mesin desktop yang akan digunakan untuk menguji perangkat dengan kabel USB.
Sebelum menjalankan CTS, atur Roboto2 sebagai font sans-serif menggunakan pengaturan keterjangkauan yang dapat diakses pengguna (tidak tersembunyi).
Instalasi berkas
Instal dan konfigurasikan aplikasi pembantu di perangkat.
Siapkan perangkat Anda sesuai dengan versi CTS Anda:
CTS versi 2.1 R2 hingga 4.2 R4: Siapkan perangkat Anda (atau emulator) untuk menjalankan tes aksesibilitas dengan:
adb install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk
Di perangkat, aktifkan delegasi: Pengaturan > Aksesibilitas > Aksesibilitas > Mendelegasikan Layanan Aksesibilitas .
CTS versi 6.x atau lebih rendah: Pada perangkat yang mendeklarasikan
android.software.device_admin
, siapkan perangkat Anda untuk menjalankan pengujian administrasi perangkat menggunakan:adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`
Di Pengaturan > Keamanan > Pilih administrator perangkat , aktifkan dua administrator perangkat
android.deviceadmin.cts.CtsDeviceAdminReceiver*
. Pastikanandroid.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver
dan administrator perangkat lain yang dimuat sebelumnya tetap dinonaktifkan.
Salin file media CTS ke perangkat sebagai berikut:
- Navigasikan (
cd
) ke jalur tempat file media diunduh dan dibuka ritsletingnya. Ubah izin file:
chmod u+x copy_media.sh
Salin file yang diperlukan:
Untuk menyalin klip hingga resolusi 720x480, jalankan:
./copy_media.sh 720x480
Jika Anda tidak yakin dengan resolusi maksimum, salin semua file:
./copy_media.sh all
Jika ada beberapa perangkat di bawah adb, tambahkan opsi serial (
-s
) dari perangkat tertentu di akhir. Misalnya, untuk menyalin hingga 720x480 ke perangkat dengan serial 1234567, jalankan:./copy_media.sh 720x480 -s 1234567
- Navigasikan (