Federasi Dagang adalah kerangka pengujian berkelanjutan untuk menjalankan pengujian pada perangkat Android. Untuk menjalankan Compatibility Test Suite (CTS), baca terlebih dahulu Tinjauan Federasi Perdagangan untuk penjelasan tentang kerangka pengujian Tradefed.
Untuk menjalankan rencana pengujian:
- Siapkan Perangkat yang Sedang Diuji (DUT) sesuai pengaturan perangkat Android .
- Pastikan Anda telah menginstal versi terbaru Android Debug Bridge (adb) dan Android Asset Packaging Tool (AAPT) dan menambahkan lokasi alat tersebut ke jalur sistem mesin Anda. Untuk informasi tentang cara menginstal alat tersebut, lihat Menyiapkan CTS: ADB dan AAPT.
- Unduh build CTS yang dirilis ke mesin host Linux Anda dan unzip build ke lokasi host.
- Hubungkan setidaknya satu perangkat. Untuk mempersiapkan DUT:
- Tekan tombol beranda untuk mengatur perangkat ke layar beranda.
- Jangan gunakan DUT untuk tugas lainnya.
- Jaga DUT pada posisi diam untuk menghindari memicu aktivitas sensor.
- Arahkan kamera perangkat ke objek yang dapat difokuskan.
- Jangan tekan tombol apa pun pada perangkat saat CTS sedang berjalan. Menekan tombol atau menyentuh layar DUT akan mengganggu jalannya pengujian dan dapat menyebabkan kegagalan pengujian.
Luncurkan skrip cts-tradefed konsol CTS dari folder tempat paket CTS telah dibuka ritsletingnya. Di shell baris perintah host, jalankan:
./android-cts/tools/cts-tradefed
Jalankan rencana pengujian default (berisi semua paket pengujian):
cts-tradefed > run cts
Jika Anda ingin meningkatkan waktu eksekusi pengujian, Anda dapat membagi pengujian ke beberapa perangkat. Sharding mengharuskan host untuk menghubungkan setidaknya dua perangkat, namun enam perangkat atau lebih direkomendasikan untuk efisiensi. Saat melakukan sharding lebih dari 1 perangkat:
Untuk Android 9 dan lebih tinggi, gunakan opsi perintah
--shard-count number_of_shards
Untuk Android 8.1 dan lebih rendah, gunakan opsi perintah
--shards number_of_shards
Jika Anda tidak ingin menjalankan seluruh rangkaian pengujian, Anda dapat menjalankan paket CTS pilihan Anda dari baris perintah:
run cts --plan test_plan_name
Untuk menemukan nama rencana pengujian:
Untuk Android 7.0 dan lebih tinggi, untuk melihat daftar modul pengujian, enter
list modules
Untuk Android 6.0 dan lebih rendah, untuk melihat daftar rencana pengujian di repositori, enter
list plans
Untuk Android 6.0 dan lebih rendah, untuk melihat daftar paket pengujian di repositori, enter
list packages
Untuk opsi perintah tambahan tergantung pada versi CTS, lihat referensi perintah konsol , atau di bawah "bantuan semua" di konsol Tradefed.
Jalankan beberapa sesi Coba Ulang hingga semua modul pengujian selesai dan angka kegagalan pengujian sama dalam dua sesi coba ulang terakhir.
Untuk Android 9 dan lebih tinggi, gunakan
run retry --retry session_number --shard-count number_of_shards
Untuk Android 7.0–8.1, gunakan
run cts --retry session_number --shards number_of_shards
Untuk opsi perintah Coba Ulang tambahan bergantung pada versi CTS, lihat Konsol Perintah CTS v2 .
Untuk memahami detail implementasi percobaan ulang CTS, lihat Coba Ulang Rangkaian Federasi Perdagangan .
Jalankan sesi percobaan ulang hanya pada pengujian paratermerisasi yang gagal. Pengujian berparameter yang lulus tidak akan dicoba lagi.
Untuk Android 11 dan lebih tinggi, opsi perintah coba lagi berikut diaktifkan secara default di perintah
run cts:run retry --retry
--new-parameterized-handling
Lihat kemajuan tes dan hasil yang dilaporkan di konsol.
Jalankan CTS menggunakan Android Test Station
Android Test Station adalah alat otomatisasi pengujian yang dapat digunakan oleh pengembang dan teknisi pengujian Android untuk menggunakan antarmuka pengguna guna menjalankan rangkaian pengujian standar. Ia bekerja dengan Android Compatibility Test Suite (CTS) .
Alat ini tersedia untuk umum melalui Panduan Pengguna ATS , dan kodenya bersumber terbuka di AOSP ( multitest_transport , tradefed_cluster ).
Jalankan CTS untuk Mode Alternatif
Rilis CTS 10 R4 menambahkan rencana pengujian untuk perangkat dengan mode alternatif, atau untuk perangkat dengan lebih dari satu layar. Jalankan rencana pengujian mode alternatif menggunakan run cts-foldable .
Kasus pengujian yang lulus atau gagal untuk mode layar alternatif ditambahkan dengan nilai dari display_mode , misalnya testcase1[display_mode=0] .
Di CTS 13, DeviceStateManager API memungkinkan modul pengujian dengan opsi konfigurasi berikut dijalankan pada status perangkat berbeda dari perangkat yang dapat dilipat. Eksekusi pengujian dilakukan secara otomatis dalam CTS berdasarkan status pelipatan tampilan yang ditentukan dalam perangkat tanpa perlu menjalankan rencana pengujian cts-foldable .
<option name="config-descriptor:metadata" key="parameter" value="all_foldable_states" />
Pengujian multi-perangkat di CTS
Android 13 dan lebih tinggi mendukung pengujian multi-perangkat. Pengujian yang memerlukan beberapa perangkat dijalankan secara otomatis selama CTS dijalankan. CTS 13 menyertakan beberapa pengujian multi-perangkat yang terpicu secara otomatis saat sharding digunakan. Meskipun pengujian tidak memerlukan perubahan tambahan pada pengaturan fisik, virtualenv perlu diinstal agar pengujian dapat berjalan dengan benar. Untuk detailnya, lihat Suite Multi-Perangkat .
Jalankan pengujian multi-perangkat
Untuk menjalankan pengujian multi-perangkat secara mandiri, gunakan kode berikut:
cts-tradefed > run cts-multidevice
Semua opsi reguler didukung. Untuk menargetkan perangkat tertentu, tambahkan --serial <serial1> --serial <serial2> dan seterusnya sesuai jumlah perangkat yang ditargetkan.
Untuk memicu pengujian multi-perangkat secara otomatis, gunakan sharding, seperti pada --shard-count 2 .