Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Dépanner les options d'initialisation

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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 .
  • Application ID ("AppID") - Identifiant unique pour 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

Dépanner les applications Android

Pour améliorer la sécurité, les mises à jour du SDK Firebase le 27 février ont ensuite remplacé le service Firebase Instance ID par une dépendance à l' API Firebase Installations .

Les installations de Firebase imposent l'existence et la validité de la clé d'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 ID d'instance Firebase (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 ne fonctionneront pas correctement pour les utilisateurs finaux qui ont installé votre application après sa sortie avec les SDK Firebase mis à jour. De plus, les demandes répétées d'échec à 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é, les mises à jour du SDK Firebase le 14 janvier ont ensuite remplacé le service Firebase Instance ID par une dépendance à l' API Firebase Installations .

Les installations de Firebase imposent l'existence et la validité de la clé d'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 ID d'instance Firebase (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 non valide ; 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 ne fonctionneront pas correctement pour les utilisateurs finaux qui ont installé votre application après sa sortie avec les SDK Firebase mis à jour. De plus, les demandes répétées qui échouent à 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 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 faille 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 demandes d'envoi à 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.