Ajouter Firebase à votre projet Apple

Conditions préalables

• Installez les éléments suivants :

  • Xcode 13.3.1 ou version ultérieure

• Assurez-vous que votre projet répond à ces exigences :

  • Votre projet doit cibler ces versions de plateforme ou ultérieures :
    • iOS 10
    • mac OS 10.12
    • tvOS 12
    • watchOS 6

• Configurez un appareil Apple physique ou utilisez un simulateur pour exécuter votre application.

  Voulez-vous utiliser Cloud Messagerie ?

  Pour Cloud Messaging sur les plateformes Apple, voici les prérequis :

  • Configurez un appareil Apple physique .
  • Obtenez une clé d'authentification Apple Push Notification pour votre compte développeur Apple .
  • Activez les notifications push dans Xcode sous App > Capabilities .

• Connectez-vous à Firebase à l'aide de votre compte Google.

Si vous n'avez pas encore de projet Xcode et que vous souhaitez simplement essayer un produit Firebase, vous pouvez télécharger l'un de nos exemples de démarrage rapide .

Étape 1 : Créer un projet Firebase

Avant de pouvoir ajouter Firebase à votre application Apple, vous devez créer un projet Firebase pour vous connecter à votre application. Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase.

Créer un projet Firebase

1. Dans la console Firebase , cliquez sur Ajouter un projet .

   • Pour ajouter des ressources Firebase à un projet Google Cloud existant , saisissez son nom de projet ou sélectionnez-le dans le menu déroulant.

   • Pour créer un nouveau projet, entrez le nom du projet souhaité. Vous pouvez également éventuellement modifier l'ID du projet affiché sous le nom du projet.

     Firebase génère un identifiant unique pour votre projet Firebase en fonction du nom que vous lui donnez. Si vous souhaitez modifier cet ID de projet, vous devez le faire maintenant car il ne peut pas être modifié une fois que Firebase a provisionné des ressources pour votre projet. Consultez Comprendre les projets Firebase pour découvrir comment Firebase utilise l'ID de projet.

2. Si vous y êtes invité, lisez et acceptez les conditions d'utilisation de Firebase .

3. Cliquez sur Continuer .

4. (Facultatif) Configurez Google Analytics pour votre projet, ce qui vous permet d'avoir une expérience optimale avec l'un des produits Firebase suivants :

   Firebase Crashlytics Messagerie cloud Firebase

   Messagerie intégrée à l'application Firebase Configuration à distance de Firebase

   Personnalisation de la configuration à distance Test A/B Firebase

   Sélectionnez un compte Google Analytics existant ou créez un nouveau compte.

   Si vous créez un nouveau compte, sélectionnez votre emplacement de rapport Analytics , puis acceptez les paramètres de partage de données et les conditions Google Analytics pour votre projet.

   Vous pouvez toujours configurer Google Analytics plus tard dans l'onglet Intégrations de vos du projet .

5. Cliquez sur Créer un projet (ou Ajouter Firebase si vous utilisez un projet Google Cloud existant).

Firebase fournit automatiquement des ressources pour votre projet Firebase. Une fois le processus terminé, vous serez redirigé vers la page de présentation de votre projet Firebase dans la console Firebase.

Étape 2 : Enregistrez votre application auprès de Firebase

Pour utiliser Firebase dans votre application Apple, vous devez enregistrer votre application avec votre projet Firebase. L'enregistrement de votre application est souvent appelé "ajouter" votre application à votre projet.

Remarque : Consultez nos bonnes pratiques pour ajouter des applications à un projet Firebase, y compris la gestion de plusieurs variantes.

1. Accédez à la console Firebase .

2. Au centre de la page de présentation du projet, cliquez sur l'icône iOS+ pour lancer le workflow de configuration.

   Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter une application pour afficher les options de plate-forme.

