Mendistribusikan rilis app bundle kepada penguji - Codelab

1. Ringkasan

image10.png

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

  • Versi Android Studio terbaru
  • File paket yang ditandatangani yang Anda buat dari Android Studio
  • Akun developer Google Play yang Anda miliki sebagai Pemilik atau Admin
  • 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

  1. Login ke Firebase.
  2. 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.

    image8.png
  3. (Opsional) Jika diminta, aktifkan Google Analytics.
  4. Selesaikan langkah-langkah lainnya, lalu klik Buat project.

Menambahkan app bundle ke project

  1. Di Firebase console, klik Tambahkan aplikasi.

    image5.png
  2. Saat mendaftarkan aplikasi, pastikan untuk menggunakan nama paket yang sama dengan aplikasi yang diupload ke akun developer Google Play Anda. Terakhir, klik Register app.
  3. 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.
  4. Klik Lanjutkan ke konsol.
  1. Di Firebase console, buka Project settings.

    image2.png
  2. Di tab Integrasi, klik Tautkan di kartu Google Play.
  3. Ikuti petunjuk di layar untuk mengaktifkan integrasi App Distribution, lalu pilih aplikasi Firebase yang baru dibuat untuk ditautkan ke Google Play.

Setelah menyelesaikan langkah-langkah ini, aplikasi Firebase Anda akan ditautkan ke aplikasi Anda di akun developer Google Play selama nama paket aplikasi 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.

  1. Dalam file Gradle level project (android/build.gradle.kts), tambahkan plugin Gradle App Distribution ke blok plugins.
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. 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()
     }
 }
  3. Dalam 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")
}
  4. Jika Anda menggunakan proxy atau Firewall perusahaan, tambahkan properti sistem Java berikut yang memungkinkan App Distribution untuk mengupload distribusi ke Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Melakukan autentikasi 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 selengkapnya.

4. Mengonfigurasi properti paket di Android Studio

Pada langkah ini, Anda akan menambahkan diri 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, 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 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

  1. Jalankan tugas Gradle bundleVariant untuk mem-build file app bundle Anda:
    $ ./gradlew :base:bundleRelease
  2. Temukan paket di direktori build aplikasi Anda (lokasi defaultnya adalah app/build/outputs/bundle/release).
  3. Untuk mendistribusikan rilis, build target bundleRelease dan appDistributionUploadRelease dengan wrapper Gradle project Anda. Sertakan token Firebase (yang Anda terima di langkah 3: Menambahkan App Distribution ke aplikasi).
    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.

  1. Di perangkat pengujian, login ke akun email penguji dan buka undangan dari Firebase.

    image6.png
  2. 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, seperti progres download dan versi rilis.

    image9.png
  3. Ketuk Download pada rilis untuk menginstalnya dari Play Store.
  4. 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 Anda akan otomatis muncul sebagai pintasan di layar utama perangkat.

7. Selamat!

Anda baru saja menggunakan Firebase App Distribution untuk mengupload app bundle dan mendistribusikan rilis kepada penguji.

Langkah berikutnya