Jalankan tes (Atest)

Atest adalah alat baris perintah yang memungkinkan pengguna membuat, memasang, dan menjalankan pengujian Android secara lokal, sehingga sangat mempercepat pengujian yang dijalankan ulang tanpa memerlukan pengetahuan tentang opsi baris perintah rangkaian pengujian Federasi Perdagangan . Halaman ini menjelaskan cara menggunakan Atest untuk menjalankan pengujian Android.

Untuk informasi umum tentang tes menulis untuk Android, lihat Pengujian Platform Android .

Untuk informasi tentang keseluruhan struktur Atest, lihat Panduan Pengembang Atest .

Untuk informasi tentang menjalankan pengujian dalam file TEST_MAPPING melalui Atest, lihat Menjalankan pengujian dalam file TEST_MAPPING .

Untuk menambahkan fitur ke Atest, ikuti Alur Kerja Pengembang Atest .

Siapkan lingkungan Anda

Untuk menyiapkan lingkungan Atest Anda, ikuti petunjuk di Menyiapkan lingkungan , Memilih target , dan Membuat kode .

Penggunaan dasar

Perintah Atest mengambil bentuk berikut:

atest test-to-run [optional-arguments]

Argumen opsional

Tabel berikut mencantumkan argumen yang paling umum digunakan. Daftar lengkap tersedia melalui atest --help .

Pilihan Pilihan panjang Keterangan
-b --build Membangun target pengujian. (bawaan)
-i --install Menginstal artefak uji (APK) pada perangkat. (bawaan)
-t --test Menjalankan tes. (bawaan)
-s --serial Menjalankan pengujian pada perangkat yang ditentukan. Satu perangkat dapat diuji dalam satu waktu.
-d --disable-teardown Menonaktifkan pengujian pembongkaran dan pembersihan.
--info Tidak digunakan lagi.
--dry-run Uji coba Atest tanpa benar-benar membuat, memasang, atau menjalankan pengujian.
-m --rebuild-module-info Memaksa pembangunan kembali file module-info.json .
-w --wait-for-debugger Menunggu debugger selesai sebelum mengeksekusi.
-v --verbose Menampilkan pencatatan tingkat DEBUG.
--iterations Pengujian dijalankan berulang-ulang hingga iterasi maksimal tercapai. (10 secara default)
--rerun-until-failure [COUNT=10] Jalankan kembali semua pengujian hingga terjadi kegagalan atau iterasi maksimal tercapai. (10 secara default)
--retry-any-failure [COUNT=10] Jalankan kembali pengujian yang gagal hingga lulus atau iterasi maksimal tercapai. (10 secara default)
--start-avd Secara otomatis membuat AVD dan menjalankan pengujian pada perangkat virtual.
--acloud-create Membuat AVD menggunakan perintah acloud .
--[CUSTOM_ARGS] Menentukan argumen khusus untuk pelari pengujian.
-a --all-abi Menjalankan pengujian untuk semua arsitektur perangkat yang tersedia.
--host Menjalankan pengujian sepenuhnya pada host tanpa perangkat.
Catatan: Menjalankan pengujian host yang memerlukan perangkat dengan --host akan gagal.
--history Menampilkan hasil tes dalam urutan kronologis.
--latest-result Mencetak hasil tes terbaru.

Untuk informasi lebih lanjut tentang -b , -i dan -t , lihat bagian Tentukan langkah-langkah: membangun, menginstal, atau menjalankan .

Tentukan tes

Untuk menjalankan pengujian, tentukan satu atau beberapa pengujian menggunakan salah satu pengidentifikasi berikut:

  • Nama modul
  • Modul:Kelas
  • Nama kelas
  • Tes integrasi tradefed
  • Jalur berkas
  • Nama paket

Pisahkan referensi ke beberapa pengujian dengan spasi, seperti ini:

atest test-identifier-1 test-identifier-2

Nama modul

