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>. Kunjungi App Distribution 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 file APK

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

2. Jika ukuran APK tersebut berada dalam batas ukuran file dan dapat direproduksi, hubungi Dukungan Firebase.

Tidak dapat mengupload APK dengan fastlane. APK tidak ditandatangani.

Pastikan APK telah ditandatangani menggunakan:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Mendistribusikan Android App Bundle (AAB)

Mengalami error dengan penyedia login sosial/API pihak ketiga

Saat Anda mengupload AAB ke App Distribution, Google Play secara otomatis menandatangani ulang APK yang dihasilkan menggunakan sertifikat kunci penandatanganan aplikasi pengujian. Saat diminta, Anda harus mendaftarkan aplikasi ke penyedia API jika ingin terus menggunakan layanan pihak ketiga. Setelah ditandatangani, sertifikat pengujian aplikasi Anda dapat dilihat di Firebase console.

Apakah AAB yang saya upload juga muncul di Google Play?

Build AAB yang Anda upload ke App Distribution tidak muncul di akun Developer Google Play (termasuk Penjelajah App Bundle dan fitur berbagi aplikasi internal).

Apa yang terjadi jika saya membatalkan tautan Firebase dari Google Play?

Jika Aplikasi Android Firebase dibatalkan tautannya dari Google Play, hal berikut akan terjadi:

• Anda tidak akan dapat mengupload app bundle baru ke App Distribution dan mengekspornya ke Google Play melalui integrasi App Distribution dengan Google Play.

• Build yang sudah ada akan terus tersedia di dasbor Firebase App Distribution dan untuk penguji.

• Data apa pun yang sebelumnya diekspor antara Firebase dan Google Play akan tetap dapat diakses di kedua produk.

Dapatkah saya mencoba menautkan aplikasi ke Google Play lagi?

Untuk mendistribusikan Android App Bundle (AAB) melalui App Distribution dan secara otomatis menautkan AAB yang diupload ke project Firebase dan akun Developer Google Play, pastikan bahwa Anda memenuhi persyaratan berikut:

• Akun Developer Google Play Anda memiliki salah satu tingkat akses berikut: Pemilik atau Admin.

• Untuk project Firebase, Anda memiliki salah satu peran berikut: Pemilik atau Admin Firebase.

• Aplikasi Anda terdaftar pada Firebase dan akun developer Google Play Anda. Ini berarti Anda memiliki aplikasi Android Firebase dan aplikasi Google Play.

• Aplikasi di Google Play dan aplikasi Android Firebase terdaftar menggunakan nama paket yang sama.

• Aplikasi di Google Play disiapkan di dasbor aplikasi dan didistribusikan ke salah satu jalur Google Play (Pengujian internal, Pengujian tertutup, Pengujian terbuka, atau Produksi).

• Peninjauan aplikasi di Google Play selesai dan aplikasi sudah dipublikasikan. Aplikasi Anda dianggap sudah dipublikasikan jika kolom Status aplikasi menampilkan salah satu status berikut: Pengujian internal (bukan Draf pengujian internal), Pengujian tertutup, Pengujian terbuka, atau Produksi.

Jika Anda mengupload aplikasi yang sebelumnya tidak memenuhi kriteria untuk penautan yang tercantum di atas, tetapi sekarang telah memenuhinya, Anda dapat mencoba lagi menautkan Aplikasi Android Firebase Anda ke Google Play.

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 View all testers di tab Testers & Groups di halaman App Distribution di 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 secara 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 penguji tidak ingin menerima notifikasi email, tetapi ingin dapat menerima undangan aplikasi, mereka dapat melihat undangan aplikasi yang menunggu keputusan secara langsung di aplikasi App Tester (instruksi download).

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

Solusi 3

1. Hapus penguji dari bagian View all testers di tab Testers & Groups di halaman 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.

Aplikasi tidak menunjukkan bahwa aplikasi telah diinstal

Jika penguji mendownload dan menginstal rilis tetapi antarmuka pengguna detail aplikasi tidak menunjukkan bahwa aplikasi telah diinstal, ini adalah masalah umum. Dalam beberapa kasus, ID paket di aplikasi Firebase tidak cocok dengan ID paket APK.

