Beri tahu penguji tentang rilis aplikasi baru Anda dengan Firebase App Distribution Android SDK - Codelab

1. Ikhtisar

c7a9160ef7b184c7.png22e0b52f771c060d.png

Selamat datang di Mengintegrasikan Firebase App Distribution SDK di codelab aplikasi Android Anda. Dalam codelab ini, Anda akan menambahkan App Distribution Android SDK ke aplikasi Anda untuk menampilkan pemberitahuan dalam aplikasi kepada penguji saat versi baru tersedia untuk didownload. Anda akan mempelajari cara menggunakan konfigurasi dasar dan konfigurasi khusus agar penguji Anda masuk untuk menerima pembaruan. Kemudian Anda akan mendorong rilis baru ke App Distribution dan memicu peringatan build baru langsung di aplikasi.

Apa yang akan Anda pelajari

  • Cara menggunakan App Distribution untuk mendistribusikan aplikasi pra-rilis ke penguji
  • Cara mengintegrasikan App Distribution Android SDK ke dalam aplikasi Anda
  • Cara memperingatkan penguji ketika ada versi pra-rilis baru yang siap dipasang
  • Cara menyesuaikan SDK agar sesuai dengan kebutuhan pengujian Anda

Apa yang Anda perlukan

  • Versi Android Studio terbaru.
  • Kode sampel.
  • Perangkat uji dengan Android 4.4+ dan layanan Google Play 9.8 atau lebih baru, atau Emulator dengan layanan Google Play 9.8 atau lebih baru.
  • Jika menggunakan perangkat, kabel koneksi.

Bagaimana Anda akan menggunakan tutorial ini?

Bacalah saja Bacalah dan selesaikan latihannya

Bagaimana Anda menilai pengalaman Anda dalam membuat aplikasi Android?

Pemula Intermediat Ahli

2. Dapatkan kode contoh

Kloning repositori GitHub dari baris perintah.

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

Jika Anda belum menginstal git, Anda juga dapat mengunduh proyek sampel dari halaman GitHub atau dengan mengeklik tautan ini .

3. Impor aplikasi pemula

Dari Android Studio, pilih direktori codelab-appdistribution-android/start ( android_studio_folder.png ) dari unduhan kode contoh ( File > Open > .../codelab-appdistribution-android/start).

Anda sekarang seharusnya sudah membuka proyek awal di Android Studio.

4. Buat proyek konsol Firebase

Tambahkan proyek Firebase baru

  1. Buka konsol Firebase .
  2. Pilih Tambahkan Proyek , lalu beri nama proyek Anda "Firebase Codelab".

Anda tidak perlu mengaktifkan Google Analytics untuk proyek ini.

  1. Klik Buat proyek .

Tambahkan aplikasi ke Firebase

Daftarkan aplikasi Anda dengan Firebase . Gunakan "com.google.firebase.appdistributioncodelab" sebagai nama paket.

Tambahkan file google-services.json ke aplikasi Anda

Setelah menambahkan nama paket dan memilih Daftar, ikuti langkah-langkah berikut untuk menambahkan google-services.json ke aplikasi Anda:

  1. Klik Unduh google-services.json untuk mendapatkan file konfigurasi Firebase Android Anda.
  2. Salin file google-services.json ke direktori app di proyek Anda.
  3. Setelah file diunduh, Anda dapat Lewati langkah selanjutnya yang ditampilkan di konsol (langkah tersebut telah dilakukan untuk Anda di proyek build-android-start).

Perbarui ID Aplikasi agar sesuai dengan aplikasi Firebase Anda

  1. Di menu sebelah kiri (Tab Proyek), pastikan Anda berada di Tampilan "Android" dan cari tab "Gradle Scripts" dan buka file Gradle modul (tingkat aplikasi) Anda (biasanya app/build.gradle.kts ).
  2. Ubah properti applicationId agar sesuai dengan ID aplikasi aplikasi Firebase Anda. Ini seharusnya "com.google.firebase.appdistributioncodelab"

Sinkronkan proyek Anda dengan file Gradle

Untuk memastikan bahwa semua dependensi tersedia untuk aplikasi Anda, sinkronkan proyek Anda dengan file Gradle, pilih File > Sinkronkan Proyek dengan File Gradle dari toolbar Android Studio.

5. Siapkan peringatan build baru dalam aplikasi dengan App Distribution Android SDK

