1. Ringkasan
Dalam codelab ini, Anda akan mempelajari cara mendistribusikan rilis Android App Bundle kepada penguji menggunakan Firebase App Distribution dan plugin Gradle-nya. App Distribution menyediakan hub terpusat bagi Anda untuk mengelola versi pra-rilis aplikasi dan penguji yang Anda undang ke setiap rilis.
Yang akan Anda pelajari
- Cara menautkan aplikasi Firebase ke Google Play
- Cara memaketkan dan mem-build aplikasi sebagai app bundle
- Cara membuat rilis dan membagikannya kepada penguji live
- Cara mendownload dan menguji rilis baru sebagai penguji
Yang Anda butuhkan
- Android Studio versi terbaru
- File paket yang ditandatangani yang Anda buat dari Android Studio
- Akun developer Google Play tempat Anda adalah Pemilik atau Adminnya
- Aplikasi Anda di Google Play disiapkan di dasbor aplikasi Google Play, dan memiliki status berikut:
- Aplikasi didistribusikan ke salah satu jalur Google Play (Pengujian internal, Pengujian tertutup, Pengujian terbuka, atau Produksi).
- Peninjauan aplikasi di Google Play selesai dan aplikasi sudah dipublikasikan. Aplikasi Anda dianggap sudah dipublikasikan jika kolom Status aplikasi menampilkan salah satu status berikut: Pengujian internal (bukan Draf pengujian internal), Pengujian tertutup, Pengujian terbuka, atau Produksi.
- Alamat email yang dapat Anda gunakan sebagai penguji untuk menerima undangan build baru dari Firebase
2. Membuat project Firebase
- Login ke Firebase.
- Di Firebase console, klik Tambahkan Project, lalu beri nama project Anda "AppBundlesCodelab". Ingat Project ID untuk project Firebase Anda. Jika Anda tidak mengedit Project ID, Firebase akan otomatis menetapkan ID unik untuk project Anda.
- (Opsional) Jika diminta, aktifkan Google Analytics.
- Selesaikan langkah-langkah lainnya, lalu klik Create project.
Menambahkan app bundle ke project
- Di Firebase console, klik Tambahkan aplikasi.
- Saat mendaftarkan aplikasi, pastikan untuk menggunakan nama paket yang sama dengan aplikasi yang diupload ke akun developer Google Play Anda. Terakhir, klik Register app.
- Selesaikan langkah-langkah lainnya untuk menambahkan file konfigurasi Firebase aplikasi (
google-services.json
) ke aplikasi Anda. Perhatikan bahwa untuk Android, App Distribution tidak memiliki Firebase SDK untuk ditambahkan ke aplikasi Anda. - Klik Lanjutkan ke konsol.
Tautkan ke Google Play
- Di Firebase console, buka Project settings.
- Di tab Integrations, klik Link di kartu Google Play.
- Ikuti petunjuk di layar untuk mengaktifkan integrasi App Distribution, lalu pilih aplikasi Firebase yang baru Anda buat untuk ditautkan ke Google Play.
Setelah Anda menyelesaikan langkah-langkah ini, aplikasi Firebase akan ditautkan ke aplikasi Anda di akun developer Google Play selama nama paket sesuai.
3. Menambahkan App Distribution ke project Anda
Menambahkan plugin Gradle App Distribution
Sekarang, Anda akan menggunakan Android Studio untuk menambahkan App Distribution dan plugin Gradle-nya ke aplikasi Anda.
- Di file Gradle level project (
android/build.gradle.kts
), tambahkan plugin App Distribution Gradle ke blokplugins
.plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false }
- Di file Settings Gradle level project Anda (
android/settings.gradle.kts
), tambahkan repositori Maven Google ke blokpluginManagement
.pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } }
- Dalam file Gradle level aplikasi (
android/app/build.gradle.kts
), tambahkan plugin App Distribution ke blokplugins
.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- Jika Anda menggunakan proxy atau Firewall perusahaan, tambahkan properti sistem Java berikut yang memungkinkan App Distribution mengupload distribusi Anda ke Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Mengautentikasi project Firebase
Sebelum dapat menggunakan plugin Gradle, Anda harus mengautentikasi project Firebase. Untuk codelab ini, Anda akan login ke akun Google menggunakan Firebase CLI.
Jalankan perintah berikut di root project Android Anda:
~/your-android-project$ firebase login
Dokumentasi referensi berisi detail lebih lanjut.
4. Mengonfigurasi properti paket di Android Studio
Pada langkah ini, Anda akan menambahkan diri Anda sebagai penguji untuk build yang akan didistribusikan nanti. Setelah Anda mendistribusikan build, penguji akan menerima notifikasi email dari Firebase yang mengundang mereka untuk menguji build baru.
Di app/build.gradle.kts
, tambahkan bagian firebaseAppDistribution
dan sertakan parameter berikut:
appID
: ID Aplikasi Firebase aplikasi Anda. Anda dapat menemukannya di tab Umum pada Setelan project.artifactType
: Jenis file aplikasi Anda (AAB
).testers
: Penguji Anda alamat email Anda. Untuk codelab ini, tambahkan email Anda sendiri agar dapat menguji build setelah didistribusikan.
Contoh:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
Sebagai opsi, Anda juga dapat mengganti nilai yang ditetapkan dalam build.gradle.kts
dengan meneruskan argumen command line dalam bentuk -PappDistribution-property-name=property-value
.
5. Mem-build dan mendistribusikan rilis
- Jalankan tugas Gradle
bundleVariant
untuk membangun file app bundle Anda:$ ./gradlew :base:bundleRelease
- Temukan paket di direktori build aplikasi Anda (lokasi defaultnya adalah
app/build/outputs/bundle/release
). - Untuk mendistribusikan rilis, build target
bundleRelease
danappDistributionUploadRelease
dengan wrapper Gradle project Anda. Sertakan token Firebase (yang Anda terima di langkah 3: Tambahkan App Distribution ke aplikasi Anda).export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
Penguji kini akan menerima undangan email untuk mendownload dan menguji build. Sebagai developer, Anda kini dapat memantau build di tab Rilis pada dasbor App Distribution.
6. Mendownload dan menguji rilis
Di bagian ini, Anda akan disiapkan sebagai penguji untuk mendownload rilis yang Anda distribusikan. Sebagai penguji, Anda harus mengautentikasi perangkat pengujian dan mengaktifkan berbagi aplikasi secara internal di aplikasi Google Play Store.
- Di perangkat pengujian, login ke akun email penguji dan buka undangan dari Firebase.
- Login dengan Akun Google Anda dan terima undangan untuk menguji rilis yang didistribusikan. Sebagai opsi, Anda juga dapat mendownload Firebase App Tester, yang mencegah rilis yang didownload ditambahkan ke folder
Downloads
perangkat Anda. Halaman ini juga menampilkan informasi tambahan tentang rilis, seperti progres download dan versi rilis. - Ketuk Download pada rilis untuk menginstalnya dari Play Store.
- Jika diminta, selesaikan langkah-langkah lainnya untuk mengaktifkan fitur berbagi aplikasi internal (petunjuk ditampilkan di perangkat pengujian dan hanya perlu diselesaikan satu kali).
Setelah download selesai, rilis akan otomatis muncul sebagai pintasan di layar utama perangkat Anda.
7. Selamat!
Anda baru saja menggunakan Firebase App Distribution untuk mengupload app bundle dan mendistribusikan rilis kepada penguji.
Langkah berikutnya
- Buka dokumentasi App Distribution untuk mempelajari lebih lanjut cara mengelola penguji untuk rilis Anda.
- Lihat Membuat dan menguji Android App Bundle untuk mengetahui informasi tentang alat lain yang dapat digunakan untuk men-deploy aplikasi.