Mendistribusikan aplikasi iOS ke penguji menggunakan Firebase CLI

Anda dapat mendistribusikan build kepada penguji menggunakan Firebase CLI. Dengan alat CLI, Anda dapat menentukan penguji dan catatan rilis untuk build, dan mendistribusikan build tersebut.

Sebelum memulai

Tambahkan Firebase ke project iOS jika Anda belum melakukannya.

Jika Anda tidak menggunakan produk Firebase lainnya, Anda hanya perlu membuat project dan mendaftarkan aplikasi. Namun, jika Anda memutuskan untuk menggunakan produk tambahan di masa mendatang, pastikan untuk menyelesaikan semua langkah di halaman yang ditautkan di atas.

Langkah 1. Buat aplikasi Anda

Saat Anda sudah siap untuk mendistribusikan versi pra-rilis aplikasi kepada penguji, buat arsip distribusi yang ditandatangani. Anda dapat menggunakan proses build normal selama memenuhi persyaratan berikut:

  • Untuk mendistribusikan aplikasi di luar tim pengembangan, Anda harus menggunakan profil distribusi Ad Hoc atau Enterprise.
  • Jika aplikasi Anda menggunakan Game Center, APN (dan dengan ekstensi, Cloud Messaging), atau iCloud, pastikan profil penyediaan Anda menggunakan ID aplikasi eksplisit, dan bukan ID karakter pengganti.
  • Jika menggunakan profil distribusi Ad Hoc, sertakan ID perangkat unik (UDID) dari perangkat penguji Anda. Saat penguji iOS yang baru mendaftar di program pengujian, Anda perlu memperbarui profil penyediaan dengan UDID perangkat mereka. Lihat bagian Mendaftarkan perangkat penguji tambahan.
  • Jika Anda telah membuat perubahan kode sejak build terakhir (yaitu, Anda tidak membuat kembali hanya untuk memperbarui perangkat terdaftar), perbarui nomor versi (Versi) yang terlihat oleh pengguna dan nomor build unik (Build) dari target build.

Ketika selesai, build menyimpan file IPA dan beberapa file log di folder yang Anda tentukan. Anda mendistribusikan file IPA ke penguji dengan langkah-langkah berikut.

Langkah 2. Distribusikan aplikasi kepada penguji

Untuk mendistribusikan aplikasi kepada penguji, upload file IPA menggunakan Firebase CLI:

  1. Instal atau update ke versi terbaru Firebase CLI (sebaiknya download biner mandiri untuk CLI khusus untuk OS Anda). Pastikan untuk login dan menguji apakah Anda dapat mengakses project.
  2. Di halaman App Distribution Firebase console, pilih aplikasi yang akan didistribusikan, lalu klik Mulai.
  3. Jalankan perintah appdistribution:distribute untuk mengupload aplikasi dan mendistribusikannya kepada penguji. Gunakan parameter berikut untuk mengonfigurasi distribusi:

    opsi appdistribution:distribute
    --app

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

    
    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    Token refresh yang dicetak saat Anda mengautentikasi lingkungan CI dengan Firebase CLI (baca Menggunakan CLI dengan sistem CI untuk mengetahui informasi lebih lanjut).

    
    --token "$FIREBASE_TOKEN"
    --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 jalur ke file teks biasa yang berisi daftar nama grup yang dipisahkan dengan koma:

    
    --groups-file "/path/to/groups.txt"
    --debug

    Tanda yang dapat Anda sertakan untuk mencetak keluaran log panjang.

    Contoh:

    firebase appdistribution:distribute test.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

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 atau belum.

Langkah 3. Daftarkan perangkat penguji tambahan

Saat penguji menerima undangan untuk menguji build yang tidak ditandatangani dengan profil Perusahaan, mereka dimintai izin untuk membagikan UDID perangkat mereka kepada Anda. Jika mereka setuju, App Distribution mengumpulkan UDID dari perangkat dan memberi tahu Anda melalui email terkait UDID yang baru dibagikan.

Saat menerima salah satu dari email tersebut, perbarui profil penyediaan Anda dengan UDID ini dan distribusikan build baru kepada penguji dengan mengikuti langkah-langkah berikut:

  1. Pada halaman Tambahkan Perangkat portal Apple Developer, daftarkan UDID baru yang tercantum dalam email yang Anda terima.
  2. Tambahkan perangkat terdaftar ke profil penyediaan Anda di halaman Profil Penyedia iOS.
  3. Download profil provisioning dan gunakan untuk mem-build ulang aplikasi. Jika Anda mem-build ulang hanya untuk mengupdate perangkat yang terdaftar, jangan update nomor atau versi build.
  4. Distribusikan ulang aplikasi Anda dari Firebase console atau CLI. Jika Anda telah mendistribusikan build dengan nomor dan versi build yang sama, hanya pengguna perangkat yang baru terdaftar yang menerima email pemberitahuan.