Pada langkah ini, Anda akan menambahkan Firebase App Distribution Android SDK ke aplikasi Anda dan menampilkan pemberitahuan dalam aplikasi kepada penguji ketika versi baru aplikasi Anda tersedia untuk diinstal. Untuk melakukannya, pastikan Anda telah mengaktifkan Firebase App Testers API untuk proyek "Firebase Codelab" (di Google Cloud Console). Anda harus masuk dengan akun yang sama dan memilih proyek yang benar dari menu tarik-turun di bagian atas.

Konfigurasikan peringatan dalam aplikasi

Android SDK Distribusi Aplikasi menyediakan dua cara untuk menyiapkan pemberitahuan build dalam aplikasi untuk penguji Anda:

  • Konfigurasi peringatan dasar, yang dilengkapi dengan dialog bawaan untuk ditampilkan kepada penguji.
  • Konfigurasi peringatan tingkat lanjut, yang memungkinkan Anda menyesuaikan antarmuka pengguna (UI).

Kita akan mulai dengan konfigurasi peringatan dasar. Anda dapat menggunakan updateIfNewReleaseAvailable untuk menampilkan dialog pengaktifan pemberitahuan yang telah dibuat sebelumnya kepada penguji yang belum mengaktifkan pemberitahuan, lalu memeriksa apakah versi baru tersedia. Penguji mengaktifkan peringatan dengan masuk ke akun yang memiliki akses ke aplikasi di App Distribution. Saat dipanggil, metode ini menjalankan urutan berikut:

  1. Memeriksa apakah penguji mengaktifkan peringatan. Jika tidak, metode ini akan menampilkan dialog bawaan yang meminta penguji masuk ke App Distribution dengan akun Google mereka.

Mengaktifkan pemberitahuan adalah proses satu kali pada perangkat pengujian yang terus berlanjut sepanjang pembaruan aplikasi Anda. Peringatan tetap aktif pada perangkat pengujian hingga aplikasi dicopot pemasangannya atau hingga metode signOutTester dipanggil.

  1. Memeriksa build baru yang tersedia untuk dipasang oleh penguji.
  2. Menampilkan peringatan bawaan yang meminta penguji mengunduh rilis terbaru.
  3. Periksa jenis build baru sebelum melanjutkan pembaruan:
  4. Jika build baru adalah App Bundle (AAB), arahkan penguji ke Play Store untuk menyelesaikan proses update.
  5. Jika build baru adalah APK, SDK akan mendownload build baru di latar belakang dan meminta penguji untuk menginstal build baru saat download selesai. SDK mengirimkan pemberitahuan kemajuan pengunduhan kepada pengguna menggunakan NotificationManager. Anda dapat menambahkan indikator kemajuan Anda sendiri dengan melampirkan pengendali onProgressUpdate ke Tugas updateIfNewReleaseAvailable .

Anda dapat memanggil updateIfNewReleaseAvailable() kapan saja di aplikasi Anda. Misalnya, Anda dapat memanggil updateIfNewReleaseAvailable() selama metode onResume() pada MainActivity:

Buka MainActivity.kt , dan buat metode onResume() seperti ini:

Aktivitas Utama.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

Sekarang mari kita terapkan metode checkForUpdate() .

Aktivitas Utama.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. Bangun dan undang penguji untuk mengunduh aplikasi Anda

Pada langkah ini, Anda akan mem-build aplikasi dan menguji implementasinya dengan mendistribusikan build tersebut kepada penguji menggunakan Firebase console.

Bangun aplikasi Anda

Saat Anda siap mendistribusikan versi pra-rilis aplikasi Anda kepada penguji, buat APK menggunakan proses normal. Anda harus menandatangani APK dengan kunci debug atau kunci penandatanganan aplikasi.

Distribusikan aplikasi Anda ke penguji

Untuk mendistribusikan aplikasi Anda kepada penguji, upload file APK menggunakan Firebase console:

  1. Buka halaman Distribusi Aplikasi di Firebase console. Pilih proyek Firebase Anda saat diminta.
  2. Di halaman Rilis, pilih aplikasi yang ingin Anda distribusikan dari menu drop-down.

623460c3c8a82ce6.png

  1. Klik Memulai

bf503b25066ff4a4.png

  1. Tarik file APK aplikasi Anda ke konsol untuk menguploadnya.
  2. Saat pengunggahan selesai, tentukan grup penguji dan masing-masing penguji yang ingin Anda terima buildnya. (Tambahkan email Anda untuk menerima undangan.) Kemudian, tambahkan catatan rilis untuk build. Untuk mempelajari lebih lanjut cara membuat grup penguji, lihat Menambahkan dan menghapus penguji .

3343048f0930e84b.png

  1. Klik Distribusikan untuk membuat build tersedia bagi penguji.

