Catch up on highlights from Firebase at Google I/O 2023. Learn more

Ajouter Firebase à votre projet Apple

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
      • watchOS 6
  • 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é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 avec votre projet Firebase. L'enregistrement de votre application est souvent appelé "ajouter" votre application à votre projet.

  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 .

  4. (Facultatif) Saisissez d'autres informations sur l'application : le surnom de l'application et l'identifiant de l'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 de votre plate-forme Apple Firebase ( GoogleService-Info.plist ).

  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.

  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 :
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Sélectionnez la version du SDK que vous souhaitez utiliser.
  5. 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 :

    SwiftUI

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

    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 :

    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];
  3. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'attacher à votre structure App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . 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()
          }
        }
      }
    }
          
  4. 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 .

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 :

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
(requis)
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 intégrez les frameworks que vous souhaitez inclure dans votre application.

    Vous pouvez trouver des instructions d'intégration dans l'un des endroits suivants :

    Pour plus d'informations sur les versions de framework ou les dépendances, reportez-vous au fichier METADATA.md dans la distribution zip téléchargée.

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

Prochaines étapes

En savoir plus sur Firebase :

Ajoutez les services Firebase à votre application :