Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Ajoutez Firebase à votre projet iOS

Conditions préalables

  • Installez ce qui suit:

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

    • Votre projet doit cibler iOS 10 ou version ultérieure.
  • Configurez un appareil iOS physique ou utilisez le simulateur iOS pour exécuter votre application.

Si vous ne possédez 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 iOS, vous devez créer un projet Firebase pour vous connecter à votre application iOS. Consultez Comprendre les projets Firebase 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.

Consultez Comprendre les projets Firebase pour en savoir plus sur les bonnes pratiques et les considérations relatives à l'ajout d'applications à un projet Firebase, notamment sur la gestion de plusieurs variantes de build.

  1. Accédez à la console Firebase .

  2. Au centre de la page de 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 la plate-forme.

  3. Saisissez l'ID du bundle de votre application dans le champ ID du bundle iOS .

  4. (Facultatif) Saisissez d'autres informations sur l'application: le pseudo 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 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 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

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 directement les frameworks SDK ou utiliser le Swift Package Manager (bêta) .

Utilisez-vous l'un des exemples de démarrage rapide ? Le projet Xcode et Podfile (avec pods) sont déjà présents, mais vous devrez toujours ajouter votre fichier de configuration Firebase et installer les pods.

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

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

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

    Analytics activé

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
    # 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'

    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 pods, puis ouvrez votre fichier .xcworkspace pour voir le projet dans Xcode:

    pod install
    open your-project.xcworkspace

É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 Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  2. Configurez une instance partagée FirebaseApp , généralement dans l'application de votre application:didFinishLaunchingWithOptions: method:

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

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

Pods 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 Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytique pod 'Firebase/Analytics'
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'
Firebase Crashlytics pod 'Firebase/Crashlytics'
Liens dynamiques pod 'Firebase/DynamicLinks'
Messagerie dans l'application pod 'Firebase/InAppMessaging'
(obligatoire)
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égrez sans CocoaPods

Si vous ne souhaitez pas utiliser Cocoapods, vous pouvez toujours profiter des SDK Firebase en important les frameworks directement ou en utilisant le 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, consultez le fichier README du SDK Firebase iOS sur GitHub .

  1. Téléchargez le zip du kit de développement logiciel . 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 passez en revue le README pour les Frameworks que vous souhaitez inclure dans votre application.

  3. Ajoutez l' ObjC éditeur de liens ObjC dans vos Other Linker Settings l' ObjC liens dans les Other Linker Settings de construction de votre cible.

Gestionnaire de packages Swift

La prise en charge de Swift Package Manager est actuellement en version bêta. Suivez la documentation sur GitHub et envoyez vos commentaires dans l' outil de suivi des problèmes GitHub .

Prochaines étapes

En savoir plus sur Firebase:

Ajoutez des services Firebase à votre application: