Konsol perintah CTS v2

Menggunakan konsol CTS v2

Untuk Android 7.0 atau yang lebih tinggi, gunakan CTS v2.

Pilih paket

Paket pengujian yang tersedia meliputi:

  • cts—Menjalankan CTS dari penginstalan CTS yang sudah ada.
  • cts-camera— Menjalankan kamera CTS dari penginstalan CTS yang sudah ada.
  • cts-java— Menjalankan Core Java Test dari penginstalan CTS yang sudah ada.
  • cts-pdk— Menjalankan Pengujian yang berguna untuk memvalidasi build fusi PDK.
  • semuanya— Konfigurasi umum untuk Compatibility suite.

Konfigurasi lain yang tersedia meliputi:

  • basic-reporter— Konfigurasi dengan reporter CTS dasar.
  • collect-tests-only—Menjalankan CTS dari penginstalan 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 yang diketahui CTS.
  • cts-preconditions— Konfigurasi prasyarat CTS.
  • host— Menjalankan pengujian berbasis host tunggal di perangkat yang ada.
  • instrument — Menjalankan satu uji instrumentasi Android di perangkat yang ada.
  • native-benchmark— Menjalankan pengujian daya tahan native di perangkat yang ada.
  • native-stress— Menjalankan pengujian daya tahan native pada perangkat yang sudah ada.
  • isi ulang — Pengujian palsu yang menunggu perangkat hampir habis dan menahannya untuk diisi daya.
  • testdef— Menjalankan pengujian yang terdapat dalam file test_def.xml di perangkat yang sudah ada.
  • util/wifi— Konfigurasi utilitas untuk mengonfigurasi Wi-Fi di perangkat.
  • util/lanjut— Menghapus total data pengguna pada 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 penggunaan.

Host Deskripsi
help Menampilkan ringkasan perintah yang paling umum digunakan
help all Menampilkan daftar lengkap perintah yang tersedia
version Menampilkan versi.
exit Keluar dari konsol CTS dengan baik. Konsol ditutup saat semua yang sedang berjalan telah selesai.
extdir

File download yang di-zip akan didekompresi menjadi extdir. Jika Anda ingin hapus output yang di-inflate, 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, cukup jalankan:

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

Jalankan Deskripsi
run cts

Di Android 10, jalankan rencana CTS default dan CTS-Instant bersama-sama (yaitu, pemanggilan CTS lengkap). Untuk Android 9 atau yang lebih lama, jalankan setelan default Khusus paket CTS. Gunakan opsi komprehensif ini (termasuk prasyarat) untuk validasi perangkat. Lihat cts.xml untuk melihat penyertaan.

Konsol CTS dapat menerima perintah lain saat pengujian sedang berlangsung.

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

run cts-instant

Untuk Android 9, jalankan rencana CTS-Instant default.

run cts --module-parameter INSTANT_APP

Di Android 10, jalankan rencana CTS-Instant default.

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

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

run retry

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

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

run cts-sim

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

--device-token

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

--enable-token-sharding

Khusus Android 10 atau yang lebih baru. Secara otomatis cocok dengan pengujian yang memerlukan jenis SIM masing-masing. Tidak perlu memberikan nomor seri perangkat untuk mengeksekusi Kasus pengujian terkait SIM. SIM yang didukung: SIM_CARD, UICC_SIM_CARD, dan SECURE_ELEMENT_SIM_CARD.

run cts-dev

Menjalankan rencana CTS default (yaitu, pemanggilan CTS penuh), tetapi lewati prasyarat guna menghemat waktu proses untuk pengembangan berulang dari uji coba. Setelan ini mengabaikan verifikasi dan penyiapan Anda, seperti mendorong file media atau memeriksa Wi-Fi koneksi jarak jauh, seperti yang dilakukan saat opsi --skip-preconditions digunakan. Ini juga melewati pengumpulan informasi perangkat, dan semua pemeriksa status sistem. Anda juga menjalankan pengujian hanya pada satu ABI. Untuk validasi perangkat, hindari pengoptimalan ini dan menyertakan 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 agar perangkat terhubung sebelum memulai pengujian. Jika lebih dari satu terhubung, {i>host<i} CTS akan memilih perangkat secara otomatis.

