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 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 langsung
Cara mendownload dan menguji rilis baru sebagai penguji

Yang Anda butuhkan

Versi Android Studio terbaru
File paket bertanda tangan yang Anda hasilkan dari Android Studio
Akun developer Google Play tempat Anda menjadi 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 Tambahkan Project, lalu beri nama project "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 yang tersisa, lalu klik Buat project.

Menambahkan app bundle ke project

Di Firebase console, klik Tambahkan aplikasi.
Saat mendaftarkan aplikasi, pastikan Anda menggunakan nama paket yang sama dengan aplikasi yang diupload ke akun developer Google Play.
Catatan: Perlu nama paket yang sama untuk menautkan aplikasi Firebase dengan akun developer Google Play, yang akan Anda lakukan di bagian selanjutnya.

Terakhir, klik Register app.
Selesaikan langkah-langkah yang tersisa untuk menambahkan file konfigurasi Firebase aplikasi Anda (google-services.json) ke aplikasi. 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 dibuat untuk ditautkan ke Google Play.

Setelah Anda menyelesaikan langkah-langkah ini, aplikasi Firebase Anda akan ditautkan ke aplikasi di akun developer Google Play, asalkan nama paket aplikasi tersebut cocok.

3. Menambahkan App Distribution ke project Anda

Menambahkan plugin App Distribution Gradle

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 Gradle Setelan level project (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 harus login ke Akun Google menggunakan Firebase CLI.

Jalankan perintah berikut di root project Android Anda:

~/your-android-project$ firebase login

Dokumentasi referensi berisi detail selengkapnya.

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 mendapatkan notifikasi email dari Firebase yang mengundang mereka untuk menguji build baru.

Di app/build.gradle.kts Anda, 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: Alamat email penguji Anda. Untuk codelab ini, tambahkan email Anda sendiri sehingga 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 di 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 membuat file app bundle:
```
$ ./gradlew :base:bundleRelease
```
Cari paket di direktori build aplikasi (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 pada 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, Anda kini dapat memantau build di tab Rilis pada dasbor App Distribution.

6. Download dan uji rilis Anda

Di bagian ini, Anda akan disiapkan sebagai penguji agar dapat mendownload rilis yang telah didistribusikan. 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. Halaman ini juga menampilkan informasi tambahan tentang rilis, misalnya progres download dan versi rilis.
Ketuk Download pada rilis untuk menginstalnya dari Play Store.
Jika diminta, selesaikan langkah-langkah yang tersisa untuk mengaktifkan fitur berbagi aplikasi internal (petunjuk akan ditampilkan di perangkat pengujian dan hanya perlu diselesaikan sekali).

Setelah download selesai, rilis Anda 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 Anda gunakan untuk men-deploy aplikasi.