Halaman ini diterjemahkan oleh Cloud Translation API.

Mendistribusikan rilis app bundle kepada penguji - Codelab

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 pusat untuk mengelola versi pra-rilis aplikasi Anda dan penguji yang diundang ke setiap rilis.

Yang akan Anda pelajari

Cara menautkan aplikasi Firebase ke Google Play
Cara mengemas dan membangun aplikasi sebagai app bundle
Cara membuat rilis dan membagikannya kepada penguji langsung
Cara mendownload dan menguji rilis baru sebagai penguji

Yang Anda butuhkan

Android Studio versi terbaru
File paket bertanda tangan 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 akan 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 Add 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) Saat diminta, aktifkan Google Analytics.
Selesaikan langkah-langkah yang tersisa, lalu klik Buat project.

Tambahkan app bundle Anda ke project

Di Firebase console, klik Add app.
Saat mendaftarkan aplikasi, pastikan Anda menggunakan nama paket yang sama dengan aplikasi yang diupload ke akun developer Google Play Anda.
Catatan: Nama paket yang sama diperlukan untuk menautkan aplikasi Firebase Anda dengan akun developer Google Play, yang akan Anda lakukan di bagian berikutnya.

Terakhir, klik Register app.
Selesaikan langkah-langkah yang tersisa 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.

Menautkan 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 aplikasi tersebut cocok.

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 blok plugins.

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 blok pluginManagement.

 pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }

Di file Gradle level aplikasi (android/app/build.gradle.kts), tambahkan plugin App Distribution ke blok plugins.

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 General pada Project settings.
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.

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. Membangun 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 dan appDistributionUploadRelease 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 di dasbor App Distribution.

6. Mendownload dan menguji rilis Anda

Di bagian ini, Anda akan disiapkan sebagai penguji untuk mendownload rilis yang Anda distribusikan. Sebagai penguji, Anda harus mengautentikasi perangkat pengujian dan mengaktifkan fitur berbagi aplikasi 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 sekali).

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.