Dépanner les 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 du projet – Exemple de valeur : myapp-project-123 .
  • Application ID ("AppID") - Identifiant unique de votre application dont le format dépend de la plateforme :
    • 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

Dépanner les 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 obligatoires des options Firebase 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 les 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 programme sans l'ensemble complet des options Firebase requises.

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

Qu'est-ce que je dois faire?

Pour réparer les services Firebase défectueux 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épanner les applications Apple

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 obligatoires des options Firebase 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 les 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 programme sans l'ensemble complet des options Firebase requises.

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

Qu'est-ce que je dois faire?

Pour réparer les services Firebase défectueux 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 programmatique à l'aide d'un objet FIROptions : téléchargez votre fichier de configuration GoogleService-Info.plist depuis la console Firebase pour rechercher 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 l'envoi des requêtes à FCM .

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