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
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
-
Di jalur
./fastlane/Fastfile
, tambahkan blokfirebase_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 keGoogleService-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.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
-
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.