Konsol perintah CTS v2

Gunakan konsol CTS v2

Untuk Android 7.0 atau lebih tinggi, gunakan CTS v2.

Pilih paket

Rencana pengujian yang tersedia meliputi yang berikut:

  • cts —Menjalankan CTS dari instalasi CTS yang sudah ada sebelumnya.
  • cts-camera — Menjalankan kamera CTS dari instalasi CTS yang sudah ada sebelumnya.
  • cts-java — Menjalankan Tes Inti Java dari instalasi CTS yang sudah ada sebelumnya.
  • cts-pdk — Menjalankan Tes yang berguna untuk memvalidasi build fusi PDK.
  • semuanya — Konfigurasi umum untuk rangkaian Kompatibilitas.

Konfigurasi lain yang tersedia meliputi yang berikut:

  • basic-reporters — Konfigurasi dengan reporter CTS dasar.
  • Collect-tests-only —Menjalankan CTS dari instalasi CTS yang sudah ada sebelumnya.
  • common-compatibility-config — Konfigurasi umum untuk rangkaian Kompatibilitas.
  • cts-filtered-sample — Konfigurasi umum untuk rangkaian Kompatibilitas.
  • cts-known-failures — Konfigurasi dengan kegagalan CTS yang diketahui.
  • cts-preconditions — Konfigurasi prasyarat CTS.
  • host — Menjalankan pengujian berbasis host tunggal pada perangkat yang ada.
  • instrumen — Menjalankan pengujian instrumentasi Android tunggal pada perangkat yang ada.
  • native-benchmark — Menjalankan stress test asli pada perangkat yang ada.
  • native-stress — Menjalankan stress test asli pada perangkat yang ada.
  • isi ulang — Tes palsu yang menunggu perangkat hampir habis dan menahannya untuk diisi dayanya.
  • testdef — Menjalankan pengujian yang terdapat dalam file test_def.xml pada perangkat yang ada.
  • util/wifi — Konfigurasi utilitas untuk mengonfigurasi Wi-Fi di perangkat.
  • util/wipe — Menghapus data pengguna di perangkat.

Semua rencana dan konfigurasi ini dapat dijalankan dengan perintah run cts .

Referensi perintah konsol CTS v2

Tabel ini merangkum perintah konsol CTS v2 untuk berbagai kegunaan.

Tuan rumah Keterangan
help Menampilkan ringkasan perintah yang paling umum digunakan
help all Menampilkan daftar lengkap perintah yang tersedia
version Tunjukkan versinya.
exit Keluar dari konsol CTS dengan anggun. Konsol ditutup ketika semua pengujian yang sedang berjalan telah selesai.
extdir

File unduhan yang di-zip didekompresi menjadi extdir . Jika Anda ingin menghilangkan output yang meningkat, gunakan opsi -q :

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Jika Anda ingin mengekstrak ke direktori saat ini, jangan gunakan opsi -d , jalankan saja:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

Berlari Keterangan
run cts

Di Android 10, jalankan paket CTS default dan CTS-Instan secara bersamaan (yaitu, pemanggilan CTS lengkap). Untuk Android 9 atau lebih rendah, jalankan paket CTS default saja. Gunakan opsi komprehensif ini (termasuk prasyarat) untuk validasi perangkat. Lihat cts.xml untuk penyertaannya.

Konsol CTS dapat menerima perintah lain saat pengujian sedang berlangsung.

Jika tidak ada perangkat yang terhubung, mesin desktop (atau host) CTS akan menunggu perangkat terhubung sebelum memulai pengujian. Jika lebih dari satu perangkat yang terhubung, host CTS akan memilih perangkat secara otomatis.

run cts-instant

Untuk Android 9, jalankan paket CTS-Instan default.

run cts --module-parameter INSTANT_APP

Di Android 10, jalankan paket CTS-Instan default.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

Di Android 10, jalankan modul atau modul pengujian CTS-Instan yang ditentukan.

run retry

Hanya untuk Android 9 atau lebih tinggi. Coba lagi semua pengujian yang gagal atau tidak dijalankan dari sesi sebelumnya. Misalnya, run retry --retry -s atau run retry --retry --shard-count dengan TF sharding.

run cts --retry tidak diizinkan untuk Android 9 atau lebih tinggi.

run cts-sim

Untuk Android 11 atau versi lebih tinggi. Menjalankan subset pengujian pada perangkat dengan kartu SIM.

--device-token

Untuk Android 8.1 atau versi lebih rendah. Menentukan bahwa perangkat tertentu memiliki token yang diberikan. Misalnya, --device-token 1a2b3c4d:sim-card .

--enable-token-sharding

Hanya untuk Android 10 atau lebih tinggi . Secara otomatis mencocokkan tes yang memerlukan jenis SIM masing-masing. Tidak perlu memberikan nomor seri perangkat untuk menjalankan kasus uji terkait SIM. SIM yang didukung: SIM_CARD , UICC_SIM_CARD , dan SECURE_ELEMENT_SIM_CARD .

run cts-dev

