Panduan ini menjelaskan cara mendistribusikan APK kepada penguji menggunakan Firebase CLI. Alat CLI memungkinkan Anda memilih penguji dan catatan rilis untuk build, lalu mendistribusikan build tersebut dengan sesuai.
Sebelum memulai
Tambahkan Firebase ke project Android jika belum melakukannya.
Jika tidak menggunakan produk Firebase lainnya, Anda hanya perlu membuat project dan mendaftarkan aplikasi. Namun, jika memutuskan untuk menggunakan produk tambahan di masa mendatang, pastikan untuk menyelesaikan semua langkah di halaman yang tertaut di atas.
Langkah 1. Build aplikasi Anda
Saat sudah siap untuk mendistribusikan versi pra-rilis aplikasi kepada penguji, build APK menggunakan proses normal. Anda harus menandatangani APK dengan kunci debug atau kunci penandatanganan aplikasi.
Langkah 2. Distribusikan aplikasi kepada penguji
Untuk mendistribusikan aplikasi kepada penguji, upload file aplikasi menggunakan Firebase CLI:
- Instal atau update ke versi terbaru Firebase CLI (sebaiknya download biner mandiri untuk CLI khusus untuk OS Anda). Pastikan untuk login dan menguji apakah Anda dapat mengakses project.
- Di halaman App Distribution Firebase console, pilih aplikasi yang akan didistribusikan, lalu klik Mulai.
-
Jalankan perintah
appdistribution:distribute
untuk mengupload aplikasi dan mendistribusikannya kepada penguji. Gunakan parameter berikut untuk mengonfigurasi distribusi:opsi appdistribution:distribute --app
Wajib diisi: ID Aplikasi Firebase aplikasi Anda. Anda dapat menemukan ID Aplikasi di Firebase console, di halaman Setelan Umum.
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Token refresh yang dicetak saat Anda mengautentikasi lingkungan CI dengan Firebase CLI (baca Menggunakan CLI dengan sistem CI untuk mengetahui informasi lebih lanjut).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Catatan rilis untuk build ini.
Anda dapat menentukan catatan rilis secara langsung:
--release-notes "Text of release notes"
Atau, tentukan lokasi ke file teks biasa:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
Alamat email penguji yang ingin Anda undang.
Anda dapat menentukan penguji sebagai daftar alamat email yang dipisahkan dengan koma:
--testers "ali@example.com, bri@example.com, cal@example.com"
Atau, Anda dapat menentukan lokasi ke file teks biasa yang berisi daftar alamat email yang dipisahkan koma:
--testers-file "/path/to/testers.txt"
--groups
--groups-file
Grup penguji yang akan Anda undang (lihat Mengelola penguji). Grup ditentukan menggunakan
alias grup , yang dapat Anda cari di Firebase console.Anda dapat menentukan grup sebagai daftar yang dipisahkan dengan koma:
--groups "qa-team, trusted-testers"
Atau, Anda dapat menentukan jalur ke file teks biasa yang berisi daftar nama grup yang dipisahkan dengan koma:
--groups-file "/path/to/groups.txt"
--debug
Tanda yang dapat Anda sertakan untuk mencetak keluaran log panjang.
Contoh:
firebase appdistribution:distribute test.apk \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
Firebase CLI membuat output link berikut setelah upload rilis. Link ini membantu Anda mengelola biner dan memastikan bahwa penguji serta developer lain memiliki rilis yang tepat:
firebase_console_uri
- Link ke Firebase console yang menampilkan satu rilis. Anda dapat membagikan link ini kepada developer lain di organisasi Anda.testing_uri
- Link ke rilis dalam pengalaman penguji (aplikasi native Android) yang memungkinkan penguji melihat catatan rilis dan menginstal aplikasi ke perangkat mereka. Penguji memerlukan akses ke rilis untuk menggunakan link.binary_download_uri
- Link bertanda tangan yang langsung mendownload dan menginstal biner aplikasi (file APK atau AAB). Masa berlaku link akan berakhir setelah satu jam.
Mengelola penguji dan grup
Selain mendistribusikan rilis, Anda juga dapat menggunakan
appdistribution:testers:add
danappdistribution:testers:remove
untuk mengundang penguji baru atau menghapus penguji yang sudah ada dari project Firebase Anda.Setelah penguji ditambahkan ke project Firebase, Anda dapat menambahkannya ke rilis individual. Setelah Anda menghapus penguji, mereka tidak akan lagi memiliki akses ke rilis di project Anda. Perlu diperhatikan bahwa penguji yang baru saja dihapus masih dapat mempertahankan akses ke rilis Anda selama jangka waktu tertentu.
Contoh:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
Email penguji harus dipisahkan dengan spasi. Anda juga dapat memilih penguji menggunakan
--file /path/to/testers.txt
.Jika memiliki banyak penguji, Anda harus mempertimbangkan untuk menggunakan grup: Anda dapat menggunakan
appdistribution:group:create
danappdistribution:group:delete
untuk membuat atau menghapus grup di project Firebase.Gunakan
--group-alias
untuk menentukan grup bagi perintahappdistribution:testers:add
danappdistribution:testers:remove
.Contoh:
firebase appdistribution:group:create "QA team" qa-team
firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:group:delete qa-team
Setelah didistribusikan, build akan tersedia di dasbor App Distribution di Firebase console selama 150 hari (lima bulan). Saat masa berlaku build akan berakhir dalam 30 hari, notifikasi akhir masa berlakunya akan muncul di konsol dan di daftar build penguji pada perangkat pengujinya.
Penguji yang belum diundang untuk menguji aplikasi akan menerima undangan email untuk memulai, dan penguji yang ada akan menerima notifikasi email bahwa ada versi build baru yang siap diuji (baca panduan penyiapan penguji untuk mengetahui petunjuk cara menginstal aplikasi pengujian). Anda dapat memantau status setiap penguji, apakah mereka sudah menerima undangan dan mendownload aplikasi, di Firebase console.
Penguji memiliki waktu 30 hari untuk menerima undangan pengujian aplikasi sebelum masa berlakunya habis. Saat masa berlaku undangan akan berakhir dalam 5 hari, notifikasi habisnya masa berlaku akan muncul di Firebase console di samping penguji pada rilis. Undangan dapat diperpanjang dengan pengiriman ulang menggunakan menu drop-down pada baris penguji.
Langkah berikutnya
Terapkan masukan dalam aplikasi untuk memudahkan penguji mengirimkan masukan tentang aplikasi Anda (termasuk screenshot).
Pelajari cara menampilkan pemberitahuan dalam aplikasi kepada penguji saat build baru aplikasi sudah tersedia untuk diinstal.
Pelajari praktik terbaik untuk mendistribusikan aplikasi Android ke penguji QA menggunakan CI/CD.