Ajouter Firebase à votre projet Apple

Conditions préalables

  • Installez les éléments suivants :

    • Xcode 12.5 ou version ultérieure
  • Assurez-vous que votre projet répond aux exigences suivantes :

    • Votre projet doit cibler ces versions de plate-forme ou ultérieures :
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • regarderOS 6
  • Configurez un appareil Apple physique ou utilisez un simulateur pour exécuter votre application.

Si vous ne possédez pas déjà un projet Xcode et que vous voulez juste essayer un produit Firebase, vous pouvez télécharger un de nos échantillons 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. Visitez Comprendre Firebase projets pour en savoir plus sur les projets Firebase.

Étape 2: Enregistrez votre application avec Firebase

Une fois que vous avez un projet Firebase, vous pouvez y ajouter votre application Apple.

Visitez Comprendre Firebase projets pour en savoir plus sur les meilleures pratiques et considérations pour ajouter des applications à un projet Firebase, y compris la façon de traiter les variantes multiples de construction.

  1. Allez à la console Firebase .

  2. Au centre de la page d'aperçu du projet, cliquez sur l'icône iOS + pour lancer le flux de travail de configuration.

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

  3. Entrez ID paquet de votre application dans le champ ID bundle.

  4. (Facultatif) Entrez les autres informations de l' application: surnom App et App ID Store.

  5. Cliquez sur l' application de vous inscrire.

Étape 3: Ajouter un fichier de configuration Firebase

  1. Cliquez sur Télécharger GoogleService-Info.plist pour obtenir votre fichier de plates - formes d' 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 paquet dans votre projet, vous devez associer chaque ID bundle avec une application enregistrée dans la console Firebase afin que chaque application peut avoir son propre GoogleService-Info.plist fichier.

Étape 4: Ajouter Firebase à votre application SDKs

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

  1. Dans Xcode, avec votre projet d'application ouvert, accédez à Fichier> Paquets Swift> Ajouter un package de dépendance.
  2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Firebase Apple :
  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 capacité de collecte IDFA, ajouter FirebaseAnalyticsWithoutAdId à la place.

Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger 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 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. Importer le module Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  2. Configurer une FirebaseApp instance partagée, généralement dans votre application application:didFinishLaunchingWithOptions: méthode:

    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 envoyer une vérification à la console Firebase que vous avez correctement installé Firebase.

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

Si vous éprouvez des difficultés se mettre en place, bien que, visitez les plates - formes Apple dépannage et FAQ .

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 la plate-forme Firebase Apple :

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

Intégration sans gestionnaire de dépendances

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

Cadres

En plus de soutenir la plate - forme iOS, le zip inclut désormais .xcframework fichiers. Pour plus de détails, voir les plates - formes Firebase SDK d' Apple README sur GitHub .

  1. Télécharger le SDK cadre zip . 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 vérifiez le README pour les cadres que vous souhaitez inclure dans votre application.

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

CocoaPods

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

Prochaines étapes

En savoir plus sur Firebase :

Ajoutez des services Firebase à votre application :