Mendistribusikan aplikasi iOS kepada penguji menggunakan fastlane

Anda dapat mendistribusikan build ke penguji menggunakan fastlane, sebuah platform open source yang mengotomatiskan pembuatan dan rilis aplikasi iOS dan 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 iOS 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

    Diperlukan hanya jika aplikasi Anda tidak berisi file konfigurasi Firebase (GoogleService-Info.plist): ID Aplikasi Firebase untuk aplikasi Anda. Anda dapat menemukan ID Aplikasi di Firebase console, di halaman Setelan Umum.

    
    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    Jalur ke file GoogleService-Info.plist Anda, relatif terhadap jalur produk yang diarsipkan. Setel ke GoogleService-Info.plist secara default.

    File ini digunakan untuk mendapatkan ID Aplikasi Firebase jika parameter app tidak ditentukan.

    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.

    ipa_path

    Jalur absolut ke file IPA 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 :ios do
        desc "My awesome app"
        lane :distribute do
            build_ios_app(...) # build_ios_app is a built-in fastlane action.
    
            firebase_app_distribution(
                app: "1:123456789:ios: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.