Pengujian instrumentasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Pertama, baca Menguji aplikasi Anda di developer.android.com. Perhatikan bahwa ada beberapa perbedaan dalam cara uji instrumentasi digunakan dalam pengujian platform.

Singkatnya, uji instrumentasi menyediakan lingkungan eksekusi pengujian khusus seperti yang diluncurkan melalui perintah am instrument, tempat proses aplikasi yang ditargetkan dimulai ulang dan diinisialisasi dengan konteks aplikasi dasar, dan thread instrumentasi dimulai di dalam VM proses aplikasi. Kode pengujian Anda memulai eksekusi pada thread instrumentasi ini dan dilengkapi dengan instance Instrumentation yang memberikan akses ke konteks aplikasi dan API untuk memanipulasi proses aplikasi yang sedang diuji.

Konsep utama

• instrumentasi harus dideklarasikan dalam paket aplikasi, dengan tag <instrumentation> yang disusun bertingkat di bawah tag <manifest> manifes paket aplikasi.
• manifes paket aplikasi secara teknis dapat berisi beberapa tag <instrumentation>, meskipun biasanya tidak digunakan dengan cara ini.
• setiap <instrumentation> harus berisi:
  • atribut android:name: harus berupa nama subclass Instrumentation yang disertakan dalam aplikasi pengujian, yang biasanya merupakan runner pengujian yang sedang digunakan, misalnya: android.support.test.runner.AndroidJUnitRunner
  • atribut android:targetPackage harus ditentukan. Nilainya harus ditetapkan ke paket aplikasi yang sedang diuji.

Ringkasan langkah

1. Berikut adalah tujuan umum untuk pengujian hermetis terhadap layanan framework:

   frameworks/base/core/tests/coretests
   frameworks/base/services/tests/servicestests
   

   Jika Anda menambahkan modul instrumentasi baru untuk komponen, lihat

   • Pengujian Instrumentasi Mandiri: Contoh Lengkap
   • Instrumentasi yang Menargetkan Aplikasi: Contoh Lengkap

2. Ikuti konvensi yang ada jika Anda menambahkan pengujian ke salah satu lokasi di atas. Jika Anda menyiapkan modul pengujian baru, ikuti penyiapan AndroidManifest.xml dan Android.mk di salah satu lokasi di atas

3. Lihat frameworks/base/core/tests/coretests/ untuk mengetahui contohnya. Perhatikan bahwa baris ini menginstal aplikasi tambahan:

   <option name="test-file-name" value="FrameworksCoreTests.apk" />
   <option name="test-file-name" value="BstatsTestApp.apk" />
   

4. Jangan lupa untuk menandai pengujian Anda sebagai @SmallTest, @MediumTest, atau @LargeTest

5. Build modul pengujian dengan m, misalnya:

   m FrameworksCoreTests
   

6. Jalankan pengujian:

   • Solusi yang paling sederhana adalah menggunakan Atest seperti ini:

     atest FrameworksCoreTests
     

   • Atau untuk pengujian yang lebih kompleks, gunakan Harness pengujian Trade Federation:

   m tradefed-all
   tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
   

7. Jika tidak menggunakan Tradefed, instal dan jalankan pengujian secara manual:

   1. Instal apk yang dihasilkan:

   adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
   

   1. Jalankan pengujian dengan berbagai opsi:

      1. semua pengujian dalam apk

         adb shell am instrument -w com.android.frameworks.coretests\
           /android.support.test.runner.AndroidJUnitRunner
         

      2. semua pengujian dalam paket Java tertentu

         adb shell am instrument -w -e package android.animation \
           com.android.frameworks.coretests\
           /android.support.test.runner.AndroidJUnitRunner
         

      3. semua pengujian dalam class tertentu

         adb shell am instrument -w -e class \
           android.animation.AnimatorSetEventsTest \
           com.android.frameworks.coretests\
           /android.support.test.runner.AndroidJUnitRunner
         

      4. metode pengujian tertentu

         adb shell am instrument -w -e class \
           android.animation.AnimatorSetEventsTest#testCancel \
           com.android.frameworks.coretests\
           /android.support.test.runner.AndroidJUnitRunner
         

Pengujian Anda dapat membuat pernyataan eksplisit tentang lulus atau gagal menggunakan JUnit API; selain itu, pengecualian yang tidak tertangkap juga akan menyebabkan kegagalan fungsional.

Untuk menampilkan metrik performa, kode pengujian Anda dapat memanggil Instrumentation#sendStatus untuk mengirim daftar key-value pair. Penting untuk diperhatikan bahwa:

1. metrik dapat berupa bilangan bulat atau floating point
2. nilai non-numerik apa pun akan dihapus
3. APK pengujian Anda dapat berupa pengujian fungsional atau pengujian metrik, tetapi penggabungan keduanya saat ini tidak didukung