Pemecahan masalah & FAQ App Distribution

iOS+ Android

Halaman ini memberikan bantuan pemecahan masalah dan jawaban atas pertanyaan umum (FAQ) tentang pendistribusian dan pengujian aplikasi dengan App Distribution.

Mendistribusikan aplikasi

Gunakan tips berikut untuk memecahkan masalah yang mungkin Anda alami saat mendistribusikan aplikasi kepada penguji.

Tidak dapat mendistribusikan aplikasi karena email kontak tidak ada

Saat mengupload aplikasi, Anda mungkin mengalami error ini:

"Kami tidak dapat menemukan email kontak untuk aplikasi <app-id>. Buka App Distribution di dalam Firebase console untuk menyiapkannya."

Setel Email Kontak di Firebase console, jika tersedia. Jika masalah berlanjut, hubungi Dukungan Firebase.

Terjadi error saat menyediakan aplikasi Anda (error 400, 409, atau 500)

Jika Anda berulang kali mengalami error 400, 409, atau 500 selama penyediaan, hubungi Dukungan Firebase. Berikan nomor project Firebase dan ID aplikasi Anda kepada Dukungan Firebase.

Tidak dapat mengupload IPA

Berikut 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 menyelesaikan masalah ini, ikuti langkah berikut:

1. Verifikasi ukuran IPA. Batas ukuran file maksimum untuk semua biner adalah 2048 MiB, atau sedikit di atas 2 GB.

2. Jika ukuran IPA tersebut berada dalam batas ukuran file dan dapat direproduksi, ikuti langkah-langkah berikut:

   1. Periksa file Info.plist Anda dan konfirmasikan apakah CFBundleDisplayName berisi pemisah <array>.

      Catatan: App Distribution tidak menerima nilai CFBundleDisplayName yang berupa array.

   2. Hapus pembatas <array>, lalu build ulang aplikasi Anda. Upload seharusnya akan berhasil.

   3. Jika masih mengalami masalah, hubungi Dukungan Firebase.

3. Jika ukuran IPA tersebut melebihi batas ukuran file, buat perubahan yang diperlukan untuk mengurangi ukuran file.

4. Jika mengurangi ukuran file IPA tidak menyelesaikan masalah, hubungi Dukungan Firebase dan tanyakan mengenai penggunaan Testflight.

Menginstal dan menguji aplikasi

Gunakan tips berikut untuk memecahkan masalah yang mungkin dihadapi penguji saat menginstal dan menguji aplikasi Anda.

Penguji tidak memiliki Akun Google

Saat membuat Akun Google, pengguna akan 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 tersebut dan menggunakannya untuk login.

Saat memilih email alternatif, penguji harus mengikuti panduan berikut:

• Jangan menggunakan alamat Gmail.
• Jangan menggunakan alamat email yang telah ditautkan ke Akun Google lain.
• Jangan lupa untuk menggunakan sandi Akun Google Anda saat login dengan alamat email ini.

Untuk informasi selengkapnya, lihat Login ke Akun Google dengan alamat email lain.

Penguji tidak dapat melihat aplikasi atau build yang tepat

Jika penguji menerima undangan email dengan alamat email yang berbeda dari yang sebelumnya dikirimi undangan, penguji mungkin tidak dapat melihat aplikasi atau build yang tepat.

Email yang dikirim oleh developer dan ditambahkan ke build baru (Email A) dapat berbeda dengan email yang digunakan penguji untuk menerima undangan (Email B). Tindakan ini akan membuat link di balik layar. Setiap kali Email A ditambahkan ke build baru, sebenarnya Email B yang mendapatkan akses.

Jika penguji menerima undangan email dengan alamat email yang berbeda, ikuti langkah-langkah berikut untuk mengatasi masalah tersebut:

1. Hapus penguji dari bagian Lihat semua penguji pada bagian Penguji & Tab Grup di App Distribution halaman Firebase console. Undangan yang sudah ada akan dihapus.

2. Undang kembali penguji untuk menguji aplikasi Anda. Penguji akan menerima email undangan.

3. Pastikan penguji menerima undangan dengan alamat email yang sama.

Penguji tidak menerima notifikasi email

Penguji mungkin tidak menerima notifikasi email jika salah satu hal berikut terjadi:

• Notifikasi email dikirim ke folder spam.

• Filter email ditetapkan.

• Undangan telah dikirim ke satu akun email, tetapi penguji menerima dengan akun email yang berbeda. Penguji menerima email rilis baru untuk akun email yang awalnya menerima undangan tersebut.

• Penguji sebelumnya diundang tetapi tidak menerima undangan awal. Jika penguji ditambahkan ke rilis berikutnya, App Distribution tidak akan otomatis mengirimkan notifikasi rilis ke penguji tersebut karena penguji tidak menerima undangan awal.

Solusi 1

1. Minta penguji untuk memeriksa folder spam dan filter email apapun yang mereka tetapkan di layanan email.

