Halaman ini memberikan bantuan pemecahan masalah dan jawaban atas pertanyaan umum (FAQ) tentang pendistribusian dan pengujian aplikasi dengan App Distribution.
Menginstal dan menguji aplikasi
Tips berikut membantu penguji memecahkan masalah yang terjadi saat menginstal aplikasi pengujian dan mengaksesnya di perangkat.
Akun Google tidak memiliki akses ke aplikasi pengujian
Jika Akun Google Anda tidak memiliki akses ke aplikasi pengujian yang sebelumnya Anda instal (atau menerima undangan untuk mengaksesnya), Anda mungkin login ke Akun Google yang salah. Aplikasi yang dapat Anda akses dikaitkan dengan Akun Google yang digunakan saat pertama kali menerima undangan untuk menguji aplikasi. Coba lagi dengan login menggunakan Akun Google yang sebelumnya digunakan untuk menerima undangan.
Error "Untrusted Enterprise Developer" saat mencoba menjalankan aplikasi pengujian
Error Untrusted Enterprise Developer muncul jika Anda tidak memercayai sertifikat developer di perangkat pengujian sebelum membuka aplikasi. Di aplikasi Settings > layar Profiles & Device Management, pilih nama developer aplikasi, lalu percayai.
"Waiting for developer" mencegah penginstalan aplikasi pengujian
Jika Anda menginstal distribusi Ad Hoc, tombol Waiting for developer akan muncul jika developer belum mengonfigurasi aplikasi mereka untuk berjalan di perangkat pengujian Anda. Agar aplikasi mereka tersedia untuk Anda, developer harus melakukan langkah-langkah berikut:
Tambahkan UDID perangkat pengujian di portal Apple Developer (UDID dikirim melalui email ke developer saat Anda mendaftarkan perangkat ke Firebase).
Sertakan perangkat di profil penyediaan aplikasi.
Build aplikasi menggunakan profil penyediaan yang telah diperbarui.
Distribusikan build baru menggunakan Firebase console, CLI, atau fastlane.
Mengaktifkan pemberitahuan dalam aplikasi dengan App Distribution SDK
Tips berikut membantu Anda dan penguji memecahkan masalah yang terkait dengan mengaktifkan pemberitahuan build baru dalam aplikasi menggunakan App Distribution SDK.
Penguji tidak menerima pemberitahuan dalam aplikasi
Jika Anda telah menyiapkan App Distribution SDK di aplikasi dan penguji tidak menerima pemberitahuan dalam aplikasi, periksa untuk memastikan aplikasi Anda mengambil rilis baru:
Aktifkan mode debug di aplikasi Anda (buka dokumentasi Google Analytics untuk mempelajari caranya), kemudian jalankan aplikasi Anda di simulator dan telusuri string "[Firebase/AppDistribution]".
Pastikan Anda mendapatkan rilis aplikasi:
Jika objek rilis yang valid ditampilkan, kemungkinan ada masalah dalam siklus proses View Controller tempat dialog pemberitahuan dimuat sebelum View tersebut muncul. Perhatikan bahwa App Distribution SDK tidak menampilkan dialog pemberitahuan secara default; Anda harus menentukan cara dan tempat dialog ditampilkan di aplikasi Anda (buka Konfigurasi pemberitahuan dasar untuk melihat contohnya).
Jika tidak ada rilis yang ditampilkan, penguji Anda mungkin belum dikaitkan dengan rilis baru. Di dasbor App Distribution pada Firebase console, pastikan penguji disertakan dalam distribusi build dan berstatus Diterima.
Jika penguji masih tidak menerima pemberitahuan, minta mereka untuk mengikuti tips di bawah guna memastikan bahwa mereka telah menerima undangan untuk menguji aplikasi Anda dan menyiapkan perangkat pengujian dengan benar:
Di perangkat uji, login ke klip web Firebase App Distribution (jangan lupa untuk memilih Akun Google yang pertama kali Anda gunakan saat menerima undangan untuk menguji aplikasi tersebut).
Periksa untuk memastikan rilis aplikasi baru tersedia di klip web.
Penguji diminta untuk login lagi setelah menutup aplikasi
Secara default, penguji hanya perlu login ke Akun Google miliknya sekali untuk mengaktifkan pemberitahuan build baru dan menginstal build baru. Jika penguji diminta untuk login lagi setelah menutup dan membuka kembali aplikasi, ikuti tips berikut untuk memastikan konfigurasi App Distribution disiapkan dengan benar:
Periksa untuk memastikan Anda telah mengaktifkan App Distribution Tester API (lihat petunjuk di panduan App Distribution SDK).
Di Google Cloud Platform Console, pada Pembatasan kunci, pastikan Anda tidak menggunakan kunci API yang dibatasi.
Jika biasanya menghapus
UserDefaults
saat logout, Anda mungkin akan menghapus status penguji. App Distribution menyimpan flag yang menunjukkan apakah penguji Anda telah login ke aplikasi atau tidak (lihat repositori GitHub untuk mengetahui informasi selengkapnya).
Pertanyaan umum (FAQ)
Apakah ada batas untuk menambahkan penguji ke aplikasi saya?
Firebase App Distribution memiliki batas penguji berikut:
Maksimal 500 penguji dapat ditambahkan ke project Firebase
Maksimal 200 penguji dapat ditambahkan ke grup App Distribution
Maksimal 200 penguji dapat ditambahkan per distribusi
Untuk menambahkan lebih banyak penguji, ajukan peningkatan batas gratis.
Apakah build aplikasi saya ada masa berlakunya?
Jika Anda mengupload build aplikasi ke Firebase, build tersebut akan tersedia di dasbor App Distribution (di Firebase console) selama 150 hari (lima bulan), dimulai sejak tanggal upload. Kemudian, Anda dapat mendistribusikan build kepada penguji, yang dapat menginstalnya dari klip web Firebase App Distribution di perangkat pengujian miliknya. Untuk memberi tahu Anda dan penguji, notifikasi habis masa berlaku akan muncul di build ketika masa berlakunya akan berakhir dalam 30 hari.
Setelah periode 150 hari tersebut, build akan berakhir masa berlakunya dan dihapus dari dasbor App Distribution serta klip web Firebase App Distribution. Jika penguji telah menginstal build, versi lokal aplikasi Anda akan terus berjalan.
Jika Anda tidak ingin build tersebut langsung dihapus, sebaiknya lakukan solusi berikut:
Sebelum masa berlaku build berakhir, download IPA lalu hapus build dari dasbor App Distribution. Kemudian, upload ulang IPA ke Firebase App Distribution (sebagai build baru).
Download build tersebut lalu upload ke Cloud Storage for Firebase untuk pengarsipan jangka panjang.
Apa yang dimaksud dengan profil Firebase?
Profil Firebase adalah profil konfigurasi yang memungkinkan App Distribution untuk:
Mendaftarkan perangkat pengujian dengan mengumpulkan ID perangkat unik (UDID) perangkat. Jika Anda menguji distribusi Ad Hoc, Firebase mengirimkan email kepada developer aplikasi yang berisi UDID perangkat pengujian, beserta petunjuk tentang cara menyertakan perangkat dalam profil penyediaan aplikasi, sehingga build dapat diuji dalam perangkat Anda.
Menginstal klip web Firebase App Distribution ke layar utama perangkat Anda. Klip web memungkinkan Anda menginstal dan mengakses semua aplikasi pengujian di satu tempat. Build baru yang Anda telah undang untuk menguji akan ditambahkan ke klip web secara otomatis.
Untuk mendapatkan bantuan mengenai cara menginstal profil konfigurasi di perangkat iOS Anda, baca dokumentasi Apple.
Bagaimana cara mengakses aplikasi pengujian yang saya instal di perangkat?
Jika Anda adalah seorang penguji, Anda dapat mengakses semua aplikasi pengujian dengan klip web Firebase App Distribution, yang otomatis ditambahkan ke layar utama perangkat pengujian saat menginstal profil Firebase. Jika menguji distribusi Ad Hoc, Anda harus menginstal profil terlebih dahulu sebelum dapat menguji aplikasi.
Jika menguji distribusi Enterprise, Anda dapat menginstal profil secara manual:
Jika Anda belum melakukannya, login ke Google dan terima undangan.
Di bagian Aplikasi pengujian, pilih aplikasi yang ingin diuji.
Di kanan atas halaman aplikasi, ketuk mobile_screen_share.
Ikuti petunjuk yang ditampilkan untuk menginstal profil Firebase.
Bagaimana cara menghapus akun penguji?
Untuk menghapus akun penguji App Distribution dan data terkait, ikuti langkah-langkah berikut secara berurutan:
Kunjungi https://appdistribution.firebase.google.com dan login dengan Akun Google Anda.
Di kanan atas, klik settings (Kelola akun)
Hapus akun.
Opsional: Di bagian izin Akun Google, cabut akses dari Firebase App Distribution. Perhatikan bahwa mencabut akses tanpa menghapus akun App Distribution terlebih dahulu tidak menghapus akun atau data penguji Anda.