Ajouter Firebase à votre projet Apple

Prérequis

  • Installez les éléments suivants :

    • Xcode 26.2 ou version ultérieure

  • Assurez-vous que votre projet répond aux exigences suivantes :

    • Votre projet doit cibler ces versions de plate-forme ou des versions ultérieures :
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

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

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éez un projet Firebase

Avant d'ajouter Firebase à votre application Apple, vous devez créer un projet Firebase à associer à votre application. Pour en savoir plus sur les projets Firebase, consultez Comprendre les projets Firebase.

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

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

  1. Accédez à la consoleFirebase.

  2. Au centre de la page "Vue d'ensemble du projet", cliquez sur l'icône iOS+ pour lancer la 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. Saisissez l'ID du bundle de votre application dans le champ ID du bundle.

  4. (Facultatif) Saisissez d'autres informations sur l'application : Nom de l'application et ID App Store.

  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 Firebase de votre application (GoogleService-Info.plist).

  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 comporte plusieurs ID de bundle, vous devez associer chacun d'eux à une application enregistrée dans la console Firebase afin que chaque application puisse avoir son propre fichier GoogleService-Info.plist.

Étape 4 : Ajoutez les SDK Firebase à votre application

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

  1. Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
  2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Sélectionnez la version du SDK que vous souhaitez utiliser.

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

    Si Google Analytics est activé dans votre projet Firebase, veillez à ajouter FirebaseAnalytics. Cela fournit toutes les fonctionnalités d'analyse. Vous pouvez également sélectionner des fonctionnalités individuelles. Pour en savoir plus, consultez les questions fréquentes sur la dernière organisation des modules dans le SDK Google Analytics pour Firebase.

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 le code d'initialisation à votre application. Vous l'avez peut-être déjà fait lors de l'ajout de Firebase à votre application. Si vous utilisez un exemple de projet de démarrage rapide, cette opération a déjà été effectuée pour vous.

  1. Importez le module FirebaseCore dans votre UIApplicationDelegate, 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 :

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) du délégué de votre application :

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre structure App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le swizzling du délégué d'application. Pour en savoir plus, 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()
      }
    }
  }
}
  4. Si vous avez inclus le SDK Firebase pour Google Analytics, vous pouvez exécuter votre application pour envoyer une vérification à la console Firebase indiquant que vous avez bien installé Firebase.

Et voilà ! Vous pouvez passer aux étapes suivantes.

Si vous rencontrez des difficultés lors de la configuration, consultez la section Dépannage et questions fréquentes sur 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 Firebase pour les plates-formes Apple :

Service ou produit Nom de la bibliothèque / du framework Ajouter Analytics ?
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (obligatoire)
Firebase installations FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
BIBLIOTHÈQUES OBSOLÈTES OU NON COMPATIBLES
Dynamic Links FirebaseDynamicLinks
Firebase ML API de modèles personnalisés FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) s'appelait auparavant "Vertex AI in Firebase" et était distribué sous le module FirebaseVertexAI. Firebase AI Logic était également distribué sous le module FirebaseAI.

2 Firebase SQL Connect s'appelait auparavant "Firebase Data Connect".

Intégrer sans utiliser Swift Package Manager

Si vous ne souhaitez pas utiliser Swift Package Manager, vous pouvez toujours intégrer Firebase en important directement les frameworks précompilés.

Frameworks

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

  1. Téléchargez le fichier ZIP du SDK du framework. Ce fichier fait environ 200 Mo et peut prendre un certain temps à télécharger.

  2. Décompressez le fichier, puis intégrez les frameworks que vous souhaitez inclure dans votre application.

    Vous trouverez les instructions d'intégration à l'un des emplacements suivants :

    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.

  3. Ajoutez l'option d'éditeur de liens -ObjC dans Other Linker Flags dans les paramètres de compilation de votre cible.

Étapes suivantes

En savoir plus sur Firebase

Ajoutez des services Firebase à votre application :

  • Créez des fonctionnalités d'IA générative avec des modèles Gemini à l'aide de Firebase AI Logic.

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

  • Configurez l'authentification des utilisateurs avec Authentication.

  • Stocker 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.

  • Envoyer des notifications avec Cloud Messaging.

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