Konsol Perintah CTS v2

Menggunakan konsol CTS v2

Untuk Android 7.0 atau lebih tinggi, gunakan CTS v2.

Memilih rencana

Rencana pengujian yang tersedia meliputi:

  • 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 Java Inti dari instalasi CTS yang sudah ada sebelumnya.
  • cts-pdk — Menjalankan Tes yang berguna untuk memvalidasi build fusi PDK.
  • semuanya — Konfigurasi umum untuk suite Kompatibilitas.

Konfigurasi lain yang tersedia meliputi:

  • basic-reporters — Konfigurasi dengan reporter CTS dasar.
  • kumpulkan-tes-saja —Menjalankan CTS dari instalasi CTS yang sudah ada sebelumnya.
  • common-compatibility-config — Konfigurasi umum untuk suite Kompatibilitas.
  • cts-filtered-sample — Konfigurasi umum untuk suite 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.
  • instrument — Menjalankan pengujian instrumentasi Android tunggal pada perangkat yang ada.
  • native-benchmark — Menjalankan stress test asli pada perangkat yang ada.
  • native-stress — Menjalankan tes stres asli pada perangkat yang ada.
  • isi ulang — Tes palsu yang menunggu perangkat yang hampir habis dan menahannya untuk diisi daya.
  • 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 Tampilkan daftar lengkap perintah yang tersedia
version Tampilkan versi.
exit Keluar dari konsol CTS dengan anggun. Konsol ditutup ketika semua pengujian yang sedang berjalan selesai.
extdir

File unduhan zip didekompresi ke 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 membuka zip ke direktori saat ini, jangan gunakan opsi -d , jalankan saja:

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

Lari Keterangan
run cts

Di Android 10, jalankan paket CTS default dan CTS-Instan bersama-sama (yaitu, permintaan 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 inklusi.

Konsol CTS dapat menerima perintah lain saat pengujian sedang berlangsung.

Jika tidak ada perangkat yang terhubung, mesin desktop CTS (atau host) akan menunggu perangkat terhubung sebelum memulai pengujian. Jika lebih dari satu perangkat 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 tes 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 yang lebih tinggi. Menjalankan subset pengujian pada perangkat dengan kartu SIM.

--device-token

Untuk Android 8.1 atau versi yang 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 uji kasus terkait SIM. SIM yang didukung: SIM_CARD , UICC_SIM_CARD , dan SECURE_ELEMENT_SIM_CARD .

run cts-dev

Jalankan paket CTS default (yaitu, permintaan CTS penuh) tetapi lewati prasyarat untuk menghemat waktu proses untuk pengembangan berulang dari pengujian baru. Ini melewati verifikasi dan pengaturan konfigurasi perangkat, seperti mendorong file media atau memeriksa koneksi Wi-Fi, seperti yang dilakukan ketika --skip-preconditions digunakan. Perintah ini juga melewati pengumpulan informasi perangkat, dan semua pemeriksa status sistem. Itu juga menjalankan tes 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 CTS (atau host) akan menunggu perangkat terhubung sebelum memulai pengujian. Jika lebih dari satu perangkat 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 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 tes yang tidak dijalankan dari sesi sebelumnya. Gunakan list results untuk mendapatkan id sesi.
--shards number_of_shards Untuk Android 8.1 atau versi yang lebih rendah . Pecahkan CTS ke dalam jumlah tertentu dari potongan independen, untuk dijalankan di beberapa perangkat secara paralel.
--shard-count number_of_shards Untuk Android9 . Pecahkan CTS ke dalam jumlah tertentu dari potongan independen, untuk dijalankan di beberapa perangkat secara paralel.
--serial/-s deviceID Jalankan CTS pada perangkat tertentu.
--include-filter "test_module_name test_name" Jalankan dengan modul yang ditentukan, atau paket pengujian, kelas, dan kasus. Misalnya, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" menyertakan modul yang ditentukan.

Opsi perintah ini tidak didukung saat menjalankan coba lagi.

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

Perangkat 'Tersedia' berfungsi, perangkat idle, 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 'Alokasi' adalah perangkat yang sedang menjalankan pengujian.

Membuang Keterangan
dump logs Buang log tradefed untuk semua pemanggilan yang sedang 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 subplan yang dapat digunakan untuk menjalankan subset pengujian.

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