3. Entrez l'ID de bundle de votre application dans le champ ID de bundle .

   Qu'est-ce qu'un identifiant de bundle et où le trouve-t-on ?

   • Un ID de bundle identifie de manière unique une application dans l'écosystème d'Apple.

   • Trouvez votre bundle ID : ouvrez votre projet dans Xcode, sélectionnez l'application de niveau supérieur dans le navigateur de projet, puis sélectionnez l'onglet Général .

     La valeur du champ Bundle Identifier est l'ID du bundle (par exemple, com.yourcompany.yourproject ).

   • Sachez que la valeur de l'ID de groupe est sensible à la casse et qu'elle ne peut pas être modifiée pour cette application Firebase une fois qu'elle est enregistrée avec votre projet Firebase.

   Assurez-vous d'entrer l'ID de bundle que votre application utilise réellement. La valeur de l'ID de groupe est sensible à la casse et ne peut pas être modifiée pour cette application Apple Firebase après son enregistrement avec votre projet Firebase.

4. (Facultatif) Saisissez d'autres informations sur l'application : le surnom de l'application et l' identifiant de l'App Store .

   Comment le surnom de l'application et l' identifiant de l'App Store sont-ils utilisés dans Firebase ?

   • Pseudonyme d' application : un identifiant interne pratique qui n'est visible que par vous dans la console Firebase

   • App Store ID : utilisé par Firebase Dynamic Links pour rediriger les utilisateurs vers votre page App Store et par Google Analytics pour importer des événements de conversion dans Google Ads . Si votre application n'a pas encore d'identifiant App Store, vous pouvez ajouter l'identifiant ultérieurement dans les paramètres de votre projet .

5. Cliquez sur Enregistrer l'application .

Étape 3 : Ajouter un fichier de configuration Firebase

1. Cliquez sur Télécharger GoogleService-Info.plist pour obtenir le fichier de configuration de votre plate-forme Apple Firebase ( GoogleService-Info.plist ).

   Que devez-vous savoir sur ce fichier de configuration ?

   • Le fichier de configuration Firebase contient des identifiants uniques mais non secrets pour votre projet. Pour en savoir plus sur ce fichier de configuration, consultez Comprendre les projets Firebase .

   • Vous pouvez télécharger à nouveau votre fichier de configuration Firebase à tout moment.

   • Assurez-vous que le nom du fichier de configuration n'est pas ajouté avec des caractères supplémentaires, comme (2) .

2. Déplacez votre fichier de configuration à la racine de votre projet Xcode. Si vous y êtes invité, sélectionnez pour ajouter le fichier de configuration à toutes les cibles.

Si vous avez plusieurs ID de bundle dans votre projet, vous devez associer chaque ID de bundle à une application enregistrée dans la console Firebase afin que chaque application puisse avoir son propre fichier GoogleService-Info.plist .

Étape 4 : Ajoutez des SDK Firebase à votre application

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

Consultez notre guide d'installation pour en savoir plus sur les différentes manières d'ajouter des SDK Firebase à votre projet Apple, y compris l'importation directe de frameworks et l'utilisation de CocoaPods.

1. Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages .
2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Apple Firebase :

  https://github.com/firebase/firebase-ios-sdk

3. Sélectionnez la version du SDK que vous souhaitez utiliser.
   Remarque : Nous vous recommandons d'utiliser la version par défaut (la plus récente) du SDK, mais vous pouvez choisir une version plus ancienne si nécessaire.

4. Choisissez les bibliothèques Firebase que vous souhaitez utiliser.

   Si Google Analytics est activé dans votre projet Firebase, assurez-vous d'ajouter FirebaseAnalytics . Pour Analytics sans fonctionnalité de collecte d'IDFA, ajoutez plutôt FirebaseAnalyticsWithoutAdId .

Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Étape 5 : Initialisez Firebase dans votre application

La dernière étape consiste à ajouter le code d'initialisation à votre application. Vous l'avez peut-être déjà fait dans le cadre de l'ajout de Firebase à votre application. Si vous utilisez un exemple de projet de démarrage rapide , cela a été fait pour vous.

1. Importez le module FirebaseCore dans votre UIApplicationDelegate , ainsi que tout autre module Firebase utilisé par votre délégué d'application. Par exemple, pour utiliser Cloud Firestore et Authentification :

   Rapide

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objectif c

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) de votre délégué d'application :

   Rapide

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objectif c

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Si vous avez inclus le SDK Firebase pour Google Analytics, vous pouvez exécuter votre application pour confirmer à la console Firebase que vous avez correctement installé Firebase.

C'est ça! Vous pouvez passer directement aux étapes suivantes .

Si vous rencontrez des difficultés pour vous installer, consultez le dépannage et la FAQ des plates-formes Apple .