2. Jika penguji berhenti berlangganan email tersebut, minta penguji untuk melakukan tindakan berikut:

   1. Temukan email yang sebelumnya diterima penguji dari aplikasi tersebut.
   2. Klik Manage email settings di bagian bawah dan klik Allow emails untuk berlangganan lagi.

Solusi 2

Jika tidak ingin mendapatkan notifikasi email dan hanya ingin menerima undangan aplikasi, penguji dapat melihat undangan aplikasi yang menunggu keputusan secara langsung di klip web Firebase App Distribution: appdistribution.firebase.google.com.

Catatan: Untuk melihat undangan aplikasi yang menunggu keputusan, alamat email Akun Google yang digunakan penguji untuk login ke klip web harus cocok dengan alamat email penerima undangan dari developer.

Solusi 3

1. Hapus penguji dari bagian Lihat semua penguji pada tab Penguji & Tab Grup di App Distribution di Firebase console. Tindakan ini akan menghapus undangan yang sudah ada.

2. Undang kembali penguji untuk menguji aplikasi Anda. Penguji akan menerima email undangan. Pastikan penguji undangan dengan alamat email yang sama dengan alamat tujuan pengiriman undangan.

Error "Developer Perusahaan Tidak Tepercaya" saat mencoba menjalankan aplikasi pengujian

Pesan Error Untrusted Enterprise Developer muncul jika Anda tidak memercayai sertifikat developer di perangkat pengujian sebelum membuka aplikasi. Di aplikasi Setelan > layar Pengelolaan Profil & Perangkat, pilih nama developer aplikasi lalu percayai.

Error "Mode Developer Diperlukan" saat mencoba menjalankan aplikasi pengujian

Error Mode Developer Diperlukan muncul saat Anda mencoba meluncurkan aplikasi iOS yang disediakan ad hoc di iOS 16 atau yang lebih baru tanpa mengaktifkan Mode Developer terlebih dahulu.

Untuk mengaktifkan Mode Developer dan menyelesaikan error ini, ikuti langkah-langkah berikut:

1. Di iPhone, buka aplikasi Settings, lalu ketuk Privacy & Security.
2. Scroll ke bawah ke Diperlukan dan ketuk Mode Developer.
3. Ketuk penggeser Mode Developer.
4. Ketuk Mulai ulang.
5. Setelah perangkat dimulai ulang, buka kunci perangkat. Dialog Aktifkan Mode Developer? akan muncul.
6. Ketuk Aktifkan. Sekarang Anda dapat meluncurkan aplikasi dan memulai pengujian.

"Perangkat terdaftar, Anda sudah siap! Anda akan mendapatkan email saat aplikasi siap diuji"

Jika Anda menginstal distribusi Ad Hoc, pesan ini akan muncul saat developer belum mengonfigurasi aplikasi mereka untuk berjalan di perangkat pengujian Anda. Agar aplikasi tersedia untuk Anda, developer harus menyelesaikan petunjuk dalam Mendaftarkan perangkat tambahan.

Catatan: Jika developer telah mendistribusikan build dengan nomor dan versi build yang sama, hanya pengguna perangkat yang baru terdaftar yang akan menerima notifikasi email.

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.

Ingat hal berikut:

• Akun Google yang Anda gunakan untuk menerima undangan mungkin tidak sama dengan Akun Google yang awalnya menerima undangan tersebut.
• Akun Google dapat dikaitkan dengan alamat email mana pun, bukan hanya alamat dengan domain Gmail atau G Suite. Pelajari cara login dengan alamat email lain.

Error 403: "Hubungi admin Anda untuk meminta akses"

Jika mengalami error 403, artinya 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 untuk mengubah setelan akun Anda. Admin Anda harus mengikuti petunjuk di Mengelola akses ke layanan yang tidak dikontrol secara terpisah.

Jika Anda memiliki beberapa akun, coba login dengan akun lain yang tidak dibatasi dalam menginstal dan menguji aplikasi.

Mengaktifkan pemberitahuan dalam aplikasi dengan App Distribution iOS SDK

Gunakan tips berikut untuk memecahkan masalah yang terkait dengan mengaktifkan pemberitahuan build baru dalam aplikasi menggunakan App Distribution iOS 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:

1. Aktifkan mode debug di aplikasi Anda. Untuk mempelajari caranya, lihat dokumentasi Google Analytics.

2. Jalankan aplikasi Anda di simulator dan telusuri string "[Firebase/AppDistribution]".