Untuk menjalankan seluruh modul pengujian, gunakan nama modulnya. Masukkan nama seperti yang muncul dalam variabel LOCAL_MODULE atau LOCAL_PACKAGE_NAME dalam file Android.mk atau Android.bp pengujian tersebut.

Contoh:

atest FrameworksServicesTests
atest CtsVideoTestCases

Modul:Kelas

Untuk menjalankan satu kelas dalam sebuah modul, gunakan Module:Class . Modul sama seperti yang dijelaskan dalam Nama modul . Kelas adalah nama kelas pengujian dalam file .java , dan dapat berupa nama kelas yang memenuhi syarat atau nama dasar.

Contoh:

atest CtsVideoTestCases:VideoEncoderDecoderTest
atest FrameworksServicesTests:ScreenDecorWindowTests
atest FrameworksServicesTests:com.android.server.wm.ScreenDecorWindowTests

Nama kelas

Untuk menjalankan satu kelas tanpa menyebutkan nama modul secara eksplisit, gunakan nama kelas.

Contoh:

atest ScreenDecorWindowTests
atest VideoEncoderDecoderTest

Tes integrasi tradefed

Untuk menjalankan tes yang terintegrasi langsung ke TradeFed (non-modul), masukkan nama seperti yang muncul di output perintah tradefed.sh list configs . Misalnya:

Untuk menjalankan tes reboot.xml :

atest example/reboot

Untuk menjalankan pengujian native-benchmark.xml :

atest native-benchmark

Jalur berkas

Atest mendukung menjalankan pengujian berbasis modul dan pengujian berbasis integrasi dengan memasukkan jalur ke file atau direktori pengujiannya sesuai kebutuhan. Ini juga mendukung menjalankan satu kelas dengan menentukan jalur ke file Java kelas tersebut. Jalur relatif dan absolut didukung.

Jalankan modul

Contoh berikut menunjukkan dua cara untuk menjalankan modul CtsVideoTestCases menggunakan jalur file.

Jalankan dari Android repo-root :

atest cts/tests/video

Jalankan dari Android repo-root/cts/tests/video :

    atest .

Jalankan kelas tes

Contoh berikut menunjukkan cara menjalankan kelas tertentu dalam modul CtsVideoTestCases menggunakan jalur file.

Dari Android repo-root :

    atest cts/tests/video/src/android/video/cts/VideoEncoderDecoderTest.java

Jalankan tes integrasi

Contoh berikut menunjukkan cara menjalankan pengujian integrasi menggunakan jalur file dari repo-root Android :

    atest tools/tradefederation/contrib/res/config/example/reboot.xml

Nama paket

Atest mendukung pencarian tes berdasarkan nama paket.

Contoh:

    atest com.android.server.wm
    atest com.android.uibench.janktests

Tentukan langkah-langkahnya: Bangun, instal, atau jalankan

Gunakan opsi -b , -i , dan -t untuk menentukan langkah mana yang akan dijalankan. Jika Anda tidak menentukan opsi, semua langkah akan dijalankan.

  • Bangun target saja: atest -b test-to-run
  • Jalankan pengujian saja: atest -t test-to-run
  • Instal apk dan jalankan tes: atest -it test-to-run
  • Bangun dan jalankan, tetapi jangan instal: atest -bt test-to-run

Atest dapat memaksa pengujian untuk melewati langkah pembersihan atau pembongkaran. Banyak tes, seperti CTS, membersihkan perangkat setelah tes dijalankan, jadi mencoba menjalankan kembali tes Anda dengan -t akan gagal tanpa parameter --disable-teardown . Gunakan -d sebelum -t untuk melewati langkah pembersihan pengujian dan menguji secara berulang.

atest -d test-to-run
atest -t test-to-run

Jalankan metode tertentu