2be58fe195928bf9.png

Di Firebase console, kini Anda dapat melihat penguji yang Anda tambahkan pada rilis aplikasi Anda.

9935a41810344c61.png

Karena Anda menyertakan alamat email, Anda akan menerima email dari Firebase App Distribution yang mengundang Anda untuk menguji aplikasi. Anda sekarang adalah penguji pertama! Ikuti instruksi di Terima undangan untuk menyiapkan sebagai penguji pada perangkat pengujian Anda.

Menerima undangan

Anda harus terlebih dahulu menerima undangan untuk mengunduh dan menguji rilisnya.

  1. Di perangkat pengujian Android Anda, buka email yang dikirim dari Firebase App Distribution dan ketuk Memulai .
  2. Di aplikasi web penguji Firebase App Distribution yang muncul, login dengan akun Google Anda dan ketuk Terima undangan. Kini Anda dapat melihat rilis yang diundang untuk diuji.

c18cb684f8e82ad6.png

Unduh rilis dari perangkat uji

Saat membuka aplikasi codelab AppDistribution, Anda dapat melihat bahwa rilis siap untuk diunduh.

5414d9a536f25ece.png

  1. Ketuk Unduh , lalu instal dan jalankan aplikasi!
  2. Saat aplikasi dimulai, aplikasi meminta Anda untuk mengaktifkan peringatan build baru. Ketuk Nyalakan .

b059e09acaa4779f.png

  1. Masuk dengan akun penguji Anda..

22e0b52f771c060d.png

Anda kembali ke aplikasi. Saat berikutnya Anda menjalankan aplikasi, Anda tidak perlu masuk atau menerima peringatan

c9f33df16a2680d.png

Distribusikan pembaruan kepada penguji Anda

  1. Perbarui versionName Anda menjadi "1.1" dan versionCode menjadi 2 di file Gradle modul (tingkat aplikasi) Anda (biasanya app/build.gradle).
  2. Bangun APK Anda menggunakan proses normal Anda. Anda harus menandatangani APK dengan kunci debug atau kunci penandatanganan aplikasi.
  3. Unggah APK baru ini ke Firebase console Anda, tambahkan lagi email Anda sebagai penguji dan klik Distribusikan .

2dfa702edfdce6b8.png

Uji peringatan build

  1. Pastikan Anda menutup aplikasi jika masih terbuka.
  2. Mulai ulang aplikasi.
  3. Saat aplikasi dimulai ulang, Anda menerima peringatan Tersedia Versi Baru.

987e3d0ba4e56f84.png

  1. Untuk menerima versi terbaru, klik Perbarui .
  2. Jika diminta, pilih opsi untuk mengaktifkan penginstalan dari sumber tidak dikenal.
  3. Klik Instal (atau Perbarui ) di layar berikutnya.

a7c7cd15d60bc764.png

  1. Selamat! Anda dapat memperbarui aplikasi Anda dengan peringatan bawaan.

7. Sesuaikan proses masuk penguji

Metode signInTester/signOutTester dan isTesterSignedIn memberi Anda lebih banyak fleksibilitas dalam menyesuaikan pengalaman masuk penguji, sehingga dapat lebih cocok dengan tampilan dan nuansa aplikasi Anda.

Contoh berikut memeriksa apakah penguji sudah login ke akun penguji Firebase App Distribution, sehingga Anda dapat memilih untuk menampilkan UI login hanya untuk penguji yang belum login. Setelah penguji login, Anda kemudian dapat panggil checkForUpdate untuk memeriksa apakah penguji memiliki akses ke versi baru.

Mari kita nonaktifkan pemeriksaan pembaruan secara otomatis di onResume dengan mengomentari panggilan checkForUpdate() .

Aktivitas Utama.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

Sebaliknya, checkForUpdate() sudah ditambahkan di OnClickListener tombol update.

Sekarang, mari kita terapkan metode signIn() yang akan membuat pengguna login jika mereka logout, atau logout pengguna jika mereka sudah login.

Aktivitas Utama.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

Terakhir, mari kita terapkan metode isTesterSignedIn .

Aktivitas Utama.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

Bangun dan uji implementasi Anda

8. Selamat!

Anda telah membuat fitur "tampilan peringatan dalam aplikasi" ke dalam aplikasi menggunakan Firebase App Distribution Android SDK.

Apa yang telah kami bahas

  • Distribusi Aplikasi Firebase
  • SDK Android Peringatan Baru Distribusi Aplikasi Firebase

Langkah selanjutnya

Belajarlah lagi

Ada pertanyaan?

Laporkan Masalah