Menyertakan pengujian unit dan fungsional

Bagian ini menjelaskan cara menjalankan dan berkontribusi pada pengujian Trade Federation setelah membuat perubahan pada project. Hal ini mencakup:

  • Tempat menambahkan class pengujian unit baru
  • Menjalankan pengujian unit di Eclipse dan di luar Eclipse IDE
  • Tempat menambahkan uji fungsional
  • Menjalankan pengujian fungsional
  • Menjalankan beberapa validasi pra-pengiriman TF secara lokal

Menambahkan pengujian unit

Di Proyek Open Source Android (AOSP), tambahkan class pengujian unit di: tools/tradefederation/core/tests/src/com/android/tradefed/UnitTests.java

PENTING: Menambahkan class pengujian unit baru ke lokasi ini akan menyebabkan class tersebut otomatis berjalan di pra-pengiriman tanpa penyiapan tambahan.

Menjalankan pengujian unit

Semua pengujian unit AOSP dan pengujian fungsional untuk Trade Federation terletak di project tools/tradefederation/core/tests.

Di dalam Eclipse, untuk menjalankan pengujian unit satu per satu, cukup klik kanan pengujian dan pilih Run As > JUnit. Untuk menjalankan semua pengujian unit, jalankan rangkaian com.android.tradefed.UnitTests.

Anda juga dapat memulai pengujian unit dari command line di hierarki sumber Tradefed setelah membangun, seperti berikut: tools/tradefederation/core/javatests/run_tradefed_tests.sh

Pengujian unit dapat dijalankan secara mandiri, tetapi pengujian fungsional harus dijalankan menggunakan Trade Federation itu sendiri; pengujian ini memerlukan perangkat Android. Semua pengujian fungsional harus mengikuti konvensi penamaan *FuncTest.

Memeriksa hasil pengujian unit

Saat menjalankan run_tradefed_tests.sh, pengujian unit akan menjalankan semua bagian harness pengujian termasuk beberapa kondisi error. Tindakan ini akan mencetak output panjang ke konsol, termasuk pelacakan tumpukan.

Ringkasan akhir dari hasil akan menunjukkan apakah terjadi kegagalan atau tidak.

Contoh ringkasan akhir di konsol:

12:55:02 ========== Result Summary ==========
Results summary for test-tag 'TFUnitTests': 3355 Tests [3355 Passed]

Semua pengujian dipertahankan agar lulus, jadi jika terjadi kegagalan pada perubahan lokal Anda, pastikan pengujian telah diperbaiki.

Menambahkan pengujian fungsional

  • Jika pengujian fungsional Anda melibatkan perangkat (menggunakan ITestDevice API apa pun), definisi suite terletak di com.android.tradefed.DeviceFuncTests. Jika tidak, definisi suite akan berada di com.android.tradefed.FuncTests.

  • Jika metode pengujian Anda masuk akal untuk dimasukkan ke salah satu sub-class suite yang ada, sebaiknya tambahkan di sana. Jika tidak, Anda dapat menambahkan kelas baru ke suite yang berlaku.

  • Dalam kedua kasus tersebut, dengan menambahkannya ke suite, pengujian Anda akan otomatis dijalankan di pipeline CI dengan pengujian fungsional lainnya.

Menjalankan pengujian fungsional

Untuk menjalankan pengujian fungsional dari Eclipse:

  1. Pastikan perangkat terhubung ke host dan adb serta jika perlu fastboot berada dalam PATH Eclipse. Cara termudah untuk melakukannya adalah dengan meluncurkan Eclipse dari penyiapan shell dengan PATH yang tepat.
  2. Buat aplikasi Java. Jalankan konfigurasi melalui Run > Run configurations.
  3. Tetapkan project ke tradefed-tests dan class utama ke com.android.tradefed.command.CommandRunner.
  4. Jalankan m tradefed-all.
  5. Berikan argumen command line berikut di tab Arguments: host --class <full path of test class to run>
  6. Klik Run.

Untuk menjalankan pengujian fungsional di luar Eclipse.

  1. Build Trade Federation.
  2. Hubungkan perangkat Android ke host.
  3. Jalankan tools/tradefederation/core/javatests/run_tradefed_func_tests.sh
  4. Atau, pilih perangkat dengan menambahkan --serial <serial no> seperti yang muncul dalam output adb devices.

Menjalankan pengujian pra-pengiriman TF terhadap perubahan lokal

Jika Anda ingin menjalankan dengan cara yang sama seperti pra-pengiriman TF, gunakan ini:

tools/tradefederation/core/javatests/run_tradefed_aosp_presubmit.sh

Tindakan ini akan memicu semua pengujian pra-pengiriman TF terhadap TF yang dibangun secara lokal untuk membantu Anda memvalidasi bahwa perubahan tersebut tidak melanggar pengujian apa pun.

Pengujian pra-pengiriman TF adalah superset dari pengujian unit di atas, tetapi pengujian ini berjalan lebih lambat. Jadi, sebaiknya jalankan pengujian unit selama pengembangan untuk validasi yang lebih cepat dan jalankan pra-pengiriman sebelum mengupload CL.