Pastikan bahwa ID paket APK cocok dengan ID paket aplikasi Firebase yang Anda gunakan untuk mengupload distribusi.

Pemberitahuan Android yang menyatakan bahwa perangkat saya tidak dapat menginstal aplikasi yang tidak dikenal

Peringatan Android muncul jika aplikasi atau browser yang sedang berjalan belum diberikan izin untuk menginstal aplikasi di luar Google Play. Untuk memberikan izin:

• Android versi 8 atau yang lebih baru: Di aplikasi Setelan, ketuk Izinkan dari sumber ini.

• Android versi 7 atau yang lebih lama: Di aplikasi Setelan, ketuk Keamanan lalu pilih Sumber tidak dikenal. Saat perintah muncul, ketuk Oke > Percayai.

APK pengujian gagal diinstal

Jika APK pengujian gagal diinstal di perangkat penguji:

• Pastikan bahwa sertifikat dalam versi yang baru cocok dengan yang ada pada versi yang diinstal di perangkat penguji. Sistem Android hanya mengizinkan aplikasi untuk diupdate jika sertifikat cocok. Untuk mempelajari lebih lanjut, lihat Pertimbangan penandatanganan.
• Pastikan versi OS perangkat penguji didukung oleh aplikasi (periksa minSdkVersion).

Tidak dapat login ke Aplikasi App Tester Android

Jika aplikasi App Tester mencegah Anda login dan mengalihkan Anda kembali ke layar login, Anda mungkin menggunakan Google Workspace (sebelumnya G Suite) yang mencakup setelan pembatasan.

Untuk menghapus setelan pembatasan:

1. Di tab Aplikasi di Google Workspace, pastikan Firebase App Distribution tidak ditetapkan ke Akses: Diblokir.

2. Di tab Layanan, pastikan Cloud Platform tidak dibatasi.

3. Setelah setelan dihapus, coba login lagi.

Terjadi error saat menginstal AAB: "Tidak dapat menginstal aplikasi"

Error ini dapat terjadi jika aplikasi yang diinstal bertentangan dengan aplikasi yang sudah diinstal di perangkat. Misalnya, varian tersebut dapat berupa varian yang berbeda dari aplikasi yang sama dengan izin kustom atau nama ContentProvider yang sama.

Anda dapat meminta penguji untuk mengumpulkan laporan bug segera setelah mengalami masalah, dan memeriksa laporan tersebut untuk mengetahui informasi selengkapnya tentang penyebabnya. Penguji harus menghapus aplikasi yang bertentangan sebelum aplikasi baru dapat diinstal.

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.

Menguji di perangkat Android baru

Jika ini pertama kalinya Anda menguji, lihat Melakukan penyiapan sebagai penguji.

Jika Anda adalah penguji App Distribution lama dan mendapatkan perangkat Android baru untuk diuji, bukan pertama kali menguji, ikuti langkah-langkah berikut:

1. Buka appdistribution.firebase.google.com di perangkat Android Anda.

2. Login dengan akun penguji yang ada, lalu klik tombol Download App Tester di bagian bawah layar untuk menginstal aplikasi Android App Tester.

Mengaktifkan fitur penguji dengan App Distribution Android SDK

Gunakan tips berikut untuk memecahkan masalah yang terkait dengan mengaktifkan pemberitahuan build baru dalam aplikasi atau mengirimkan masukan dalam aplikasi menggunakan App Distribution Android SDK.

Penguji tidak dapat memulai masukan di aplikasi

Jika Anda telah menyiapkan App Distribution Android SDK pada aplikasi untuk mendukung masukan dalam aplikasi dan penguji tidak dapat mengirimkan masukan, ikuti langkah-langkah berikut:

1. Aktifkan logging panjang untuk App Distribution Android SDK di aplikasi Anda:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Periksa pesan error di log aplikasi Anda dengan memfilter "FirebaseAppDistribution".

