Mendistribusikan rilis app bundle ke penguji - Codelab

1. Ikhtisar

gambar10.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 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 membangun aplikasi Anda sebagai app bundle
  • Cara membuat rilis dan membagikannya dengan penguji langsung
  • Cara mengunduh dan menguji rilis baru sebagai penguji

Apa yang Anda perlukan

  • 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 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 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

  1. Masuk ke Firebase .
  2. Di Firebase console, klik Tambahkan Proyek , lalu beri nama proyek Anda "AppBundlesCodelab". Ingat ID Proyek untuk proyek Firebase Anda. Jika Anda tidak mengedit ID Proyek, Firebase secara otomatis memberikan ID unik untuk proyek Anda.

    gambar8.png
  3. (Opsional) Saat diminta, aktifkan Google Analytics.
  4. Selesaikan langkah selanjutnya, lalu klik Buat proyek .

Tambahkan app bundle Anda ke proyek

  1. Di Firebase console, klik Tambahkan aplikasi .

    gambar5.png
  2. 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 .
  3. Selesaikan langkah selanjutnya untuk menambahkan file konfigurasi Firebase aplikasi Anda ( google-services.json ) ke aplikasi Anda. Perlu diperhatikan bahwa untuk Android, App Distribution tidak memiliki Firebase SDK untuk ditambahkan ke aplikasi Anda.
  4. Klik Lanjutkan ke konsol .
  1. Di Firebase console, buka Pengaturan proyek Anda.

    gambar2.png
  2. Di tab Integrasi , klik Tautan di kartu Google Play .
  3. 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 Anda akan ditautkan ke aplikasi Anda di akun pengembang Google Play selama nama paket aplikasinya cocok.

3. Tambahkan Distribusi Aplikasi ke proyek Anda

Tambahkan plugin App Distribution Gradle

Sekarang, Anda akan menggunakan Android Studio untuk menambahkan App Distribution dan plugin Gradle-nya ke aplikasi Anda.

  1. Di file Gradle tingkat proyek Anda ( 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
    }
    
  2. Di file Settings Gradle tingkat proyek 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()
         }
     }
    
  3. Di file Gradle tingkat aplikasi Anda ( 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 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
    

Autentikasi proyek Firebase Anda

Sebelum dapat menggunakan plugin Gradle, Anda harus mengautentikasi proyek Firebase Anda. Untuk codelab ini, Anda akan login ke akun Google Anda menggunakan Firebase CLI .

Jalankan perintah berikut di root proyek Android Anda:

~/your-android-project$ firebase login

Dokumentasi referensi berisi rincian lebih lanjut.

4. Konfigurasikan properti bundel Anda 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 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 pengaturan Proyek Anda.
  • artifactType : Jenis file aplikasi Anda ( AAB ).
  • testers : Alamat email penguji Anda. Untuk codelab ini, tambahkan email Anda sendiri sehingga Anda dapat menguji build Anda 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 dapat mengganti nilai yang ditetapkan di build.gradle.kts dengan meneruskan argumen baris perintah dalam bentuk -PappDistribution- property-name = property-value .

5. Membangun dan mendistribusikan rilis

  1. Jalankan tugas bundle Variant Gradle untuk membuat file bundel aplikasi Anda:
    $ ./gradlew :base:bundleRelease
    
  2. Temukan bundel di direktori build aplikasi Anda (lokasi defaultnya adalah app/build/outputs/bundle/release ).
  3. Untuk mendistribusikan rilis, buat target bundleRelease dan appDistributionUploadRelease dengan wrapper Gradle proyek Anda. Sertakan token Firebase (yang Anda terima pada langkah 3: Tambahkan Distribusi Aplikasi 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 mengunduh dan menguji build. Sebagai pengembang, Anda kini dapat memantau build di tab Rilis di dasbor Distribusi Aplikasi.

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 internal di aplikasi Google Play Store.

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

    gambar6.png
  2. Masuk dengan akun Google Anda dan terima undangan untuk menguji rilis terdistribusi. Sebagai opsi, Anda juga dapat mendownload Firebase App Tester , yang mencegah rilis yang didownload ditambahkan ke folder Downloads di perangkat Anda. Ini juga menampilkan informasi tambahan tentang rilis, seperti kemajuan pengunduhan dan versi rilis.

    gambar9.png
  3. Ketuk Unduh pada rilis untuk menginstalnya dari Play Store.
  4. Jika diminta, selesaikan langkah selanjutnya untuk mengaktifkan berbagi aplikasi internal (instruksi ditampilkan di perangkat pengujian Anda dan hanya perlu diselesaikan satu kali).

Setelah pengunduhan selesai, rilis Anda akan otomatis muncul sebagai pintasan di layar beranda perangkat Anda.

7. Selamat!

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

Langkah selanjutnya