Jalankan paket CTS default (yaitu, pemanggilan CTS penuh) tetapi lewati prasyarat untuk menghemat waktu proses untuk pengembangan berulang pengujian baru. Ini melewati verifikasi dan pengaturan konfigurasi perangkat, seperti mendorong file media atau memeriksa koneksi Wi-Fi, seperti yang dilakukan ketika opsi --skip-preconditions digunakan. Perintah ini juga melewati pengumpulan informasi perangkat, dan semua pemeriksa status sistem. Itu juga menjalankan pengujian hanya pada satu ABI. Untuk validasi perangkat, hindari pengoptimalan ini dan sertakan semua prasyarat dan pemeriksaan. Lihat cts-dev.xml untuk pengecualian.

Konsol CTS dapat menerima perintah lain saat pengujian sedang berlangsung.

Jika tidak ada perangkat yang terhubung, mesin desktop (atau host) CTS akan menunggu perangkat terhubung sebelum memulai pengujian. Jika lebih dari satu perangkat yang terhubung, host CTS akan memilih perangkat secara otomatis.

--subplan subplan_name Jalankan subplan yang ditentukan.
--module/-m test_module_name --test/-t test_name Jalankan modul yang ditentukan dan uji. Misalnya, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes akan menjalankan paket, kelas, atau pengujian tertentu.
--retry Coba lagi semua tes yang gagal atau tidak dijalankan dari sesi sebelumnya. Gunakan list results untuk mendapatkan id sesi.
--retry-type NOT_EXECUTED Coba lagi hanya pengujian yang tidak dijalankan dari sesi sebelumnya. Gunakan list results untuk mendapatkan id sesi.
--shards number_of_shards Untuk Android 8.1 atau versi lebih rendah . Shard sebuah CTS dijalankan ke dalam sejumlah potongan independen tertentu, untuk dijalankan pada beberapa perangkat secara paralel.
--shard-count number_of_shards Untuk Android 9 . Shard sebuah CTS dijalankan ke dalam sejumlah potongan independen tertentu, untuk dijalankan pada beberapa perangkat secara paralel.
--serial/-s deviceID Jalankan CTS pada perangkat tertentu.
--include-filter "test_module_name test_name" Jalankan dengan modul tertentu, atau uji paket, kelas, dan kasus. Misalnya, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" yang menyertakan modul yang ditentukan.

Opsi perintah ini tidak didukung saat menjalankan percobaan ulang.

--exclude-filter "test_module_name test_name" Kecualikan modul tertentu, atau paket pengujian, kelas, dan kasus, dari proses. Misalnya, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" tidak termasuk modul yang ditentukan.
--log-level-display/-l log_level Jalankan dengan level log minimum yang ditentukan ditampilkan ke STDOUT . Nilai yang valid: [ VERBOSE , DEBUG , INFO , WARN , ERROR , ASSERT ].
--abi abi_name Paksa pengujian untuk dijalankan pada ABI, 32, atau 64 yang diberikan. Secara default, CTS menjalankan pengujian satu kali untuk setiap ABI yang didukung perangkat.
--logcat-on-failure ,
--bugreport-on-failure ,
--screenshoot-on-failure
Memberikan lebih banyak visibilitas terhadap kegagalan dan dapat membantu diagnostik.
--device-token Menentukan perangkat tertentu yang memiliki token tertentu, seperti --device-token 1a2b3c4d:sim-card .
--skip-device-info Melewati pengumpulan informasi tentang perangkat.
--skip-preconditions Lewati prasyarat untuk menghemat waktu proses pengembangan pengujian baru secara berulang. Tindakan ini mengabaikan verifikasi dan pengaturan konfigurasi perangkat, seperti memasukkan file media atau memeriksa koneksi Wi-Fi.
Daftar Keterangan
list modules Daftar semua modul pengujian yang tersedia di repositori.
list plans atau list configs Cantumkan semua rencana pengujian (konfigurasi) yang tersedia di repositori.
list subplans Daftar semua subplan yang tersedia di repositori.
list invocations Daftar perintah 'jalankan' yang sedang dijalankan pada perangkat.
list commands Cantumkan semua perintah 'jalankan' yang saat ini ada dalam antrean menunggu untuk ditetapkan ke perangkat.
list results Daftar hasil CTS yang saat ini disimpan di repositori.
list devices Daftar perangkat yang terhubung saat ini dan statusnya.

Perangkat 'Tersedia' berfungsi, perangkat menganggur, tersedia untuk menjalankan pengujian.

Perangkat 'Tidak Tersedia' adalah perangkat yang terlihat melalui adb, tetapi tidak merespons perintah adb dan tidak akan dialokasikan untuk pengujian.

Perangkat yang 'dialokasikan' adalah perangkat yang sedang menjalankan pengujian.

Membuang Keterangan
dump logs Buang log tradefed untuk semua pemanggilan yang berjalan.
Menambahkan Keterangan
add subplan --name/-n subplan_name
--result-type
[pass | fail | timeout | notExecuted]
[--session session_id ]
Buat subplan yang berasal dari sesi sebelumnya; opsi ini menghasilkan subrencana yang dapat digunakan untuk menjalankan subset pengujian.

Satu-satunya opsi yang diperlukan adalah --session . Lainnya bersifat opsional, namun jika disertakan, harus diikuti dengan nilai. Opsi --result-type dapat diulang; misalnya add subplan --session 0 --result-type passed --result-type failed valid.