3. Pastikan penguji memiliki akses ke rilis yang telah diinstal:

   1. Jika log menunjukkan bahwa "penguji tidak memiliki akses ke resource ini", penguji mungkin belum diundang ke aplikasi, atau mungkin tidak memiliki akses ke rilis.

   2. Di dasbor App Distribution pada Firebase console, temukan rilis persis yang dijalankan di perangkat penguji, dan pastikan penguji tercantum pada tab Testers di kartu rilis dan dalam status Diterima.

   Jika Anda masih belum menerima masukan, ikuti langkah-langkah berikut:

   1. Di perangkat uji, login ke Firebase App Distribution menggunakan App Tester atau aplikasi web penguji. Pastikan Anda memilih Akun Google yang pertama kali digunakan saat Anda menerima undangan untuk menguji aplikasi.

   2. Instal aplikasi lagi menggunakan App Tester atau aplikasi web pengujian untuk memastikan bahwa penguji memiliki akses ke rilis.

   3. Coba kirimkan masukan lagi. Pastikan Anda login dengan Akun Google yang sama.

4. Pastikan Anda mengaktifkan Firebase App Testers API. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan App Distribution Tester API.

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

Tidak menerima masukan yang dikirim di aplikasi

1. Jika Anda melihat pesan ini saat mengirimkan masukan, "Akan mengirim masukan, tetapi tidak karena mode pengembangan", nonaktifkan mode developer di perangkat dengan menjalankan perintah ini:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Periksa file google-services.json Anda untuk memastikan Anda mengirimkan masukan untuk project dan aplikasi yang benar.

3. Aktifkan logging panjang untuk App Distribution Android SDK di aplikasi Anda:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Periksa pesan error di log aplikasi Anda dengan memfilter "FirebaseAppDistribution".

Penguji tidak menerima pemberitahuan dalam aplikasi

Jika Anda telah menyiapkan App Distribution Android SDK pada aplikasi dan penguji Anda tidak menerima pemberitahuan dalam aplikasi, ikuti langkah-langkah berikut:

1. Periksa pesan error dengan melampirkan OnFailureListener ke Tugas yang ditampilkan oleh Firebase App Distribution API.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. Periksa apakah penguji memiliki akses ke 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 "FirebaseAppDistribution".

      Jika log menunjukkan bahwa tidak ada rilis yang ditemukan, atau bahwa penguji tidak memiliki akses, penguji Anda mungkin belum dikaitkan dengan rilis baru.

   3. Di dasbor App Distribution pada Firebase console, pastikan penguji disertakan dalam distribusi build dan berstatus Diterima.

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

      1. Di perangkat pengujian, login ke Firebase App Distribution melalui App Tester atau melalui aplikasi web penguji. Ingat untuk memilih Akun Google yang pertama kali digunakan saat Anda menerima undangan untuk menguji aplikasi tersebut.

      2. Periksa untuk memastikan bahwa rilis aplikasi baru tersedia di App Tester atau aplikasi web penguji.

Penguji diminta untuk login lagi setelah menutup aplikasi

Secara default, penguji hanya perlu login ke Akun Google miliknya sekali untuk mengaktifkan fitur pengujian. Jika penguji diminta untuk login lagi setelah menutup dan membuka kembali aplikasi Anda, 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 SharedPreferences 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 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.

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 informasi selengkapnya, lihat App Distribution mendukung maksimal 1.000 rilis.

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

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

• Sebelum rilis aplikasi berakhir atau melebihi batas rilis, download APK atau AAB dan hapus rilis dari dasbor App Distribution. Kemudian, upload ulang APK atau AAB sebagai build baru ke App Distribution.
• Download rilis dan upload rilis tersebut 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 akan menginstal rilis tersebut dari aplikasi Firebase App Tester di perangkat pengujian mereka sendiri.

Saat rilis berjarak 30 hari dari tanggal habis masa berlakunya, notifikasi masa berakhir rilis aplikasi akan muncul pada rilis Anda di aplikasi Firebase App Tester.

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

Bagaimana cara mengakses aplikasi pengujian yang saya instal di perangkat?

Jika Anda adalah seorang penguji, sebaiknya download Firebase App Tester, yakni aplikasi yang memungkinkan Anda mengakses semua build pengujian di satu tempat.

Bagaimana cara menghapus akun penguji?

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

1. Kunjungi 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.