Ajouter Firebase à votre projet iOS

Conditions préalables

  • Installez les éléments suivants :

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

    • Votre projet doit cibler iOS 10 ou une version ultérieure.
  • Configurez un appareil iOS physique ou utilisez le simulateur iOS 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 iOS, vous devez créer un projet Firebase pour vous connecter à votre application iOS. 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 iOS.

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 paquet iOS champ ID.

  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 configuration Firebase iOS ( 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

Nous vous recommandons d' utiliser CocoaPods pour installer les bibliothèques Firebase. Cependant, si vous préférez ne pas utiliser CocoaPods, vous pouvez intégrer les cadres du SDK directement ou utiliser Package Swift Gestionnaire place.

Utilisez - vous l' un des échantillons de démarrage rapide ? Le projet Xcode et PODFILE (avec les gousses) sont déjà présents, mais vous aurez besoin encore ajouter votre fichier de configuration Firebase et installer les gousses.

  1. Créez un fichier Podfile si vous n'en avez pas déjà un :

    cd your-project-directory
    pod init
  2. À votre fichier Podfile, ajoutez les pods Firebase que vous souhaitez utiliser dans votre application.

    Vous pouvez ajouter des produits Firebase pris en charge à votre application iOS.

    Analytique activée

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    En savoir plus sur IDFA, le dispositif identifiant le niveau de la publicité, dans Apple la vie privée des utilisateurs et l' utilisation des données et applications de suivi de transparence documentation.

    Analytics non activé

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. Installez les gousses, puis ouvrez votre .xcworkspace fichier pour voir le projet dans Xcode:

    pod install
    open your-project.xcworkspace

É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 Firebase 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 le dépannage iOS & FAQ .

Capsules disponibles

Cette section répertorie les produits Firebase pris en charge pour iOS et leurs pods. En savoir plus sur ces bibliothèques Firebase iOS :

Service ou produit Pods Ajouter des analyses ?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytique pod 'Firebase/Analytics'
Vérification de l'application pod 'Firebase/AppCheck'
Distribution d'applications pod 'Firebase/AppDistribution'
Authentification pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Cloud Functions for Firebase Client SDK pod 'Firebase/Functions'
Messagerie Cloud pod 'Firebase/Messaging'
Stockage en ligne pod 'Firebase/Storage'
Crashlytiques pod 'Firebase/Crashlytics'
Liens dynamiques pod 'Firebase/DynamicLinks'
Messagerie intégrée pod 'Firebase/InAppMessaging'
(obligatoire)
Installations de base de feu pod 'Firebase/Installations'
API de modèle personnalisé Firebase ML pod 'Firebase/MLModelDownloader'
Suivi de la performance pod 'Firebase/Performance'
Base de données en temps réel pod 'Firebase/Database'
Configuration à distance pod 'Firebase/RemoteConfig'

Intégration sans CocoaPods

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

Cadres

En plus de prendre en charge la plate-forme iOS, le zip inclut désormais des fichiers .xcframework qui ajoutent la prise en charge de Catalyst basée sur la communauté. Pour plus de détails, voir le Firebase iOS SDK 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.

Gestionnaire de paquets Swift

En savoir plus sur l' intégration Swift Package Manager dans notre guide .

Prochaines étapes

En savoir plus sur Firebase :

Ajoutez des services Firebase à votre application :