Remarque : Si vous ciblez macOS ou macOS Catalyst, vous devez ajouter la fonctionnalité de partage de trousseau à votre cible. Dans Xcode, accédez à l'onglet Signature et capacités de votre cible, puis cliquez sur + Capacités pour ajouter une nouvelle capacité.

Bibliothèques disponibles

Cette section répertorie les produits Firebase pris en charge pour les plates-formes Apple. En savoir plus sur ces bibliothèques de plate-forme Apple Firebase :

• Documentation de référence ( Swift | Obj-C )

• Dépôt GitHub du SDK des plates-formes Apple Firebase

Pour les applications qui utilisent CocoaPods, le pod Firebase est obsolète dans la v9.0 et les versions ultérieures. Au lieu de cela, vous devez référencer les pods de produits directement dans votre Podfile (par exemple, FirebaseCore au lieu de Firebase/Core et FirebaseFirestore au lieu de Firebase/Firestore ).

Service ou produit	Gousses	Bibliothèques SwiftPM	Ajouter des analyses ?
AdMob	pod 'Google-Mobile-Ads-SDK'	N / A
Analytique	pod 'FirebaseAnalytics'	FirebaseAnalytics
Vérification de l'application	pod 'FirebaseAppCheck'	FirebaseAppCheck
Distribution d'applications	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
Authentification	pod 'FirebaseAuth'	FirebaseAuth
Cloud Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
Cloud Functions pour le SDK client Firebase	pod 'FirebaseFunctions'	FirebaseFunctions
Messagerie en nuage	pod 'FirebaseMessaging'	FirebaseMessaging
Stockage en ligne	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
Liens dynamiques	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
Messagerie intégrée à l'application	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(obligatoire)
Installations Firebase	pod 'FirebaseInstallations'	FirebaseInstallations
API de modèle personnalisé Firebase ML	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
Suivi de la performance	pod 'FirebasePerformance'	FirebasePerformance
Base de données en temps réel	pod 'FirebaseDatabase'	FirebaseDatabase
Configuration à distance	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

Intégration sans utiliser Swift Package Manager

Si vous ne souhaitez pas utiliser Swift Package Manager, vous pouvez toujours profiter des SDK Firebase en utilisant CocoaPods ou en important directement les frameworks.

Cosses De Cacao

En savoir plus sur l'intégration de CocoaPods dans notre guide .

Cadres

En plus de prendre en charge la plate-forme iOS, le zip inclut désormais les fichiers .xcframework . Pour plus de détails, consultez le SDK README des plates-formes Apple Firebase sur GitHub .

1. Téléchargez le zip du SDK du framework . Il s'agit d'un fichier d'environ 200 Mo et le téléchargement peut prendre un certain temps.

2. Décompressez le fichier, puis consultez le README pour les frameworks que vous souhaitez inclure dans votre application.

3. Ajoutez le drapeau de l' éditeur de liens -ObjC dans vos Other Linker Settings de construction de votre cible.

Prochaines étapes

En savoir plus sur Firebase :

• Visitez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase et les meilleures pratiques pour les projets.

• Découvrez des exemples d'applications Firebase .

• Bénéficiez d'une expérience pratique avec Firebase iOS Codelab .

• Explorez le code open source dans GitHub .

• Préparez-vous à lancer votre application :

  • Configurez des alertes budgétaires pour votre projet dans Google Cloud Console.
  • Surveillez le tableau de bord d' utilisation et de facturation dans la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet sur plusieurs services Firebase.
  • Consultez la liste de contrôle de lancement de Firebase .

• Vous rencontrez des problèmes avec Firebase et votre projet Apple ? Visitez le dépannage et la FAQ des plates-formes Apple .

Ajoutez les services Firebase à votre application :

• Obtenez des informations sur le comportement des utilisateurs avec Analytics .

• Configurez l'authentification des utilisateurs avec Authentification .

• Stockez des données, telles que des informations utilisateur, avec Cloud Firestore ou Realtime Database .

• Stockez des fichiers, comme des photos et des vidéos, avec Cloud Storage .

• Déclenchez du code backend qui s'exécute dans un environnement sécurisé avec Cloud Functions .

• Envoyez des notifications avec Cloud Messaging .

• Découvrez quand et pourquoi votre application plante avec Crashlytics .