Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Mendistribusikan rilis app bundle ke penguji - Codelab

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 menghubungkan proyek Firebase Anda ke akun Google Play Anda
  • Cara menautkan aplikasi antara Firebase dan 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 Google Play yang Anda Admin atau Pemiliknya
  • Aplikasi di akun Pengembang Google Play Anda yang telah dipublikasikan ke trek internal, tertutup, produksi, atau pengujian terbuka
  • Alamat email yang dapat Anda gunakan sebagai penguji untuk menerima undangan build baru dari Firebase
  1. Masuk ke Firebase .
  2. Dalam Firebase konsol, klik Add Project, kemudian 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

  1. Saat diminta, aktifkan Google Analytics.
  2. Lakukan langkah-langkah yang tersisa, lalu klik Buat proyek.

Tambahkan bundel aplikasi Anda ke proyek

  1. Dalam Firebase konsol, klik Tambah aplikasi.

gambar5.png

  1. Saat mendaftarkan aplikasi Anda, pastikan untuk menggunakan nama paket yang sama dengan aplikasi yang diunggah ke akun Pengembang Google Play Anda. Terakhir, klik Register aplikasi.
  2. Lakukan langkah-langkah yang tersisa untuk menambahkan google-services.json file dan Firebase SDK untuk aplikasi Anda.
  3. Klik Lanjutkan untuk menghibur.

Terhubung ke Google Play dan Google Analytics

  1. Arahkan ke pengaturan proyek Anda.

gambar2.png

  1. Pada tab integrasi, klik Connect pada integrasi Google Play.
  2. Terakhir, klik App Distribusi bawah bagian Rilis & Monitor. Kemudian, klik Get Started.

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

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. Dalam file Gradle proyek-tingkat ( android/build.gradle ), menambahkan App Distribusi Gradle Plugin dan repositori Maven Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Dalam file Gradle aplikasi-tingkat ( android/app/build.gradle ), menambahkan App Distribusi Plugin:
    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 Jawa berikut yang memungkinkan App Distribusi untuk meng-upload distribusi Anda untuk Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Otentikasi proyek Firebase Anda

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

  1. Jalankan perintah berikut pada akar 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 App Distribution untuk mengautentikasi dengan Firebase.
  3. Mengatur variabel lingkungan FIREBASE_TOKEN untuk token dari langkah sebelumnya:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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.

Dalam Anda app/build.gradle , menambahkan firebaseAppDistribution bagian dan termasuk parameter berikut:

  • appID : aplikasi Anda Firebase App ID. Anda dapat menemukannya di tab General pengaturan proyek Anda.
  • artifactType : aplikasi Anda tipe file ( 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 pilihan, Anda juga dapat mengabaikan nilai yang ditetapkan dalam Anda build.gradle dengan melewatkan argumen baris perintah dalam bentuk -PappDistribution- property-name = property-value .

  1. Jalankan bundle Variant tugas Gradle untuk membangun aplikasi Anda bundel berkas:
    $ ./gradlew :base:bundleRelease
    
  2. Menemukan bundel dalam aplikasi Anda direktori membangun (lokasi default adalah app/build/outputs/bundle/release ).
  3. Untuk mendistribusikan rilis, membangun target bundleRelease 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 membangun di tab Pers dari App Distribusi dashboard.

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 Anda dan buka undangan dari Firebase.

gambar6.png

  1. Masuk dengan akun Google Anda dan terima undangan untuk menguji rilis terdistribusi. Sebagai pilihan, Anda juga dapat men-download Firebase App Tester, yang mencegah download rilis dari yang ditambahkan ke perangkat Anda Downloads folder. Ini juga menampilkan informasi tambahan tentang rilis, seperti kemajuan unduhan dan versi rilis.

gambar9.png

  1. Tap Download pada rilis untuk menginstalnya dari Play Store.
  2. 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.

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

Langkah selanjutnya