Memecahkan masalah opsi inisialisasi

Jika Anda menginisialisasi aplikasi tanpa kumpulan opsi Firebase yang valid, pengguna baru aplikasi Anda akan mengalami masalah serius.

Opsi Firebase adalah kumpulan parameter yang diperlukan oleh layanan agar berhasil berkomunikasi dengan API server Firebase dan mengaitkan data klien dengan project Firebase serta aplikasi Firebase Anda. Layanan Firebase mengandalkan opsi Firebase valid yang tersedia dari library inti/umum Firebase yang dibuat selama inisialisasi Firebase.

Berbagai layanan Firebase memerlukan opsi Firebase yang berbeda-beda agar dapat berfungsi dengan baik, tetapi semuanya memerlukan opsi Firebase berikut:

  • Kunci API - Catatan: ini bukan kunci server FCM, lihat kunci server FCM.
    Contoh nilai: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
  • Project ID - Contoh nilai: myapp-project-123.
  • ID Aplikasi ("AppID") - ID unik untuk aplikasi Anda yang formatnya bergantung pada platform:
    • Untuk Android: mobilesdk_app_id—Catatan: ini bukan nama paket Android.
      Contoh nilai: 1:1234567890:android:321abc456def7890
    • Untuk iOS+: GOOGLE_APP_ID—Catatan: ini bukan ID Paket Apple.
      Contoh nilai: 1:1234567890:ios:321abc456def7890

Memecahkan masalah aplikasi Android

Untuk meningkatkan keamanan, update Firebase SDK pada 27 Februari dan selanjutnya telah mengganti layanan Firebase Instance ID dengan dependensi pada Firebase Installations API.

Penginstalan Firebase menerapkan keberadaan dan validitas kunci API, project ID, dan ID Aplikasi yang ketiganya merupakan opsi Firebase wajib untuk mengaitkan data klien dengan project Firebase Anda. Lihat FirebaseOptions untuk mengetahui informasi selengkapnya.

Firebase Cloud Messaging (FCM) dengan Firebase Instance ID (IID)

Jika pengguna baru aplikasi Anda mengalami masalah pada FCM, mungkin Anda menginisialisasi Firebase tanpa rangkaian opsi Firebase yang diperlukan.

Aplikasi Anda mungkin menggunakan file konfigurasi google-services.json yang tidak lengkap atau salah; atau aplikasi Anda menginisialisasi Firebase secara terprogram tanpa kumpulan opsi Firebase lengkap yang diperlukan.

Akibatnya, layanan Firebase seperti Firebase Cloud Messaging akan mengalami malfungsi bagi pengguna akhir yang menginstal aplikasi Anda setelah dirilis dengan Firebase SDK yang telah diupdate. Selain itu, permintaan ke Firebase yang berulang kali gagal dapat memperlambat pengalaman pengguna akhir aplikasi Anda.

Apa yang harus saya lakukan?

Untuk memperbaiki layanan Firebase yang tidak berfungsi sebagaimana mestinya bagi aplikasi Anda:

  1. Update aplikasi Anda dengan menginisialisasi Firebase menggunakan kunci API project Anda, Project ID, dan ID Aplikasi (mobilesdk_app_id atau "App Id") yang semuanya masih valid.
  2. Rilis versi baru aplikasi Anda ke Play Store.

Memecahkan masalah aplikasi Apple

Untuk meningkatkan keamanan, update Firebase SDK pada 14 Januari dan setelahnya menggantikan layanan Firebase Instance ID yang memiliki dependensi pada Firebase Installations API.

Penginstalan Firebase menerapkan keberadaan dan validitas kunci API, project ID, dan ID Aplikasi yang ketiganya merupakan opsi Firebase wajib untuk mengaitkan data klien dengan project Firebase Anda. Lihat FIROptions untuk mengetahui informasi selengkapnya.

Firebase Cloud Messaging (FCM) dengan Firebase Instance ID (IID)

Jika pengguna baru aplikasi Anda mengalami masalah pada FCM, mungkin Anda menginisialisasi Firebase tanpa rangkaian opsi Firebase yang diperlukan.

Aplikasi Anda mungkin menggunakan file konfigurasi GoogleService-Info.plist yang tidak lengkap atau tidak valid; atau aplikasi Anda menginisialisasi Firebase secara terprogram tanpa kumpulan opsi Firebase lengkap yang diperlukan.

Akibatnya, layanan Firebase seperti Firebase Cloud Messaging akan mengalami malfungsi bagi pengguna akhir yang menginstal aplikasi Anda setelah dirilis dengan Firebase SDK yang telah diupdate. Selain itu, permintaan ke Firebase yang berulang kali gagal dapat memperlambat pengalaman pengguna akhir aplikasi Anda.

Apa yang harus saya lakukan?

Untuk memperbaiki layanan Firebase yang tidak berfungsi sebagaimana mestinya bagi aplikasi Anda:

  1. Update aplikasi Anda dengan menginisialisasi Firebase menggunakan kunci API project Anda, Project ID, dan ID Aplikasi (GOOGLE_APP_ID atau "App Id") yang semuanya masih valid.
    1. Proses inisialisasi default menggunakan file konfigurasi Firebase: Download file konfigurasi GoogleService-Info.plist Anda dari Firebase console, lalu ganti file yang ada di aplikasi Anda.
    2. Inisialisasi terprogram menggunakan objek FIROptions: Download file konfigurasi GoogleService-Info.plist Anda dari Firebase console untuk menemukan kunci API, Project ID, dan ID Aplikasi, kemudian perbarui nilai ini dalam objek FIROptions di aplikasi Anda.
  2. Rilis versi baru aplikasi Anda ke App Store.

Kunci Server FCM

Jika aplikasi Anda menggunakan kunci Server FCM, bukan kunci Cloud API, dapat terjadi kerentanan keamanan jika Anda menggunakan kunci Server FCM yang sama untuk mengirim notifikasi push melalui FCM. Dalam kasus ini, Anda sangat disarankan untuk merevisi cara autentikasi permintaan pengiriman ke FCM pada server Anda.

Perhatikan bahwa Kunci Server FCM (yang tidak sama dengan kunci Firebase/Cloud API) tidak boleh disertakan dalam aplikasi, karena dapat disalahgunakan untuk mengirim notifikasi push atas nama project Anda.