Crawler Aplikasi

Gunakan alat Crawler Aplikasi, bagian dari Jetpack, untuk otomatis menguji aplikasi Anda tanpa perlu menulis atau mempertahankan kode apa pun.

Crawler berjalan bersamaan dengan aplikasi Anda, yang otomatis mengeluarkan tindakan (ketuk, geser, dll.) untuk menjelajahi state-space aplikasi. Crawl berhenti otomatis saat tidak ada tindakan unik untuk dilakukan, aplikasi error, atau waktu tunggu yang Anda tentukan tercapai.

Melakukan pengujian dengan crawler mudah karena tidak ada kode untuk ditulis atau dipertahankan. Selain itu, Anda dapat menjalankan pengujian di berbagai perangkat untuk mencari error, masalah visual, atau masalah performa. Secara umum, sebaiknya gunakan layanan berbasis cloud seperti Firebase Test Lab untuk menguji beberapa kombinasi ukuran layar dan konfigurasi hardware dengan lebih mudah dan cepat.

Target audiens

Crawler Aplikasi ditargetkan untuk developer yang ingin memastikan fungsionalitas dasar aplikasi mereka dengan konfigurasi minimal. Selain untuk pengujian opaque-box saja, crawler juga dapat dikonfigurasi untuk memberikan input tertentu, seperti kredensial login atau deep link.

Memulai

Sebelum memulai, pastikan Anda memiliki Android SDK versi terbaru. Android SDK dilengkapi dengan Android Studio. Jika Anda menginstal Android SDK mandiri, pastikan untuk menyertakan alat build dan alat platform terbaru.

Kemudian, download arsip biner crawler.

Selanjutnya, jalankan emulator atau hubungkan perangkat fisik menggunakan kabel USB. Konfirmasikan perangkat telah terhubung dengan menjalankan perintah berikut:

adb devices

Untuk memanggil crawler, ekstrak arsip terlebih dahulu ke direktori pilihan Anda. Dari direktori tersebut, aktifkan crawler dengan menggunakan perintah berikut:

java -jar crawl_launcher.jar --apk-file path/to/my/app.apk --android-sdk path/to/my/android/sdk

Opsi crawler

Anda dapat menggunakan opsi berikut untuk memanggil crawler:

Opsi Deskripsi
--android-sdk path

Menentukan jalur ke Android SDK Anda.

Flag ini adalah wajib.
--apk-file file

Menentukan jalur ke APK aplikasi Anda, yang kemudian diinstal dan di-crawl oleh Crawler Aplikasi.

Flag ini wajib jika --app-package-name tidak ditentukan.
--app-package-name name

Menentukan nama paket aplikasi. Gunakan opsi ini saat aplikasi sudah diinstal di perangkat dan tidak memerlukan penginstalan ulang.

Flag ini wajib jika --apk-file tidak ditentukan.
--key-store path

Menentukan jalur ke keystore yang menandatangani aplikasi dan crawler APK Anda. Gunakan opsi ini saat aplikasi memerlukan tanda tangan spesifik agar berfungsi dengan benar.
--key-store-password password

Menentukan sandi untuk keystore yang Anda berikan untuk opsi --key-store.

Flag ini wajib jika --key-store ditentukan.
--timeout-sec timeout

Menentukan waktu tunggu untuk crawl Anda dalam hitungan detik. Jika tidak ditentukan, crawl akan berhenti setelah 60 detik.

Masalah umum

Gagal menghapus file tanda tangan asli

Sebelum menggunakan crawl, pengguna JDK 9 mungkin akan melihat pesan error ini:

androidx.test.tools.crawler.launcher.exceptions.ApkSigningException: Failed to delete original signature files

Jika Anda mengalami perilaku ini, sebaiknya gunakan JDK 8 atau 10+. Untuk informasi lebih lanjut tentang masalah ini, lihat bug JDK 9. Beberapa pengguna telah memperbaiki masalah dengan mem-build ulang APK mereka menggunakan Android Studio versi terbaru.

Referensi lainnya

Untuk informasi penggunaan Crawler Aplikasi selengkapnya, lihat referensi berikut.