Mendistribusikan aplikasi Android kepada penguji menggunakan fastlane

Anda dapat mendistribusikan build ke penguji menggunakan fastlane, sebuah platform open source yang mengotomatiskan proses build dan rilis aplikasi iOS serta Android. Ini dilakukan dengan mengikuti petunjuk sederhana yang ditentukan dalam Fastfile. Setelah menyiapkan fastlane dan Fastfile, Anda dapat mengintegrasikan App Distribution dengan konfigurasi fastlane.

Langkah 1. Menyiapkan fastlane

  1. Menginstal dan menyiapkan fastlane.

  2. Untuk menambahkan App Distribution ke konfigurasi fastlane, jalankan perintah berikut dari root project Android Anda:

    fastlane add_plugin firebase_app_distribution

    Jika perintah tersebut menawarkan sejumlah opsi, pilih Option 3: RubyGems.org.

Langkah 2. Mengautentikasi dengan Firebase

Sebelum dapat menggunakan plugin Fastlane, Anda harus terlebih dahulu melakukan autentikasi dengan project Firebase. Ada tiga cara untuk melakukan ini:

Langkah 3. Siapkan Fastfile dan distribusikan aplikasi Anda

  1. Di jalur ./fastlane/Fastfile, tambahkan blok firebase_app_distribution. Gunakan parameter berikut untuk mengonfigurasi distribusi:
    parameter firebase_app_distribution
    app

    Wajib diisi: ID Aplikasi Firebase aplikasi Anda. Anda dapat menemukan ID Aplikasi di Firebase console, di halaman Setelan Umum.

    
    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

    Token refresh yang dicetak saat menjalankan tindakan login plugin (baca artikel Mengautentikasi menggunakan Akun Google, di atas), atau saat Anda mengautentikasi lingkungan CI dengan Firebase CLI (baca artikel Menggunakan CLI dengan sistem CI untuk mengetahui informasi lebih lanjut).

    service_credentials_file

    Jalur ke file json akun layanan Google Anda. Lihat cara di atas untuk mengautentikasi menggunakan kredensial akun layanan.

    apk_path

    Jalur absolut ke file APK yang akan Anda upload. Jika tidak ditentukan, fastlane akan menentukan lokasi file dari jalur tempat file dibuat.

    release_notes
    release_notes_file

    Catatan rilis untuk build ini.

    Anda dapat menentukan catatan rilis secara langsung:

    
    release_notes: "Text of release notes"

    Atau, tentukan lokasi ke file teks biasa:

    
    release_notes_file: "/path/to/release-notes.txt"
    testers
    testers_file

    Alamat email penguji yang ingin Anda undang.

    Anda dapat menentukan penguji sebagai daftar alamat email yang dipisahkan dengan koma:

    
    testers: "ali@example.com, bri@example.com, cal@example.com"

    Atau, Anda dapat menentukan lokasi ke file teks biasa yang berisi daftar alamat email yang dipisahkan koma:

    
    testers_file: "/path/to/testers.txt"
    groups
    groups_file

    Grup penguji yang akan Anda undang (lihat Mengelola penguji). Grup ditentukan menggunakan alias grup, yang dapat Anda cari di Firebase console.

    Anda dapat menentukan grup sebagai daftar yang dipisahkan dengan koma:

    
    groups: "qa-team, trusted-testers"

    Atau, Anda dapat menentukan lokasi ke file teks biasa yang berisi daftar nama grup yang dipisahkan dengan koma:

    
    groups_file: "/path/to/groups.txt"
    debug

    Tanda boolean. Anda dapat menyetelnya ke true untuk mencetak output debug verbose.

    Contoh:
    platform :android do
        desc "My awesome app"
        lane :distribute do
            build_android_app(...) # build_android_app is a built-in fastlane action.
    
            firebase_app_distribution(
                app: "1:123456789:android:abcd1234",
                testers: "tester1@company.com, tester2@company.com",
                release_notes: "Lots of amazing new features to test out!"
            )
    
        end
    end
    
  2. Terakhir, agar build tersedia bagi penguji, jalankan jalur Anda:
    fastlane <lane>

Setelah didistribusikan, build akan tersedia di dasbor App Distribution di Firebase console selama 150 hari (lima bulan). Saat masa berlaku build akan berakhir dalam 30 hari, notifikasi habisnya masa berlaku akan muncul di konsol dan daftar build penguji pada perangkat pengujinya.

Penguji yang belum diundang untuk menguji aplikasi akan menerima undangan email untuk memulai, dan penguji yang ada akan menerima notifikasi email bahwa ada versi build baru yang siap diuji (baca panduan penyiapan penguji untuk mengetahui petunjuk cara menginstal aplikasi pengujian). Anda dapat memantau status setiap penguji, apakah mereka sudah menerima undangan dan mendownload aplikasi, di Firebase console.