Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Dépannage des options d'initialisation

Si vous initialisez votre application sans un ensemble valide d'options Firebase, les nouveaux utilisateurs de votre application rencontreront de sérieux problèmes.

Les options Firebase sont un ensemble de paramètres requis par les services afin de communiquer avec succès avec les API du serveur Firebase et d'associer les données client à votre projet Firebase et à votre application Firebase. Les services Firebase reposent sur des options Firebase valides disponibles à partir de la bibliothèque principale/commune Firebase créée lors de l'initialisation de Firebase.

Différents services Firebase nécessitent différentes options Firebase pour fonctionner correctement, mais tous les services Firebase nécessitent les options Firebase suivantes :

  • Clé API - Remarque : il ne s'agit pas d' une clé de serveur FCM, voir Clés de serveur FCM .
    Exemple de valeur : AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
  • ID de projet - Exemple de valeur : myapp-project-123 .
  • ID d'application ("AppID") - Identifiant unique de votre application dont le format dépend de la plate-forme :
    • Pour Android : mobilesdk_app_id —Remarque : il ne s'agit pas d'un nom de package Android .
      Exemple de valeur : 1:1234567890:android:321abc456def7890
    • Pour iOS : GOOGLE_APP_ID —Remarque : il ne s'agit pas d'un identifiant Apple Bundle .
      Exemple de valeur : 1:1234567890:ios:321abc456def7890

Résoudre les problèmes d'applications Android

Pour améliorer la sécurité, le SDK Firebase a été mis à jour le 27 février et a ensuite remplacé le service Firebase Instance ID par une dépendance à l' API Firebase Installations .

Les installations Firebase imposent l'existence et la validité de la clé API, de l'ID de projet et de l'ID d'application des options Firebase obligatoires afin d'associer les données client à votre projet Firebase. Voir FirebaseOptions pour plus d'informations.

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

Si de nouveaux utilisateurs de votre application rencontrent des problèmes avec FCM, il est possible que vous initialisiez Firebase sans l'ensemble d'options Firebase requis.

Votre application utilise peut-être un fichier de configuration google-services.json incomplet ou erroné ; ou votre application initialise Firebase par programmation sans l'ensemble complet des options Firebase requises.

Par conséquent, les services Firebase tels que Firebase Cloud Messaging fonctionneront mal pour les utilisateurs finaux qui ont installé votre application après sa publication avec les SDK Firebase mis à jour. De plus, des requêtes infructueuses répétées à Firebase peuvent ralentir l'expérience de l'utilisateur final de votre application.

Qu'est-ce que je dois faire?

Pour corriger les dysfonctionnements des services Firebase pour vos applications :

  1. Mettez à jour votre application en initialisant Firebase avec une clé API valide de votre projet, un ID de projet valide et un ID d'application valide ( mobilesdk_app_id ou "App Id").
  2. Publiez une nouvelle version de votre application sur le Play Store.

Dépannage des applications iOS

Pour améliorer la sécurité, le SDK Firebase a été mis à jour le 14 janvier et a ensuite remplacé le service Firebase Instance ID par une dépendance à l' API Firebase Installations .

Les installations Firebase imposent l'existence et la validité de la clé API, de l'ID de projet et de l'ID d'application des options Firebase obligatoires afin d'associer les données client à votre projet Firebase. Voir FIROptions pour plus d'informations.

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

Si de nouveaux utilisateurs de votre application rencontrent des problèmes avec FCM, il est possible que vous initialisiez Firebase sans l'ensemble d'options Firebase requis.

Votre application utilise peut-être un fichier de configuration GoogleService-Info.plist incomplet ou invalide ; ou votre application initialise Firebase par programmation sans l'ensemble complet des options Firebase requises.

Par conséquent, les services Firebase tels que Firebase Cloud Messaging fonctionneront mal pour les utilisateurs finaux qui ont installé votre application après sa publication avec les SDK Firebase mis à jour. De plus, des requêtes infructueuses répétées à Firebase peuvent ralentir l'expérience de l'utilisateur final de votre application.

Qu'est-ce que je dois faire?

Pour corriger les dysfonctionnements des services Firebase pour vos applications :

  1. Mettez à jour votre application en initialisant Firebase avec une clé API valide de votre projet, un ID de projet valide et un ID d'application valide ( GOOGLE_APP_ID ou "App Id").
    1. Processus d'initialisation par défaut à l'aide d'un fichier de configuration Firebase : Téléchargez votre fichier de configuration GoogleService-Info.plist depuis la console Firebase, puis remplacez le fichier existant dans votre application.
    2. Initialisation par programmation à l'aide d'un objet FIROptions : téléchargez votre fichier de configuration GoogleService-Info.plist depuis la console Firebase pour trouver votre clé API, votre ID de projet et votre ID d'application, puis mettez à jour ces valeurs dans l'objet FIROptions de votre application.
  2. Publiez une nouvelle version de votre application sur l'App Store.

Clés du serveur FCM

Si votre application utilise une clé de serveur FCM plutôt qu'une clé d'API Cloud, cela pourrait entraîner une vulnérabilité de sécurité si vous utilisez la même clé de serveur FCM pour envoyer des notifications push via FCM. Dans ce cas, nous vous recommandons fortement de revoir la façon dont votre serveur authentifie les requêtes envoyées à FCM .

Notez que les clés de serveur FCM (qui ne sont pas les mêmes que les clés d'API Firebase/Cloud) ne doivent pas être incluses dans les applications, car elles peuvent être utilisées abusivement pour envoyer des notifications push au nom de votre projet.