Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Tes Instrumentasi

Pertama baca Uji aplikasi Anda di developer.android.com. Perhatikan ada beberapa perbedaan dalam cara pengujian instrumentasi digunakan dalam pengujian platform.

Singkatnya, pengujian instrumentasi menyediakan lingkungan eksekusi pengujian khusus seperti yang diluncurkan melalui perintah am instrument , di mana 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 utas instrumentasi ini dan dilengkapi dengan instance Instrumentation yang menyediakan akses ke konteks aplikasi dan API untuk memanipulasi proses aplikasi yang sedang diuji.

Konsep kunci

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

Ringkasan langkah-langkah

  1. Di bawah ini adalah tujuan umum untuk pengujian kedap udara terhadap layanan kerangka kerja:

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

    Jika Anda menambahkan modul instrumentasi baru untuk komponen Anda, lihat

  2. Mengikuti konvensi yang ada jika Anda menambahkan tes 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 contoh. Perhatikan 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 tes Anda sebagai @SmallTest , @MediumTest atau @LargeTest

  5. Bangun modul pengujian dengan m, misalnya:

    m FrameworksCoreTests
    
  6. Jalankan tes:

    • Solusi paling sederhana adalah dengan menggunakan Atest seperti:

      atest FrameworksCoreTests
      
    • Atau untuk tes yang lebih kompleks, gunakan uji Trade Federation Harness :

    m tradefed-all
    tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
    
  7. Jika tidak menggunakan Tradefed, instal dan jalankan tes secara manual:

    1. Instal apk yang dihasilkan:
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
    

    Tip: Anda menggunakan adb shell pm list instrumentation untuk menemukan instrumentasi di dalam apk yang baru saja diinstal

    1. Jalankan tes dengan berbagai opsi:

      1. semua tes di apk

        adb shell am instrument -w com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      2. semua tes di bawah paket Java tertentu

        adb shell am instrument -w -e package android.animation \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      3. semua tes di bawah kelas tertentu

        adb shell am instrument -w -e class \
          android.animation.AnimatorSetEventsTest \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      4. metode tes 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 API JUnit ; selain itu, pengecualian yang tidak tertangkap juga akan menyebabkan kegagalan fungsional.

Untuk memancarkan metrik performa, kode pengujian Anda dapat memanggil Instrumentation#sendStatus untuk mengirimkan daftar pasangan nilai kunci. Penting untuk dicatat bahwa:

  1. metrik dapat berupa bilangan bulat atau titik mengambang
  2. nilai non-numerik apa pun akan dibuang
  3. apk pengujian Anda dapat berupa tes fungsional atau tes metrik, namun pencampuran keduanya saat ini tidak didukung