Halaman ini memberikan bantuan pemecahan masalah dan jawaban atas pertanyaan umum tentang pendistribusian dan pengujian aplikasi dengan App Distribution.
Mendistribusikan aplikasi
Gunakan tips berikut untuk memecahkan masalah yang mungkin Anda temui saat mendistribusikan aplikasi ke penguji.
Saat mengunggah aplikasi, Anda mungkin mengalami kesalahan ini:
"Kami tidak dapat menemukan email kontak untuk app <app-id>
. Silakan kunjungi App Distribution di dalam konsol Firebase untuk menyiapkannya."
Tetapkan Email Kontak di konsol Firebase, jika tersedia. Jika masalah berlanjut, hubungi Dukungan Firebase .
Jika Anda berulang kali menemukan kesalahan 400, 409, atau 500 selama penyediaan, hubungi Dukungan Firebase . Berikan Dukungan dengan nomor proyek Firebase dan pengidentifikasi aplikasi Anda.
Berikut ini adalah contoh respons jaringan browser:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Untuk mengatasi masalah ini, ikuti langkah-langkah berikut:
Verifikasi ukuran IPA. Batas ukuran file maksimum untuk semua binari adalah 2048 MiB, yaitu sedikit di atas 2 GB.
Jika ukuran IPA berada dalam batas ukuran file dan dapat direproduksi, ikuti langkah-langkah berikut:
Periksa file
Info.plist
Anda dan konfirmasikan apakahCFBundleDisplayName
berisi pembatas<array>
.Hapus pembatas
<array>
dan buat ulang aplikasi Anda. Pengunggahan harus berhasil.Jika Anda masih mengalami masalah, hubungi Dukungan Firebase .
Jika ukuran IPA melebihi batas ukuran file, lakukan perubahan yang diperlukan untuk mengurangi ukuran file.
Jika mengurangi ukuran file IPA tidak menyelesaikan masalah, hubungi Dukungan Firebase dan tanyakan tentang penggunaan Testflight .
Menginstal dan menguji aplikasi
Gunakan tips berikut untuk memecahkan masalah yang mungkin dialami penguji saat menginstal dan menguji aplikasi Anda.
Saat pengguna membuat akun Google, mereka secara otomatis menerima alamat Gmail.
Jika penguji tidak memiliki alamat Google Workspace atau Gmail, atau jika mereka lebih suka menggunakan alamat email lain untuk login, minta penguji untuk menautkan alamat email non-Gmail ke akun dan menggunakan email tersebut untuk login.
Saat memilih email alternatif, penguji harus mengikuti pedoman berikut:
- Jangan gunakan alamat Gmail.
- Jangan gunakan alamat email yang sudah ditautkan ke akun Google lain.
- Ingatlah untuk menggunakan sandi Akun Google Anda saat masuk dengan alamat email ini.
Untuk informasi selengkapnya, lihat Masuk ke Akun Google Anda dengan alamat email lain .
Jika penguji menerima undangan email dengan alamat email yang berbeda dengan yang dikirimi undangan, penguji mungkin tidak dapat melihat aplikasi atau build yang tepat.
Email tempat pengembang mengirim undangan dan menambahkannya ke build baru (Email A) dapat berbeda dari email yang digunakan penguji untuk menerima undangan (Email B). Ini menciptakan tautan di belakang layar. Setiap kali Email A ditambahkan ke bangunan baru, sebenarnya Email B yang mendapatkan akses.
Jika penguji menerima undangan email dengan alamat email yang berbeda, ikuti langkah berikut untuk mengatasi masalah tersebut:
Hapus penguji dari tab Penguji & Grup di halaman Distribusi Aplikasi di konsol Firebase. Undangan yang sudah ada akan dihapus.
Undang kembali penguji untuk menguji aplikasi Anda. Penguji harus menerima email undangan.
Pastikan penguji menerima undangan dengan alamat email yang sama.
Penguji mungkin tidak menerima pemberitahuan email jika salah satu hal berikut terjadi:
Notifikasi email dikirim ke folder spam.
Filter email disetel.
Undangan dikirim ke satu akun email, tetapi penguji menerimanya dengan akun email yang berbeda. Penguji menerima email rilis baru untuk akun email yang awalnya dikirimi undangan.
Penguji sebelumnya diundang tetapi tidak menerima undangan awal. Jika penguji ditambahkan ke rilis berikutnya, App Distribution tidak akan secara otomatis mengirimkan pemberitahuan rilis ke penguji tersebut karena penguji tidak menerima undangan awal.
Solusi 1
Minta penguji untuk memeriksa folder spam dan filter email apa pun yang mereka atur di layanan email mereka.
Jika penguji berhenti berlangganan email, minta penguji untuk melakukan hal berikut:
- Temukan email yang sebelumnya diterima penguji dari aplikasi.
- Klik Kelola pengaturan email di bagian bawah dan klik Izinkan email untuk berlangganan kembali.
Solusi 2
Hapus penguji dari tab Penguji & Grup di halaman Distribusi Aplikasi di konsol Firebase. Tindakan ini menghapus undangan yang ada.
Undang kembali penguji untuk menguji aplikasi Anda. Penguji harus menerima email undangan. Pastikan penguji menerima undangan dengan alamat email yang sama dengan yang dikirimi undangan.
Kesalahan Pengembang Perusahaan Tidak Tepercaya muncul jika Anda tidak mempercayai sertifikat pengembang pada perangkat pengujian sebelum membuka aplikasi. Di aplikasi Pengaturan > layar Profil & Manajemen Perangkat , pilih nama pengembang aplikasi dan percayai.
Kesalahan Mode Pengembang Diperlukan muncul saat Anda mencoba meluncurkan aplikasi iOS yang disediakan ad hoc di iOS 16 atau lebih baru tanpa terlebih dahulu mengaktifkan Mode Pengembang.
Untuk mengaktifkan Mode Pengembang dan mengatasi kesalahan ini, ikuti langkah-langkah berikut:
- Di iPhone Anda, buka aplikasi Pengaturan lalu ketuk Privasi & Keamanan .
- Gulir ke bawah ke Keamanan dan ketuk Mode Pengembang .
- Ketuk penggeser Mode Pengembang .
- Ketuk Mulai Ulang .
- Setelah perangkat dimulai ulang, buka kunci perangkat. Aktifkan Mode Pengembang? dialog muncul.
- Ketuk Aktifkan . Sekarang Anda dapat meluncurkan aplikasi dan memulai pengujian.
Jika Anda memasang distribusi Ad Hoc, pesan ini muncul saat pengembang belum mengonfigurasi aplikasinya untuk berjalan di perangkat pengujian Anda. Agar aplikasi tersedia untuk Anda, pengembang harus menyelesaikan petunjuk di Mendaftarkan perangkat tambahan .
Jika akun Google Anda tidak memiliki akses ke aplikasi pengujian yang sebelumnya Anda instal (atau terima undangannya), kemungkinan Anda masuk ke akun Google yang salah. Aplikasi yang dapat Anda akses dikaitkan dengan akun Google yang Anda gunakan saat pertama kali menerima undangan untuk menguji aplikasi. Coba lagi dengan masuk menggunakan akun Google yang sebelumnya Anda gunakan untuk menerima undangan.
Saat Anda menemukan kesalahan 403, ini berarti akun yang Anda gunakan tidak memiliki izin untuk menginstal dan menguji aplikasi. Akses ditentukan oleh administrator domain akun Anda di Google Workspace.
Jika Anda yakin harus memiliki izin untuk menginstal dan menguji aplikasi, minta admin akun Google Workspace Anda untuk mengubah setelan akun Anda. Admin Anda harus mengikuti petunjuk di Kelola akses ke layanan yang tidak dikontrol satu per satu .
Jika Anda memiliki banyak akun, coba masuk dengan akun lain yang tidak dibatasi untuk menginstal dan menguji aplikasi.
Mengaktifkan lansiran dalam aplikasi dengan App Distribution iOS SDK
Gunakan tips berikut untuk memecahkan masalah yang melibatkan pengaktifan peringatan build baru dalam aplikasi menggunakan App Distribution iOS SDK.
Jika Anda telah menyiapkan App Distribution iOS SDK di aplikasi dan penguji Anda tidak menerima lansiran dalam aplikasi, pastikan aplikasi Anda mengambil rilis baru:
Aktifkan mode debug di aplikasi Anda. Untuk mempelajari caranya, lihat dokumentasi Google Analytics .
Jalankan aplikasi Anda di simulator dan cari string "[Firebase/AppDistribution]".
Pastikan penguji memiliki akses ke rilis baru:
Jika objek rilis yang valid dikembalikan, kemungkinan ada masalah dalam siklus hidup Pengontrol Tampilan tempat dialog peringatan dimuat sebelum Tampilan muncul.
Jika tidak ada rilis yang dikembalikan, penguji Anda mungkin belum dikaitkan dengan rilis baru. Di dasbor App Distribution di Firebase console, pastikan penguji Anda disertakan dalam distribusi build dan dalam status Accepted .
Jika penguji Anda masih belum menerima pembaruan, minta mereka untuk mengikuti kiat di bawah guna memastikan mereka menerima undangan untuk menguji aplikasi Anda dan menyiapkan perangkat pengujian dengan benar:
Di perangkat uji, login ke klip web Firebase App Distribution. Ingatlah untuk memilih akun Google yang pertama kali Anda gunakan saat menerima undangan untuk menguji aplikasi.
Pastikan rilis aplikasi baru tersedia di klip web.
Secara default, penguji Anda hanya perlu masuk ke akun Google mereka satu kali untuk mengaktifkan peringatan bangunan baru dan memasang bangunan baru. Jika penguji Anda diminta untuk login lagi setelah menutup dan membuka kembali aplikasi Anda, ikuti tips berikut untuk memastikan konfigurasi App Distribution Anda disiapkan dengan benar:
Periksa untuk memastikan Anda telah mengaktifkan Firebase App Testers API. Untuk informasi lebih lanjut, lihat Mengaktifkan App Distribution Tester API .
Di bagian Pembatasan kunci , pastikan API Penguji Aplikasi Firebase disertakan dalam daftar API yang diizinkan.
Jika Anda biasanya menghapus UserDefaults saat keluar, Anda mungkin menghapus status penguji. App Distribution menyimpan tanda yang menunjukkan apakah penguji Anda sudah masuk ke aplikasi. Untuk informasi selengkapnya, lihat repositori GitHub .
Pertanyaan yang sering diajukan
Firebase App Distribution memiliki batas penguji berikut:
Tambahkan maksimal 500 penguji ke proyek Firebase
Tambahkan maksimal 200 penguji ke grup App Distribution
Untuk menambahkan lebih banyak penguji, minta kenaikan batas tanpa biaya .
Penguji memiliki waktu 30 hari untuk menerima undangan untuk menguji aplikasi sebelum kedaluwarsa. Saat undangan 5 hari dari kedaluwarsa, pemberitahuan kedaluwarsa muncul di konsol Firebase di samping penguji pada rilis. Undangan dapat diperpanjang dengan mengirimkannya kembali melalui menu tarik-turun di baris penguji.
Lihat Mendaftarkan perangkat tambahan .
Rilis aplikasi dihapus dari App Distribution jika salah satu dari kondisi berikut terjadi:
- Rilis aplikasi lebih lama dari 150 hari.
- Anda melebihi batas 1.000 rilis aplikasi, dan rilis aplikasi lebih lama dari 1.000 rilis aplikasi terbaru.
Untuk informasi selengkapnya, lihat App Distribution mendukung maksimal 1.000 rilis .
Setelah aplikasi mencapai atau melampaui batas kedaluwarsa 150 hari atau batas rilis 1.000 aplikasi, rilis dihapus dari dasbor App Distribution dan aplikasi web penguji App Distribution. Jika penguji Anda telah menginstal rilis, versi lokal aplikasi akan terus berjalan.
Agar rilis aplikasi tersedia lebih lama, gunakan salah satu rekomendasi berikut:
- Sebelum rilis aplikasi kedaluwarsa atau melampaui batas rilis, unduh IPA dan hapus rilis dari dasbor App Distribution. Kemudian, upload ulang IPA sebagai build baru ke App Distribution.
- Unduh rilis dan unggah ke Cloud Storage untuk pengarsipan jangka panjang.
Rilis aplikasi berakhir setelah 150 hari
Saat Anda mengupload rilis aplikasi ke Firebase, rilis tersebut muncul di dasbor App Distribution selama 150 hari, mulai dari tanggal upload. Setelah mengupload rilis, Anda dapat mendistribusikannya ke penguji, yang menginstal rilis dari aplikasi web penguji App Distribution di perangkat pengujian mereka.
Saat rilis adalah 30 hari dari tanggal kedaluwarsa, pemberitahuan kedaluwarsa rilis aplikasi akan muncul pada rilis Anda di halaman Distribusi Aplikasi Firebase console dan di aplikasi web penguji Distribusi Aplikasi.
App Distribution mendukung maksimal 1.000 rilis
App Distribution memungkinkan maksimal 1.000 rilis per aplikasi. Saat aplikasi Anda mencapai batas 1.000 rilis aplikasi, App Distribution secara otomatis menghapus rilis terlama yang melebihi batas tersebut.
Jika Anda ingin mengelola rilis aplikasi secara manual, gunakan REST API App Distribution untuk mencantumkan dan menghapus rilis aplikasi secara massal.
Jika ada pertanyaan, hubungi Dukungan Firebase .
Profil Firebase adalah profil konfigurasi yang memungkinkan App Distribution untuk:
Daftarkan perangkat uji dengan mengumpulkan ID perangkat unik (UDID) perangkat. Jika Anda menguji distribusi Ad Hoc, Firebase mengirimkan email kepada pengembang aplikasi yang berisi UDID perangkat uji, beserta petunjuk tentang cara menyertakan perangkat dalam profil penyediaan aplikasi sehingga build dapat diuji di perangkat Anda.
Instal klip web Firebase App Distribution ke layar utama perangkat Anda. Klip web memungkinkan Anda menginstal dan mengakses semua aplikasi pengujian di satu tempat. Bangunan baru yang diundang untuk Anda uji secara otomatis ditambahkan ke klip web.
Untuk bantuan dalam menginstal profil konfigurasi di perangkat iOS Anda, lihat dokumentasi Apple .
Jika Anda seorang penguji, Anda dapat mengakses semua aplikasi pengujian dengan klip web Firebase App Distribution , yang otomatis ditambahkan ke layar utama perangkat pengujian saat Anda memasang profil Firebase. Jika Anda menguji distribusi Ad Hoc, Anda harus memasang profil terlebih dahulu sebelum dapat menguji aplikasi.
Jika Anda menguji distribusi Enterprise, Anda dapat memasang profil secara manual:
Jika Anda belum melakukannya, masuk ke Google dan terima undangannya.
Di bagian Uji aplikasi , pilih aplikasi yang ingin Anda uji.
Di kanan atas halaman aplikasi, tap mobile_screen_share .
Ikuti petunjuk yang ditampilkan untuk memasang profil Firebase.
Untuk menghapus akun penguji App Distribution dan data terkaitnya, ikuti langkah-langkah berikut secara berurutan:
Kunjungi https://appdistribution.firebase.google.com dan masuk dengan akun Google Anda.
Di kanan atas, klik
( Kelola akun )Hapus akun .
Opsional: Di izin akun Google Anda, cabut akses dari Firebase App Distribution. Perhatikan bahwa mencabut akses tanpa menghapus akun App Distribution terlebih dahulu tidak akan menghapus akun atau data penguji Anda.