Prérequis
Installez les éléments suivants:
- Xcode 15.2 ou version ultérieure
Assurez-vous que votre projet répond aux exigences suivantes:
- Votre projet doit cibler les versions de plate-forme suivantes ou ultérieures :
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Votre projet doit cibler les versions de plate-forme suivantes ou ultérieures :
Configurez un appareil Apple physique ou utilisez un simulateur pour exécuter votre application.
Voulez-vous utiliser Cloud Messaging ?
Pour Cloud Messaging sur les plates-formes Apple, voici les prérequis:
- Configurez un appareil Apple physique.
- Obtenez une clé d'authentification Apple Push Notification pour votre compte de développeur Apple.
- Activez les notifications push dans Xcode sous App > Capabilities (Application > Fonctionnalités).
- Connectez-vous à Firebase avec votre compte Google.
Si vous ne disposez pas encore d'un projet Xcode et que vous souhaitez simplement tester un produit Firebase, vous pouvez télécharger l'un de nos exemples de démarrage rapide.
Étape 1: Créez un projet Firebase
Avant de pouvoir ajouter Firebase à votre application Apple, vous devez créer un projet Firebase pour vous y connecter. Pour en savoir plus sur les projets Firebase, consultez Comprendre les projets Firebase.
Créer un projet Firebase
-
Dans la console Firebase, cliquez sur Ajouter un projet.
-
Pour ajouter des ressources Firebase à un projet Google Cloud existant, saisissez son nom ou sélectionnez-le dans le menu déroulant.
-
Pour créer un projet, saisissez le nom souhaité. Vous pouvez également modifier l'ID du projet affiché sous le nom du projet.
-
-
Si vous y êtes invité, lisez et acceptez les Conditions d'utilisation de Firebase.
-
Cliquez sur Continuer.
-
(Facultatif) Configurez Google Analytics pour votre projet, ce qui vous permet de profiter d'une expérience optimale avec l'un des produits Firebase suivants:
Sélectionnez un compte Google Analytics existant ou créez-en un.
Si vous créez un compte, sélectionnez votre emplacement de création de rapports Analytics, puis acceptez les paramètres de partage des données et les conditions Google Analytics pour votre projet.
-
Cliquez sur Créer un projet (ou sur Ajouter Firebase si vous utilisez un projet Google Cloud existant).
Firebase provisionne automatiquement des ressources pour votre projet Firebase. Une fois le processus terminé, vous êtes redirigé vers la page de présentation de votre projet Firebase dans la console Firebase.
Étape 2: Enregistrer 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é "ajout" de 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 processus 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.
Saisissez l'ID de votre application dans le champ ID du bundle.
Qu'est-ce qu'un ID de bundle et où le trouver ?
Un ID 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 premier niveau dans le navigateur de projets, puis sélectionnez l'onglet General (Général).
La valeur du champ Bundle Identifier correspond à l'ID du bundle (par exemple,
com.yourcompany.yourproject
).Notez que la valeur de l'ID de bundle est sensible à la casse et 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 : le pseudo de l'application et l'ID de l'App Store.
Comment le pseudo de l'application et l'ID App Store sont-ils utilisés dans Firebase ?
Pseudo de l'application: identifiant interne pratique que vous ne pouvez voir que dans la console Firebase.
ID de l'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 n'a pas encore d'ID d'App Store, vous pouvez l'ajouter ultérieurement dans les paramètres du projet.
Cliquez sur Enregistrer l'application.
Étape 3: Ajouter un fichier de configuration Firebase
Cliquez sur Télécharger GoogleService-Info.plist pour obtenir votre fichier de configuration des plates-formes Apple Firebase (
GoogleService-Info.plist
).Que devez-vous savoir sur ce fichier de configuration ?
Le fichier de configuration Firebase contient des identifiants uniques, mais pas 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.
Veillez à ne pas inclure de caractères supplémentaires dans le nom du fichier de configuration, par exemple
(2)
.
Déplacez votre fichier de configuration à la racine de votre projet Xcode. Si vous y êtes invité, sélectionnez l'option permettant d'ajouter le fichier de configuration à toutes les cibles.
Si votre projet contient plusieurs ID de bundle, vous devez associer chaque ID de bundle à une application enregistrée dans la console Firebase afin que chaque application puisse disposer de son propre fichier GoogleService-Info.plist
.
Étape 4: Ajouter les SDK Firebase à votre application
Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.
- Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
- Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
- 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, veillez à ajouter
FirebaseAnalytics
. Pour Analytics sans fonctionnalité de collecte IDFA, ajoutezFirebaseAnalyticsWithoutAdId
à la place.
https://github.com/firebase/firebase-ios-sdk
Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.
Étape 5: Initialiser Firebase dans votre application
La dernière étape consiste à ajouter un code d'initialisation à votre application. Vous avez peut-être déjà fait cela lorsque vous avez ajouté Firebase à votre application. Si vous utilisez un exemple de projet de démarrage rapide, cela a déjà été fait pour vous.
- Importez le module
FirebaseCore
dans votreUIApplicationDelegate
, ainsi que tous les autres modules Firebase utilisés par le délégué de votre application. Par exemple, pour utiliser Cloud Firestore et Authentication:import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configurez une instance partagée
FirebaseApp
dans la méthodeapplication(_:didFinishLaunchingWithOptions:)
de votre délégué d'application:// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs [FIRApp configure];
- Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre struct
App
viaUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. Vous devez également désactiver le mélange des délégués d'application. Pour en savoir plus, consultez les instructions 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 la confirmation que vous avez bien installé Firebase.
Et voilà ! Vous pouvez passer aux étapes suivantes.
Toutefois, si vous rencontrez des difficultés pour configurer l'application, consultez les questions fréquentes et le dépannage pour les plates-formes Apple.
Bibliothèques disponibles
Cette section liste les produits Firebase compatibles avec les plates-formes Apple. En savoir plus sur ces bibliothèques de plate-forme Apple Firebase:
Dépôt GitHub du SDK Firebase pour les plates-formes Apple
Service ou produit | Pods | Bibliothèques SwiftPM | Google Analytics">Ajouter Analytics ? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
N/A | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(obligatoire) |
Installations Firebase | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML API de modèle personnalisé | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
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.
CocoaPods
Pour en savoir plus sur l'intégration de CocoaPods, consultez notre guide.
Frameworks
En plus de la compatibilité avec la plate-forme iOS, le fichier ZIP inclut désormais des fichiers .xcframework
. Pour en savoir plus, consultez le README du SDK Firebase pour les plates-formes Apple sur GitHub.
Téléchargez le fichier ZIP du SDK du framework. Il s'agit d'un fichier d'environ 200 Mo qui peut prendre un certain temps à télécharger.
Décompressez le fichier, puis intégrez les frameworks que vous souhaitez inclure dans votre application.
Vous trouverez les instructions d'intégration dans les sections suivantes:
- Dans le dépôt GitHub du SDK Firebase pour iOS.
- Dans le fichier
README.md
de la distribution ZIP téléchargée.
Pour en savoir plus sur les versions ou les dépendances du framework, consultez le fichier
METADATA.md
dans la distribution ZIP téléchargée.Ajoutez l'indicateur d'éditeur de liens
-ObjC
dans votreOther Linker Settings
dans les paramètres de compilation de votre cible.
Étapes suivantes
En savoir plus sur Firebase:
Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase et les bonnes pratiques à suivre.
Découvrez les exemples d'applications Firebase.
Familiarisez-vous avec l'atelier de programmation Firebase pour iOS.
Explorez le code Open Source sur GitHub.
Préparez le lancement de votre application:
- Configurez des alertes budgétaires pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord "Utilisation et facturation" dans la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet sur plusieurs services Firebase.
- Consultez la checklist de lancement de Firebase.
Vous rencontrez des difficultés avec Firebase et votre projet Apple ? Consultez les questions fréquentes et le dépannage pour les plates-formes Apple.
Ajoutez des services Firebase à votre application:
Obtenez des insights sur le comportement des utilisateurs avec Analytics.
Configurez l'authentification des utilisateurs avec Authentication.
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 le code backend qui s'exécute dans un environnement sécurisé avec Cloud Functions.
Envoyer des notifications avec Cloud Messaging
Découvrez quand et pourquoi votre application plante avec Crashlytics.