3. Periksa apakah penguji memiliki akses ke rilis baru:

   • Jika objek rilis yang valid telah ditampilkan, kemungkinan ada masalah dalam siklus proses View Controller tempat dialog pemberitahuan dimuat sebelum View tersebut muncul.

     Catatan: App Distribution iOS SDK tidak ditampilkan dialog pemberitahuan secara default. Anda harus menentukan cara dan tempat dialog ditampilkan di aplikasi. Untuk mempelajari lebih lanjut, lihat Konfigurasi pemberitahuan dasar.

   • 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 build Anda didistribusikan dan berada dalam status Diterima.

     Jika penguji masih tidak menerima update, minta mereka untuk mengikuti tips di bawah guna memastikan mereka menerima undangan untuk menguji aplikasi Anda dan bahwa mereka menyiapkan perangkat pengujian dengan benar:

     1. Di perangkat uji, login ke web Firebase App Distribution (jangan lupa untuk memilih Akun Google yang pertama kali Anda gunakan saat menerima undangan untuk menguji aplikasi tersebut).

     2. Pastikan 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 Firebase App Testers API. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan App Distribution Tester API.

• Di bagian Pembatasan kunci, pastikan bahwa Firebase App Testers API disertakan dalam daftar API yang diizinkan.

• Jika Anda biasanya menghapus UserDefaults saat logout, status penguji milik Anda akan dapat terhapus juga. App Distribution menyimpan flag yang menunjukkan apakah penguji Anda sudah login ke aplikasi atau belum. Untuk mengetahui informasi selengkapnya, lihat repositori GitHub.

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

Untuk menambahkan lebih banyak penguji, ajukan peningkatan batas tanpa biaya.

Apakah masa berlaku undangan penguji saya akan berakhir?

Penguji memiliki waktu 30 hari untuk menerima undangan pengujian aplikasi sebelum masa berlakunya habis. Saat masa berlaku undangan akan berakhir dalam 5 hari, notifikasi habisnya masa berlaku akan muncul di Firebase console di samping penguji pada rilis. Undangan dapat diperpanjang dengan pengiriman ulang melalui menu drop-down pada baris penguji.

Kapan rilis baru dibuat untuk mengupload di iOS?

Lihat bagian Mendaftarkan perangkat tambahan.

Berapa lama rilis aplikasi tersedia?

Rilis aplikasi dihapus dari App Distribution jika salah satu kondisi berikut terjadi:

• Rilis aplikasi lebih dari 150 hari.
• Anda telah melampaui batas 1.000 rilis aplikasi, dan rilis aplikasi tersebut lebih lama dari 1.000 rilis aplikasi yang terbaru.

Untuk mengetahui informasi selengkapnya, lihat App Distribution mendukung maksimum 1.000 rilis.

Setelah aplikasi mencapai atau melampaui batas akhir 150 hari atau 1.000 rilis aplikasi, rilis aplikasi tersebut akan dihapus dari dasbor App Distribution dan aplikasi web penguji App Distribution. Jika penguji telah menginstal rilis tersebut, versi lokal aplikasinya akan terus berjalan.

Agar rilis aplikasi tetap tersedia lebih lama, gunakan salah satu rekomendasi berikut:

• Sebelum rilis aplikasi berakhir masa berlakunya atau melebihi batas rilis, download IPA dan hapus rilis tersebut dari dasbor App Distribution. Lalu, upload ulang IPA sebagai build baru ke App Distribution.
• Download dan upload rilis ke Cloud Storage untuk pengarsipan jangka panjang.

Rilis aplikasi berakhir setelah 150 hari

Saat Anda mengupload sebuah rilis aplikasi ke Firebase, rilis tersebut akan muncul di dasbor App Distribution selama 150 hari, dimulai dari tanggal upload. Setelah mengupload rilis tersebut, Anda dapat mendistribusikannya kepada penguji, yang kemudian menginstal rilis tersebut dari aplikasi web penguji App Distribution di perangkat pengujian mereka sendiri.

Jika rilis berjarak 30 hari dari tanggal habis masa berlaku, rilis aplikasi notifikasi masa berlaku habis akan muncul pada rilis Anda di halaman App Distribution pada Firebase console dan di aplikasi web penguji App Distribution.

App Distribution mendukung maksimum 1.000 rilis

App Distribution mengizinkan maksimum 1.000 rilis per aplikasi. Saat aplikasi Anda mencapai batas 1.000 rilis aplikasi, App Distribution akan otomatis menghapus rilis terlama yang melebihi batas.

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.

Apa yang dimaksud dengan profil Firebase?

Profil Firebase adalah profil konfigurasi yang memungkinkan App Distribution:

• 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.

• Instal klip web Firebase App Distribution ke rumah perangkat Anda layar. 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:

1. Jika Anda belum melakukannya, login ke Google dan terima undangan.

2. Di bagian Aplikasi pengujian, pilih aplikasi yang ingin diuji.

3. Di kanan atas halaman aplikasi, ketuk .

4. Ikuti petunjuk yang ditampilkan untuk menginstal profil Firebase.

Bagaimana cara menghapus akun penguji?

Untuk menghapus akun penguji App Distribution dan data yang terkait, ikuti langkah-langkah ini secara berurutan:

1. Buka https://appdistribution.firebase.google.com dan login dengan Akun Google Anda.

2. Di kanan atas, klik (Kelola akun)

   Hapus akun.

3. 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.