Conditions préalables
Installez les éléments suivants :
- Xcode 14.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 11
- macOS 10.13
- tvOS 12
- montreOS 6
- Votre projet doit cibler ces versions de plateforme ou ultérieures :
Configurez un appareil Apple physique ou utilisez un simulateur pour exécuter votre application.
Pour Cloud Messaging sur les plateformes Apple, voici les prérequis :
- Configurez un appareil Apple physique .
- Obtenez une clé d'authentification de notification push Apple pour votre compte de 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.
Étape 2 : Enregistrez votre application auprès de Firebase
Pour utiliser Firebase dans votre application Apple, vous devez enregistrer votre application auprès de votre projet Firebase. L'enregistrement de votre application est souvent appelé « ajouter » votre application à votre projet.
Accédez à la console Firebase .
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 la plateforme.
Saisissez l'ID du bundle de votre application dans le champ ID du bundle .
Un identifiant de bundle identifie de manière unique une application dans l'écosystème Apple.
Recherchez votre ID de bundle : 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 du bundle est sensible à la casse et qu'elle ne peut pas être modifiée pour cette application Firebase une fois qu'elle est enregistrée dans votre projet Firebase.
(Facultatif) Saisissez d'autres informations sur l'application : pseudonyme de l'application et identifiant App Store .
Pseudonyme de l'application : un identifiant interne pratique qui n'est visible que par vous dans la console Firebase
ID App Store : 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 ne dispose pas encore d'un identifiant App Store, vous pouvez ajouter l'identifiant ultérieurement dans les paramètres de votre projet .
Cliquez sur Enregistrer l'application .
Étape 3 : Ajouter un fichier de configuration Firebase
Cliquez sur Télécharger GoogleService-Info.plist pour obtenir le fichier de configuration de votre plate-forme Firebase Apple (
GoogleService-Info.plist
).Le fichier de configuration Firebase contient des identifiants uniques mais non secrets pour votre projet. Pour en savoir plus sur ce fichier de configuration, visitez 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 suivi de caractères supplémentaires, comme
(2)
.
Déplacez votre fichier de configuration à la racine de votre projet Xcode. Si vous y êtes invité, choisissez d'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.
- Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages .
- Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Apple Firebase :
- Sélectionnez la version du SDK que vous souhaitez utiliser.
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 capacité de collecte IDFA, ajoutez plutôtFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
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 à démarrage rapide , cela a été fait pour vous.
- Importez le module
FirebaseCore
dans votreUIApplicationDelegate
, ainsi que tous les autres modules Firebase utilisés par votre délégué d'application. Par exemple, pour utiliser Cloud Firestore et l'authentification :SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rapide
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objectif c
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configurez une instance partagée
FirebaseApp
dans la méthodeapplication(_:didFinishLaunchingWithOptions:)
de votre délégué d'application :SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rapide
// Use Firebase library to configure APIs FirebaseApp.configure()
Objectif c
// Use Firebase library to configure APIs [FIRApp configure];
- Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'attacher à votre structure
App
viaUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. Vous devez également désactiver le swizzling des délégués d’application. Pour plus d'informations, consultez les instructions SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Si vous avez inclus le SDK Firebase pour Google Analytics, vous pouvez exécuter votre application pour envoyer à la console Firebase une vérification indiquant que vous avez correctement installé Firebase.
C'est ça! Vous pouvez passer aux étapes suivantes .
Si vous rencontrez des difficultés lors de la configuration, consultez la section Dépannage et FAQ des plates-formes Apple .
Bibliothèques disponibles
Cette section répertorie les produits Firebase pris en charge pour les plates-formes Apple. Apprenez-en plus sur ces bibliothèques de plate-forme Apple Firebase :
Dépôt GitHub du SDK des plates-formes Apple Firebase
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 | |
Fonctions Cloud pour le SDK client Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Messagerie cloud | pod 'FirebaseMessaging' | FirebaseMessaging | |
Stockage en ligne | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytiques | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Liens dynamiques | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
Messagerie intégrée à l'application | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (requis) |
Installations de base de feu | 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égrer 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
Apprenez-en plus sur l'intégration de CocoaPods dans notre guide .
Cadres
En plus de prendre en charge la plateforme 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 .
Téléchargez le SDK du framework zip . Il s'agit d'un fichier d'environ 200 Mo dont le téléchargement peut prendre un certain temps.
Décompressez le fichier, puis intégrez les frameworks que vous souhaitez inclure dans votre application.
Vous pouvez trouver des instructions d’intégration à l’un des endroits suivants :
- Dans le référentiel GitHub du SDK Firebase iOS .
- Dans le fichier
README.md
de la distribution zip téléchargée.
Pour plus d'informations sur les versions ou les dépendances du framework, reportez-vous au fichier
METADATA.md
dans la distribution zip téléchargée.Ajoutez l' indicateur de l'éditeur de liens
-ObjC
dans vosOther Linker Settings
dans les paramètres de construction de votre cible.
Prochaines étapes
En savoir plus sur Firebase :
Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase et les meilleures pratiques en matière de projets.
Découvrez des exemples d'applications Firebase .
Bénéficiez d'une expérience pratique avec l' atelier de programmation Firebase iOS .
Explorez le code open source dans GitHub .
Préparez-vous à lancer votre application :
- Configurez des alertes budgétaires pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord d'utilisation et de facturation dans la console Firebase pour obtenir une image globale 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 ? Consultez le dépannage et la FAQ des plateformes 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 les données, telles que les 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 .