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 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 Anda ke Google Play
  • Cara mengemas dan membangun aplikasi sebagai app bundle
  • Cara membuat rilis dan membagikannya kepada penguji aktif
  • Cara mendownload dan menguji rilis baru sebagai penguji

Yang Anda butuhkan

  • Versi Android Studio terbaru
  • File bundle bertanda tangan 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 yang tersisa, lalu klik Buat project.

Tambahkan app bundle Anda ke project

  1. Di Firebase console, klik Tambahkan aplikasi.

    image5.png
  2. Saat mendaftarkan aplikasi, pastikan Anda menggunakan nama paket yang sama dengan aplikasi yang diupload ke akun developer Google Play Anda. Terakhir, klik Register app.
  3. Selesaikan langkah-langkah yang tersisa untuk menambahkan file konfigurasi Firebase (google-services.json) aplikasi Anda ke aplikasi. 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 Anda menyelesaikan langkah-langkah ini, aplikasi Firebase Anda akan ditautkan ke aplikasi Anda di akun developer Google Play Anda 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 Anda.

  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

Lakukan autentikasi project Firebase Anda

Sebelum 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 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 Anda distribusikan 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 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

  1. Jalankan tugas Gradle bundleVariant untuk membuat file paket aplikasi 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: 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 menyiapkan diri 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 Anda 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 Anda. Panel 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. Saat diminta, selesaikan langkah-langkah selanjutnya untuk mengaktifkan fitur berbagi aplikasi internal (petunjuknya ditampilkan di perangkat pengujian Anda dan hanya perlu diselesaikan satu kali).

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