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

  1. 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 Apple Developer 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.

  2. Tambahkan perangkat terdaftar ke profil penyediaan Anda.
  3. Download profil penyediaan dan gunakan untuk membangun ulang aplikasi. Jika Anda membangun ulang hanya untuk memperbarui perangkat terdaftar, jangan mengubah nomor atau versi build.
  4. 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

  1. Ekspor semua UDID perangkat penguji sebagai file CSV dari fastlane. Misalnya, buat dan jalankan lane download_udids baru:

    lane :download_udids do
        firebase_app_distribution_get_udids(
            app: "<your Firebase app ID>",
            output_file: "<path to output file>",
        )
    end
    
  2. 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.

  3. Tambahkan perangkat terdaftar ke profil penyediaan Anda.

  4. Download profil penyediaan dan gunakan untuk membangun ulang aplikasi. Jika Anda membangun ulang hanya untuk memperbarui perangkat terdaftar, jangan perbarui nomor atau versi build.

  5. 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 notifikasi

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 ini:

  1. Di Firebase console, di pojok kanan atas, buka Firebase alerts.
  2. Lalu buka Settings dan tetapkan preferensi akun 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:

  1. 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 insialisasi Cloud Functions for Firebase menggunakan Firebase CLI.
  2. 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