Atest mendukung menjalankan metode tertentu dalam kelas pengujian. Meskipun seluruh modul perlu dibangun, hal ini mengurangi waktu yang diperlukan untuk menjalankan pengujian. Untuk menjalankan metode tertentu, identifikasi kelas menggunakan salah satu cara yang didukung untuk mengidentifikasi kelas (Modul:Kelas, jalur file, dll) dan tambahkan nama metode:

atest reference-to-class#method1

Saat menentukan beberapa metode, pisahkan dengan koma:

atest reference-to-class#method1,method2,method3

Contoh:

atest com.android.server.wm.ScreenDecorWindowTests#testMultipleDecors
atest FrameworksServicesTests:ScreenDecorWindowTests#testFlagChange,testRemoval

Dua contoh berikut menunjukkan cara yang lebih disukai untuk menjalankan satu metode, testFlagChange . Contoh-contoh ini lebih disukai daripada hanya menggunakan nama kelas karena menentukan modul atau lokasi file Java memungkinkan Atest menemukan tes lebih cepat.

Menggunakan Modul:Kelas:

atest FrameworksServicesTests:ScreenDecorWindowTests#testFlagChange

Dari Android repo-root :

atest frameworks/base/services/tests/wmtests/src/com/android/server/wm/ScreenDecorWindowTests.java#testFlagChange

Beberapa metode dapat dijalankan dari kelas dan modul yang berbeda:

atest FrameworksServicesTests:ScreenDecorWindowTests#testFlagChange,testRemoval ScreenDecorWindowTests#testMultipleDecors

Jalankan beberapa kelas

Untuk menjalankan beberapa kelas, pisahkan dengan spasi dengan cara yang sama seperti menjalankan beberapa pengujian. Atest membangun dan menjalankan kelas secara efisien, sehingga menentukan subset kelas dalam modul akan meningkatkan kinerja dibandingkan menjalankan keseluruhan modul.

Untuk menjalankan dua kelas dalam modul yang sama:

atest FrameworksServicesTests:ScreenDecorWindowTests FrameworksServicesTests:DimmerTests

Untuk menjalankan dua kelas dalam modul berbeda:

atest FrameworksServicesTests:ScreenDecorWindowTests CtsVideoTestCases:VideoEncoderDecoderTest

Jalankan biner GTest

Atest dapat menjalankan biner GTest. Gunakan -a untuk menjalankan pengujian ini untuk semua arsitektur perangkat yang tersedia, yang dalam contoh ini adalah armeabi-v7a (ARM 32-bit) dan arm64-v8a (ARM 64-bit).

Contoh tes masukan:

atest -a libinput_tests inputflinger_tests

