Ajouter Firebase à votre projet iOS

Conditions préalables

• Installer les éléments suivants:

  • Xcode 10.3 ou version ultérieure
  • CocoaPods 1.4.0 ou version ultérieure

• Assurez-vous que votre projet répond à ces exigences:

  • Votre projet doit cibler iOS 8 ou version ultérieure.

• Mettre en place un dispositif iOS physique ou utiliser le simulateur iOS pour exécuter votre application.

  Voulez-vous utiliser la messagerie cloud?

  Cloud Messaging sur iOS, voici les conditions:

  • Mettre en place un dispositif iOS physique.
  • Obtenir un Apple Push Notification clé d' authentification pour votre compte Apple Developer .
  • Activer les notifications Push dans XCode sous App> Capacités.

• Connectez - vous à Firebase en utilisant votre compte Google.

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.

Créer un projet Firebase

1. Dans la console Firebase , cliquez sur Ajouter un projet, puis sélectionnez ou entrez un nom de projet.

   Si vous avez un projet Google existant Cloud Platform (GCP), vous pouvez sélectionner le projet dans le menu déroulant pour ajouter des ressources Firebase à ce projet.

2. (Facultatif) Si vous créez un nouveau projet, vous pouvez modifier l'ID du projet.

   Firebase attribue automatiquement un identifiant unique à votre projet Firebase. Visitez Comprendre Firebase projets pour en savoir plus sur la façon dont Firebase utilise l'ID du projet.

   Après ressources dispositions Firebase pour votre projet Firebase, vous ne pouvez pas changer votre ID de projet.
   Pour utiliser un identifiant spécifique, vous devez modifier votre ID de projet au cours de cette étape de configuration.

3. Cliquez sur Continuer.

4. (Facultatif) Configuration de Google Analytics pour votre projet, ce qui vous permet d'avoir une expérience optimale en utilisant l' un des produits suivants Firebase:

   Firebase Crashlytics Les prédictions Firebase

   Firebase Nuage de messagerie Firebase In-App Messaging

   Firebase à distance Config Firebase test A / B

   Lorsque vous êtes invité, sélectionnez utiliser un existant compte Google Analytics ou de créer un nouveau compte.
   Si vous choisissez de créer un nouveau compte, sélectionnez votre emplacement Analytics rapports , puis accepter les paramètres de partage des données et des termes Google Analytics pour votre projet.

   Vous pouvez toujours configurer Google Analytics plus tard dans l' Intégrations onglet de vos Paramètres du projet.

5. Cliquez sur Créer un projet (ou Ajouter Firebase, si vous utilisez un projet existant GCP).

Firebase automatiquement les ressources dispositions pour votre projet. Firebase Lorsque le processus de finalise, vous serez redirigé vers la page vue d'ensemble de votre projet Firebase dans la console Firebase.

Étape 2: Enregistrez votre application avec Firebase

Une fois que vous avez un projet Firebase, vous pouvez ajouter votre application iOS à elle.

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.

   Qu'est-ce qu'un ID bundle, et où trouvez-vous?

   • Un identifiant de groupe identifie de manière unique une application dans l'écosystème d'Apple.

   • Trouvez votre paquet ID: ouvrir votre iOS projet dans Xcode, sélectionnez l'application de niveau supérieur dans le navigateur de projet, puis sélectionnez l'onglet Général.

     La valeur du champ Identificateur Bundle est le faisceau iOS ID (par exemple, com.yourcompany.yourproject ).

   • Sachez que la valeur ID bundle est sensible à la casse, et il ne peut pas être changé pour cette application iOS Firebase après qu'il est enregistré avec votre projet Firebase.

   Assurez-vous d'entrer l'ID paquet que votre application utilise réellement. La valeur ID bundle est sensible à la casse, et il ne peut pas être changé pour cette application iOS Firebase après qu'il est enregistré avec votre projet Firebase.

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

   Comment sont le surnom App et l'App ID magasin utilisé dans Firebase?

   • Surnom App: Un interne, identifiant de commodité qui est seulement visible pour vous dans la console Firebase

   • App ID magasin: Utilisé par Firebase Dynamic Liens pour rediriger les utilisateurs vers votre page App Store et Google Analytics aux événements de conversion à l'importation dans les annonces Google . Si votre application n'a pas encore une application ID Store, vous pouvez ajouter l'ID ultérieurement dans vos paramètres du projet .

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 ).

   Qu'est-ce que vous devez savoir sur ce fichier de configuration?

   • Le fichier de configuration contient Firebase identificateurs uniques, mais non secrets pour votre projet. Pour en savoir plus sur ce fichier de configuration, visitez Comprendre les projets Firebase .

   • Vous pouvez télécharger le fichier de configuration Firebase à tout moment.

   • Assurez - vous que le nom du fichier de configuration n'est pas ajouté avec des caractères supplémentaires, comme (2) .

2. Déplacez votre fichier config dans la racine de votre projet Xcode. Si vous ê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 directement les cadres du SDK .

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éer un PODFILE si vous ne possédez pas déjà un:

   cd your-project-directory 

   pod init

