1. Tinjauan
Dalam codelab ini, Anda akan mempelajari cara mendistribusikan rilis Android App Bundle ke penguji menggunakan Firebase App Distribution dan plugin Gradle-nya. App Distribution menyediakan hub pusat bagi Anda untuk mengelola versi pra-rilis aplikasi Anda dan penguji yang Anda undang ke setiap rilis.
Apa yang akan Anda pelajari
- Cara menautkan aplikasi Firebase Anda ke Google Play
- Cara mengemas dan mem-build aplikasi Anda sebagai app bundle
- Cara membuat rilis dan membagikannya dengan penguji langsung
- Cara mengunduh dan menguji rilis baru sebagai penguji
Apa yang Anda butuhkan
- Versi Android Studio terbaru
- File bundel bertanda tangan yang Anda buat dari Android Studio
- Akun pengembang Google Play yang Anda adalah Pemilik atau Adminnya
- Aplikasi Anda di Google Play disiapkan di dasbor aplikasi Google Play , dan statusnya sebagai berikut :
- Aplikasi didistribusikan ke salah satu jalur Google Play (Pengujian internal, Pengujian tertutup, Pengujian terbuka, atau Produksi).
- Ulasan aplikasi di Google Play selesai dan aplikasi dipublikasikan. Aplikasi Anda dipublikasikan jika kolom Status aplikasi menampilkan salah satu status berikut: Pengujian internal (bukan pengujian internal Draf), Pengujian tertutup, Pengujian terbuka, atau Produksi.
- Alamat email yang dapat Anda gunakan sebagai penguji untuk menerima undangan build baru dari Firebase
2. Buat proyek Firebase
- Masuk ke Firebase .
- Di konsol Firebase, klik Add Project , lalu beri nama proyek Anda "AppBundlesCodelab". Ingat ID Proyek untuk proyek Firebase Anda. Jika Anda tidak mengedit ID Proyek, Firebase secara otomatis menetapkan ID unik untuk proyek Anda.
- (Opsional) Saat diminta, aktifkan Google Analytics.
- Selesaikan langkah-langkah selanjutnya, lalu klik Buat proyek .
Tambahkan bundel aplikasi Anda ke proyek
- Di konsol Firebase, klik Tambahkan aplikasi .
- Saat mendaftarkan aplikasi Anda, pastikan untuk menggunakan nama paket yang sama dengan aplikasi yang diunggah ke akun pengembang Google Play Anda. Terakhir, klik Daftarkan aplikasi .
- Selesaikan langkah selanjutnya untuk menambahkan file konfigurasi Firebase aplikasi Anda (
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 konsol Firebase, buka setelan Proyek Anda.
- Di tab Integrasi , klik Tautkan 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.
Sekarang setelah Anda menyelesaikan langkah-langkah ini, aplikasi Firebase Anda akan ditautkan ke aplikasi Anda di akun developer Google Play selama nama paket aplikasi cocok.
3. Tambahkan Distribusi Aplikasi ke proyek Anda
Tambahkan plugin Gradle Distribusi Aplikasi
Sekarang, Anda akan menggunakan Android Studio untuk menambahkan App Distribution dan plugin Gradle-nya ke aplikasi Anda.
- Di file Gradle tingkat proyek Anda (
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 Gradle Pengaturan tingkat proyek 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() } }
- Di file Gradle level aplikasi Anda (
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 perusahaan atau Firewall, tambahkan properti sistem Java berikut yang memungkinkan App Distribution mengunggah distribusi Anda ke Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Otentikasi proyek Firebase Anda
Sebelum Anda dapat menggunakan plugin Gradle, Anda harus mengautentikasi project Firebase Anda. Untuk codelab ini, Anda akan login ke akun Google menggunakan Firebase CLI .
Jalankan perintah berikut di root proyek Android Anda:
~/your-android-project$ firebase login
Dokumentasi referensi berisi detail lebih lanjut.
4. Konfigurasikan properti bundel Anda di Android Studio
Pada langkah ini, Anda akan menambahkan diri Anda sendiri sebagai penguji untuk bangunan yang akan Anda distribusikan nanti. Setelah Anda mendistribusikan build, penguji mendapatkan 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 pengaturan Proyek Anda. -
artifactType
: Jenis file aplikasi Anda (AAB
). -
testers
: Alamat email penguji Anda. Untuk codelab ini, tambahkan email Anda sendiri agar Anda dapat menguji build setelah didistribusikan.
Misalnya:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
Sebagai opsi, Anda juga bisa mengganti nilai yang ditetapkan di build.gradle.kts
dengan meneruskan argumen baris perintah dalam bentuk -PappDistribution- property-name = property-value
.
5. Buat dan distribusikan sebuah rilis
- Jalankan tugas
bundle Variant
Gradle untuk membuat file app bundle Anda:$ ./gradlew :base:bundleRelease
- Temukan bundel di direktori build aplikasi Anda (lokasi defaultnya adalah
app/build/outputs/bundle/release
). - Untuk mendistribusikan rilis, buat target
bundleRelease
danappDistributionUploadRelease
dengan pembungkus Gradle proyek 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 sekarang akan menerima undangan email untuk mendownload dan menguji build. Sebagai developer, kini Anda dapat memantau build di tab Rilis di dasbor App Distribution.
6. Unduh dan uji rilis Anda
Di bagian ini, Anda akan disiapkan sebagai penguji untuk mengunduh 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.
- Masuk dengan akun Google Anda dan terima undangan untuk menguji rilis terdistribusi. Sebagai opsi, Anda juga dapat mengunduh Firebase App Tester , yang mencegah rilis unduhan ditambahkan ke folder
Downloads
perangkat Anda. Itu juga menampilkan informasi tambahan tentang rilis, seperti kemajuan unduhan dan versi rilis. - Ketuk Unduh pada rilis untuk menginstalnya dari Play Store.
- Saat diminta, selesaikan langkah-langkah selanjutnya untuk mengaktifkan berbagi aplikasi internal (petunjuk ditampilkan di perangkat pengujian Anda dan hanya perlu diselesaikan sekali).
Setelah pengunduhan selesai, rilis Anda akan secara 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 ke penguji.
Langkah selanjutnya
- Buka dokumentasi App Distribution untuk mempelajari lebih lanjut tentang cara mengelola penguji untuk rilis Anda.
- Lihat Membangun dan menguji Android App Bundle Anda untuk informasi tentang alat lain yang dapat Anda gunakan untuk menerapkan aplikasi Anda.