Mendistribusikan rilis app bundle kepada 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 butuhkan?

  • Android Studio v4.0+
  • File bundel bertanda tangan yang Anda buat dari Android Studio
  • Akun pengembang Google Play tempat Anda menjadi Pemilik atau Admin
  • Aplikasi Anda di Google Play disiapkan di dasbor aplikasi Google Play , dan statusnya sebagai berikut:
    • Aplikasi didistribusikan ke salah satu trek 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 menetapkan ID unik untuk proyek Anda.

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

Tambahkan bundel aplikasi Anda ke proyek

  1. Di konsol Firebase, 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 Daftar aplikasi .
  3. Selesaikan langkah selanjutnya untuk menambahkan file konfigurasi Firebase aplikasi Anda ( google-services.json ) ke aplikasi Anda. Perhatikan bahwa untuk Android, App Distribution tidak memiliki SDK Firebase untuk ditambahkan ke aplikasi Anda.
  4. Klik Lanjutkan ke konsol .
  1. Di konsol Firebase, buka setelan Proyek Anda .

    gambar2.png
  2. Di tab Integrasi , klik Tautan pada 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.

Sekarang setelah Anda menyelesaikan langkah-langkah ini, aplikasi Firebase Anda akan ditautkan ke aplikasi Anda di akun pengembang Google Play Anda selama nama paket aplikasi cocok.

3. Tambahkan Distribusi Aplikasi ke proyek Anda

Tambahkan plugin Gradle Distribusi Aplikasi

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

  1. Di file Gradle tingkat proyek Anda ( android/build.gradle ), tambahkan plugin App Distribution Gradle dan repositori Maven Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Di file Gradle tingkat aplikasi Anda ( android/app/build.gradle ), tambahkan plugin Distribusi Aplikasi:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Jika Anda berada di belakang proxy perusahaan atau Firewall, tambahkan properti sistem Java berikut yang memungkinkan App Distribution untuk mengunggah distribusi Anda ke Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Otentikasi proyek Firebase Anda

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

  1. Jalankan perintah berikut di root proyek Android Anda:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Saat perintah mencetak tautan otentikasi, buka di browser. Saat diminta, masuk ke akun Google Anda dan berikan izin untuk mengakses proyek Firebase Anda. Perintah Gradle mencetak token penyegaran, yang digunakan plugin Distribusi Aplikasi untuk mengautentikasi dengan Firebase.
  3. Setel variabel lingkungan FIREBASE_TOKEN ke token dari langkah sebelumnya:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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 Anda, tambahkan bagian firebaseAppDistribution dan sertakan parameter berikut:

  • appID : ID Aplikasi Firebase aplikasi Anda. Anda dapat menemukannya di tab Umum di 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.

Sebagai contoh:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

Sebagai opsi, Anda juga dapat mengganti nilai yang ditetapkan di build.gradle Anda dengan meneruskan argumen baris perintah dalam bentuk -PappDistribution- property-name = property-value .

5. Bangun dan distribusikan 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 default adalah app/build/outputs/bundle/release ).
  3. Untuk mendistribusikan rilis, buat bundleRelease target dan appDistributionUploadRelease dengan pembungkus Gradle proyek Anda. Sertakan token Firebase (yang Anda terima di 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, kini Anda dapat memantau pembuatan di tab Rilis di dasbor App Distribution.

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, masuk 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 mengunduh Firebase App Tester , yang mencegah rilis yang diunduh tidak ditambahkan ke folder Downloads perangkat Anda. Ini juga menampilkan informasi tambahan tentang rilis, seperti kemajuan unduhan dan versi rilis.

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

Setelah unduhan selesai, rilis Anda akan muncul secara otomatis 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