2. Pour votre PODFILE, ajoutez les gousses Firebase que vous souhaitez utiliser dans votre application.

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

   Analytics activé

   # 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 pas activé

   # 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'

   Firebase est intégré en tant que cadres statiques par défaut. Si vous utilisez Firebase en tant que dépendance d'un cadre dynamique, assurez-vous de lire la documentation sur l' utilisation Firebase d'un cadre ou d' une bibliothèque .

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 du code d'initialisation à votre application. Vous avez peut-être déjà fait dans le cadre d'ajouter 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 lancer votre application pour envoyer la vérification à la console Firebase que vous avez Firebase installé avec succès.

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

dosettes disponibles

Cette section énumère les produits pris en charge Firebase pour iOS et leurs gousses. En savoir plus sur ces bibliothèques Firebase iOS:

• Documentation de référence ( Swift | Obj-C )

• Firebase SDK iOS repo GitHub

La bibliothèque iOS Firebase Firebase/Core n'est plus nécessaire. Ce SDK inclus le SDK Firebase pour Google Analytics.

Maintenant, utiliser Google Analytics ou tout produit Firebase qui recommande l'utilisation de Google Analytics (voir tableau ci - dessous), vous devez ajouter explicitement les pod Analytics: Firebase/Analytics .

Produit ou service	pods	Ajouter Analytics?
AdMob	pod 'Google-Mobile-Ads-SDK'
Analytique	pod 'Firebase/Analytics'
Authentification	pod 'Firebase/Auth'
cloud Firestore	pod 'Firebase/Firestore'
Fonctions Cloud pour Firebase Client SDK	pod 'Firebase/Functions'
cloud Messaging	pod 'Firebase/Messaging'
Stockage en ligne	pod 'Firebase/Storage'
Firebase Crashlytics	pod 'Firebase/Crashlytics'
dynamique Liens	pod 'Firebase/DynamicLinks'
In-App Messaging	pod 'Firebase/InAppMessaging'	(obligatoire)
ML API Vision Firebase	pod 'Firebase/MLVision'
ML Firebase API Modèle personnalisé	pod 'Firebase/MLModelInterpreter'
Suivi de la performance	pod 'Firebase/Performance'
Base de données en temps réel	pod 'Firebase/Database'
Config à distance	pod 'Firebase/RemoteConfig'

obsolète:

Produit ou service	pods	Détails
ML Kit pour Firebase: Image étiquetage Modèle	pod 'Firebase/MLVisionLabelModel'	Guide de migration
ML Kit pour Firebase: Code barre modèle de numérisation	pod 'Firebase/MLVisionBarcodeModel'	Guide de migration
ML Kit pour Firebase: reconnaissance de texte Modèle	pod 'Firebase/MLVisionTextModel'	Guide de migration
ML Kit pour Firebase: détection de visage Modèle	pod 'Firebase/MLVisionFaceModel'	Guide de migration
ML Kit pour Firebase: détection d'objet et de suivi modèle	pod 'Firebase/MLVisionObjectDetection'	Guide de migration
ML Kit pour Firebase: API en langage naturel	pod 'Firebase/MLNaturalLanguage'	Guide de migration
ML Kit pour Firebase: Langue modèle d' identification	pod 'Firebase/MLNLLanguageID'	Guide de migration
ML Kit pour Firebase: Traduire Modèle	pod 'Firebase/MLNLTranslate'	Guide de migration
ML Kit pour Firebase Smart Répondre Modèle	pod 'Firebase/MLNLSmartReply'	Guide de migration
ML Kit pour Firebase: AutoML Vision API bord	pod 'Firebase/MLVisionAutoML'	Guide de migration

Intégrer sans CocoaPods

Si vous ne souhaitez pas utiliser Cocoapods, vous pouvez toujours profiter des SDKs Firebase par l'importation des cadres directement.

En plus de soutenir la plate-forme iOS, le zip inclut désormais les fichiers .xcframework que communautaire Ajout du support Catalyst. Pour plus de détails, voir le Firebase iOS SDK README sur GitHub .

1. Télécharger le SDK cadre zip . Ce fichier ~ 200 Mo et peut prendre un certain temps à télécharger.

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.

Prochaines étapes

En savoir plus sur Firebase:

• Visitez Comprendre Firebase projets pour en savoir plus sur les projets Firebase et les meilleures pratiques pour les projets.

• Explorer exemples des applications Firebase .

• Obtenez une expérience pratique avec le Firebase iOS Codelab .

• Explorer le code open source GitHub .

• Préparez-vous à lancer votre application:

  • Mettre en place des alertes sur le budget de votre projet dans la console de GCP.
  • Surveillez votre utilisation et tableau de bord de facturation dans la console Firebase.
  • Passez en revue la liste de contrôle de lancement Firebase .

Ajouter des services à votre application Firebase:

• Obtenir des informations sur le comportement de l' utilisateur avec Analytics .

• Configurez l'authentification utilisateur avec authentification .

• Stocke des données, comme les informations utilisateur, avec Nuage Firestore ou base de données en temps réel .

• Stockez des fichiers, comme des photos et des vidéos, avec Cloud Storage .

• Le code de déclenchement qui fonctionne dans un environnement sécurisé avec fonctions de Cloud .

• Envoyer des notifications avec Nuage de messagerie .

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