Mendaftarkan perangkat iOS tambahan

Jika ingin mendistribusikan build iOS ad hoc menggunakan App Distribution, Anda harus mengikuti panduan ini untuk mendaftarkan perangkat penguji. Build ad hoc adalah build yang tidak ditandatangani dengan profil Enterprise. Perangkat hanya dapat menginstal build ad hoc jika ID perangkat unik (UDID) milik perangkat disertakan dalam profil penyediaan build.

Saat penguji menerima undangan untuk menguji aplikasi Anda, App Distribution meminta izin untuk membagikan ID perangkat penguji kepada Anda, sebagai developer. Sebelum mendownload build ad hoc, App Distribution akan meminta penguji untuk mendaftarkan perangkatnya. Jika penguji mendaftarkan perangkatnya, App Distribution akan mengumpulkan UDID dari perangkat dan memberi tahu Anda UDID tersebut melalui email.

Saat menerima email yang berisi UDID, perbarui profil penyediaan Anda dengan UDID ini dan distribusikan build baru kepada penguji. Anda dapat mengekspor UDID secara manual menggunakan Firebase console atau Firebase CLI, atau Anda dapat mengekspor UDID secara terprogram menggunakan fastlane.

Mengekspor UDID secara manual

Tambahkan perangkat ke portal Apple Developer.
- Opsi 1: Impor UDID perangkat sebagai file CSV.
  Di tab Testers & Groups pada dasbor App Distribution, pilih All testers, lalu klik Export Apple UDIDs untuk mendownload file CSV. Selanjutnya, impor file ke akun developer Apple menggunakan opsi Register Multiple Devices. Untuk mempelajari lebih lanjut, lihat cara Mendistribusikan aplikasi ke perangkat terdaftar.
  
  Perhatikan bahwa akun Apple Developer Anda mungkin memiliki batasan jumlah pengimporan perangkat per tahun.
- Opsi 2: Kumpulkan dan masukkan UDID melalui email.
  Di halaman Add Devices di portal Apple Developer, daftarkan UDID baru yang tercantum dalam email yang Anda terima.
Tambahkan perangkat terdaftar ke profil penyediaan Anda.
Download profil penyediaan dan gunakan untuk membangun ulang aplikasi. Jika Anda membangun ulang hanya untuk memperbarui perangkat terdaftar, jangan mengubah nomor atau versi build.
Distribusikan ulang aplikasi Anda dari Firebase console atau CLI. Jika Anda tidak mengubah versi, nomor build, atau kode aplikasi, App Distribution tidak akan membuat rilis baru dan tidak akan memberi tahu penguji. Jika Anda telah mendistribusikan build dengan nomor dan versi build yang sama, hanya pengguna perangkat yang baru terdaftar yang akan menerima email notifikasi.

Mengekspor UDID secara terprogram menggunakan fastlane

Ekspor semua UDID perangkat penguji sebagai file CSV dari fastlane. Misalnya, buat dan jalankan baris download_udids baru:
```
lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end
```
Catatan: Untuk mengotomatiskan rilis build baru dengan UDID baru, lihat Mendistribusikan build iOS pra-rilis lebih cepat dengan App Distribution dan fastlane.
Impor UDID ke akun Apple Developer Anda menggunakan opsi Register Multiple Devices. Untuk mempelajari lebih lanjut, lihat dokumentasi Apple. Perhatikan bahwa akun Apple Developer Anda mungkin memiliki batasan jumlah pengimporan perangkat per tahun.
Tambahkan perangkat terdaftar ke profil penyediaan Anda.
Download profil penyediaan dan gunakan untuk membangun ulang aplikasi. Jika Anda membangun ulang hanya untuk memperbarui perangkat terdaftar, jangan perbarui nomor atau versi build.
Distribusikan ulang aplikasi Anda. Jika Anda tidak mengubah versi, nomor build, atau kode aplikasi, App Distribution tidak akan membuat rilis baru dan tidak akan memberi tahu penguji. Jika Anda telah mendistribusikan build dengan nomor dan versi build yang sama, hanya pengguna perangkat yang baru terdaftar yang akan menerima email notifikasi.

Menerima pemberitahuan

Mendapatkan pemberitahuan default

Secara default, Firebase dapat mengirimkan pemberitahuan App Distribution untuk pendaftaran perangkat iOS baru melalui email.

Untuk menerima pemberitahuan App Distribution melalui mekanisme default ini, Anda harus memiliki izin firebase.projects.update. Peran berikut mencakup izin yang diperlukan ini secara default: Firebase Admin atau Owner atau Editor project.

Secara default, setiap anggota project (yang memiliki izin yang diperlukan untuk menerima pemberitahuan) akan mendapatkan email saat perangkat iOS baru didaftarkan.

Mengaktifkan/menonaktifkan pemberitahuan untuk akun Anda

Anda dapat mengaktifkan/menonaktifkan pemberitahuan App Distribution untuk akun Anda tanpa memengaruhi anggota project lainnya. Perlu diperhatikan bahwa Anda masih memerlukan izin yang dibutuhkan untuk menerima pemberitahuan.

Untuk mengaktifkan atau menonaktifkan pemberitahuan App Distribution, ikuti langkah-langkah berikut:

Di Firebase console, di pojok kanan atas, buka Firebase alerts.
Kemudian, buka Settings dan tetapkan preferensi akun Anda untuk pemberitahuan App Distribution.

Menyiapkan pemberitahuan lanjutan untuk layanan pihak ketiga

Anda juga dapat mengirim pemberitahuan App Distribution ke saluran notifikasi pilihan tim Anda menggunakan Cloud Functions for Firebase. Misalnya, Anda dapat menulis fungsi yang menangkap peristiwa pemberitahuan untuk pendaftaran perangkat iOS baru dan memposting informasi pemberitahuan ke layanan pihak ketiga, seperti Discord, Slack, atau Jira.

Untuk sepenuhnya mengotomatiskan proses orientasi penguji iOS baru, Anda dapat menulis fungsi yang menambahkan UDID perangkat iOS baru ke profil penyediaan aplikasi, membangun ulang aplikasi, dan mendistribusikan ulang aplikasi dengan profil penyediaan yang diperbarui.

Untuk menyiapkan kemampuan pemberitahuan lanjutan menggunakan Cloud Functions for Firebase, ikuti langkah-langkah berikut:

Siapkan Cloud Functions for Firebase, yang mencakup tugas berikut:
1. Menyiapkan lingkungan pengembangan untuk Node.js atau Python.
2. Menginstal dan login ke Firebase CLI.
3. Melakukan inisialisasi Cloud Functions for Firebase menggunakan CLI Firebase.
Menulis dan men-deploy fungsi yang menangkap peristiwa pemberitahuan dari App Distribution dan menangani payload peristiwa (misalnya memposting informasi pemberitahuan dalam pesan di Discord).

Untuk mempelajari semua peristiwa pemberitahuan yang dapat Anda tangkap, buka dokumentasi referensi untuk pemberitahuan App Distribution.

Langkah berikutnya

Impor penguji dari file CSV.
Untuk mempelajari cara meningkatkan basis pengujian internal, lihat Membuat link undangan.