--subplan subplan_name Menjalankan subpaket yang ditentukan.
--module/-m test_module_name --test/-t test_name  Jalankan modul yang ditentukan dan lakukan pengujian. Misalnya, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes menjalankan paket, class, atau pengujian tertentu.
--retry Coba lagi semua pengujian yang gagal atau tidak dijalankan dari sesi sebelumnya. Gunakan list results untuk mendapatkan ID sesi.
--retry-type NOT_EXECUTED Hanya coba lagi pengujian 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. Melakukan sharding CTS sejumlah potongan independen tertentu, untuk dijalankan di beberapa perangkat secara paralel.
--shard-count number_of_shards Untuk Android 9. Melakukan sharding CTS akan menghasilkan potongan independen, untuk berjalan di beberapa perangkat secara paralel.
--serial/-s deviceID Jalankan CTS di perangkat tertentu.
--include-filter "test_module_name test_name" Jalankan dengan modul yang ditentukan, atau paket, class, dan kasus pengujian. Misalnya, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" menyertakan modul yang ditentukan.

Opsi perintah ini tidak didukung saat menjalankan percobaan ulang.

--exclude-filter "test_module_name test_name" Mengecualikan modul tertentu, atau paket, class, dan kasus pengujian dari operasi. Misalnya, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" tidak mencakup modul yang ditentukan.
--log-level-display/-l log_level Jalankan dengan level log minimum yang ditentukan, yang ditampilkan kepada STDOUT. Nilai valid: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT].
--abi abi_name Memaksa pengujian untuk berjalan pada ABI, 32 atau 64 yang ditentukan. CTS default menjalankan pengujian satu kali untuk setiap ABI yang didukung perangkat.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure
Memberikan visibilitas yang lebih besar terhadap kegagalan dan dapat membantu diagnostik.
--device-token Menentukan bahwa perangkat tertentu memiliki token yang diberikan, seperti --device-token 1a2b3c4d:sim-card.
--skip-device-info Melewati pengumpulan informasi tentang perangkat.
--skip-preconditions Lewati prasyarat guna menghemat waktu proses untuk pengembangan berulang pengujian baru. Setelan ini mengabaikan verifikasi dan penyiapan Anda, seperti mendorong file media atau memeriksa Wi-Fi koneksi jarak jauh.
Daftar Deskripsi
list modules Mencantumkan semua modul pengujian yang tersedia di repositori.
list plans atau list configs Mencantumkan semua rencana pengujian (konfigurasi) yang tersedia di repositori.
list subplans Mencantumkan semua subpaket yang tersedia di repositori.
list invocations Menampilkan daftar perintah run yang saat ini dijalankan di perangkat.
list commands Menampilkan daftar semua perintah run yang saat ini ada dalam antrean yang menunggu untuk ditetapkan ke perangkat.
list results Menampilkan daftar hasil CTS yang saat ini disimpan di repositori.
list devices Menampilkan daftar perangkat yang saat ini terhubung dan statusnya.

Perangkat yang tersedia adalah perangkat yang berfungsi dan tidak ada aktivitas, serta tersedia untuk menjalankan pengujian.

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

Perangkat yang dialokasikan adalah perangkat yang saat ini menjalankan pengujian.

Dump Deskripsi
dump logs Membuang log yang diperdagangkan untuk semua pemanggilan yang berjalan.
Tambahkan Deskripsi
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]
Membuat subrencana yang berasal dari sesi sebelumnya; opsi ini akan menghasilkan subrencana yang dapat digunakan untuk menjalankan subset pengujian.

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