Untuk memilih biner GTest tertentu yang akan dijalankan, gunakan titik dua (:) untuk menentukan nama pengujian, dan hashtag (#) untuk menentukan lebih lanjut metode individual.

Misalnya, untuk definisi pengujian berikut:

TEST_F(InputDispatcherTest, InjectInputEvent_ValidatesKeyEvents)

Jalankan perintah berikut untuk menentukan keseluruhan pengujian:

atest inputflinger_tests:InputDispatcherTest

Atau jalankan pengujian individual menggunakan yang berikut:

atest inputflinger_tests:InputDispatcherTest#InjectInputEvent_ValidatesKeyEvents

Jalankan pengujian di TEST_MAPPING

Atest dapat menjalankan pengujian dalam file TEST_MAPPING .

Jalankan tes pra-pengiriman secara implisit

Jalankan pengujian pra-pengiriman pada file TEST_MAPPING di direktori saat ini dan direktori induk:

atest

Jalankan pengujian pra-pengiriman pada file TEST_MAPPING di /path/to/project dan direktori induknya:

atest --test-mapping /path/to/project

Jalankan grup pengujian tertentu

Grup pengujian yang tersedia adalah: presubmit (default), postsubmit , mainline-presubmit , dan all .

Jalankan tes pascapengiriman dalam file TEST_MAPPING di direktori saat ini dan direktori induk:

atest :postsubmit

Jalankan pengujian dari semua grup dalam file TEST_MAPPING:

atest :all

Jalankan tes postsubmit pada file TEST_MAPPING di /path/to/project dan direktori induknya:

atest --test-mapping /path/to/project:postsubmit

Jalankan pengujian jalur utama pada file TEST_MAPPING di /path/to/project dan direktori induknya:

atest --test-mapping /path/to/project:mainline-presubmit

Jalankan tes di subdirektori

Secara default, Atest hanya mencari pengujian di file TEST_MAPPING ke atas (dari direktori saat ini atau direktori tertentu ke direktori induknya). Jika Anda juga ingin menjalankan pengujian pada file TEST_MAPPING di subdirektori, gunakan --include-subdirs untuk memaksa Atest menyertakan pengujian tersebut juga:

atest --include-subdirs /path/to/project

Jalankan tes dalam iterasi

Jalankan pengujian dalam iterasi dengan meneruskan argumen --iterations . Baik lolos atau gagal, Atest akan mengulangi pengujian hingga iterasi maksimal tercapai.

Contoh:

Secara default, Atest mengulangi 10 kali. Jumlah iterasi harus berupa bilangan bulat positif.

atest test-to-run --iterations
atest test-to-run --iterations 5

Pendekatan berikut mempermudah pendeteksian tes yang tidak stabil:

Pendekatan 1: Jalankan semua pengujian hingga terjadi kegagalan atau iterasi maksimal tercapai.

  • Berhenti ketika terjadi kegagalan atau iterasi mencapai putaran ke-10 (secara default).
    atest test-to-run --rerun-until-failure
    
  • Berhenti ketika terjadi kegagalan atau iterasi mencapai putaran ke-100.
    atest test-to-run --rerun-until-failure 100
    

Pendekatan 2: Jalankan hanya pengujian yang gagal hingga lulus atau iterasi maksimal tercapai.

  • Asumsikan test-to-run memiliki beberapa kasus pengujian dan salah satu pengujian gagal. Jalankan pengujian yang gagal hanya sebanyak 10 kali (secara default) atau hingga pengujian berhasil.
    atest test-to-run --retry-any-failure
    
  • Hentikan menjalankan tes yang gagal ketika lolos atau mencapai putaran ke-100.
    atest test-to-run --retry-any-failure 100
    

Jalankan tes pada AVD

Atest dapat menjalankan tes pada AVD yang baru dibuat. Jalankan acloud create untuk membuat AVD dan membuat artefak, lalu gunakan contoh berikut untuk menjalankan pengujian Anda.

Mulai AVD dan jalankan tes padanya:

acloud create --local-instance --local-image && atest test-to-run

Mulai AVD sebagai bagian dari uji coba:

atest test-to-run --acloud-create "--local-instance --local-image"

Untuk informasi lebih lanjut, jalankan acloud create --help .

Berikan opsi ke modul

Atest dapat memberikan opsi untuk menguji modul. Untuk menambahkan opsi baris perintah TradeFed ke pengujian Anda, gunakan struktur berikut dan pastikan argumen khusus Anda mengikuti format opsi baris perintah Tradefed.

atest test-to-run -- [CUSTOM_ARGS]

Lulus opsi modul pengujian ke pembuat target atau pelari pengujian yang ditentukan dalam file konfigurasi pengujian:

atest test-to-run -- --module-arg module-name:option-name:option-value
atest GtsPermissionTestCases -- --module-arg GtsPermissionTestCases:ignore-business-logic-failure:true

Meneruskan opsi ke jenis atau kelas pelari:

atest test-to-run -- --test-arg test-class:option-name:option-value
atest CtsVideoTestCases -- --test-arg com.android.tradefed.testtype.JarHosttest:collect-tests-only:true

Untuk informasi selengkapnya tentang opsi pengujian saja, lihat Meneruskan opsi ke modul .