Options d'installation de Firebase dans votre application Apple

Swift Package Manager

Firebase recommande Swift Package Manager pour les nouveaux projets.

Via Xcode

La prise en charge de Swift Package Manager nécessite iOS 16.2 ou version ultérieure.

1. Si vous migrez depuis un projet basé sur CocoaPods, exécutez pod deintegrate pour supprimer CocoaPods de votre projet Xcode. Le fichier .xcworkspace généré par CocoaPods peut être supprimé en toute sécurité par la suite. Si vous ajoutez Firebase à un projet pour la première fois, vous pouvez ignorer cette étape.

2. Dans Xcode, installez les bibliothèques Firebase en accédant à File > Add Packages (Fichier > Ajouter des packages).

3. Dans l'invite qui s'affiche, sélectionnez le dépôt GitHub Firebase :

   https://github.com/firebase/firebase-ios-sdk.git
   

4. Sélectionnez la version de Firebase que vous souhaitez utiliser. Pour les nouveaux projets, nous vous recommandons d'utiliser la dernière version de Firebase.

5. Choisissez les bibliothèques Firebase que vous souhaitez inclure dans votre application.

Une fois que vous avez terminé, Xcode commence à résoudre les dépendances de votre package et à les télécharger en arrière-plan.

Via Package.swift

Pour intégrer Firebase à un package Swift via un fichier manifeste Package.swift, vous pouvez ajouter Firebase au tableau dependencies de votre package. Pour en savoir plus, consultez la documentation de Swift Package Manager.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Ensuite, dans toute cible qui dépend d'un produit Firebase, ajoutez-la au tableau dependencies de cette cible.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Considérations spécifiques aux produits

Certains produits Firebase nécessitent des étapes d'intégration supplémentaires pour fonctionner correctement.

Google Analytics

Google Analytics nécessite l'ajout de l'indicateur d'éditeur de liens -ObjC aux paramètres de compilation de votre cible s'il est inclus de manière transitive.

Crashlytics

Crashlytics vous demande d'importer des symboles de débogage.

Vous pouvez utiliser une phase de compilation de script d'exécution pour Xcode afin d'importer automatiquement les symboles de débogage après la compilation. Vous trouverez le script d'exécution ici :

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Une autre option pour importer des symboles consiste à utiliser le script upload-symbols. Placez le script dans un sous-répertoire de votre fichier de projet (par exemple, scripts/upload-symbols), puis assurez-vous qu'il est exécutable :

chmod +x scripts/upload-symbols

Ce script peut être utilisé pour importer manuellement des fichiers dSYM. Pour obtenir des notes d'utilisation et des instructions supplémentaires concernant le script, exécutez upload-symbols sans aucun paramètre.

CocoaPods

Firebase est compatible avec l'installation avec CocoaPods en plus de Swift Package Manager.

La distribution CocoaPods de Firebase nécessite Xcode 16.2 et CocoaPods 1.12.0 ou version ultérieure. Voici comment installer Firebase à l'aide de CocoaPods :

1. Créez un fichier Podfile si vous n'en possédez pas encore. À partir de la racine du répertoire de votre projet, exécutez la commande suivante :

   pod init

2. Ajoutez à votre Podfile les pods Firebase que vous souhaitez utiliser dans votre application.

   Vous pouvez ajouter à votre application n'importe quel produit Firebase compatible.

   Analytics activé

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod FirebaseAnalytics/Core
   
   # 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 'FirebaseAuth'
   pod 'FirebaseFirestore'

   Pour en savoir plus sur l'IDFA (Identifier for Advertisers), l'identifiant publicitaire au niveau de l'appareil, consultez la documentation d'Apple sur la confidentialité des utilisateurs et l'utilisation des données et sur la transparence du suivi des applications.

   Analytics non 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 'FirebaseAuth'
   pod 'FirebaseFirestore'

3. Installez les pods, puis ouvrez votre fichier .xcworkspace pour afficher le projet dans Xcode :

   pod install --repo-update

   open your-project.xcworkspace

Considérations spécifiques aux produits

Certains produits Firebase nécessitent des étapes d'intégration supplémentaires pour fonctionner correctement.

Crashlytics

Crashlytics vous demande d'importer des symboles de débogage.

Vous pouvez utiliser une phase de compilation de script d'exécution pour Xcode afin d'importer automatiquement les symboles de débogage après la compilation. Vous trouverez le script d'exécution ici :

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

La compatibilité avec Carthage est expérimentale. Consultez les instructions sur GitHub pour inclure Firebase dans votre application via Carthage.

Intégrer manuellement

Firebase fournit une distribution XCFramework binaire prédéfinie pour les utilisateurs qui souhaitent intégrer Firebase sans utiliser de gestionnaire de dépendances. Pour installer Firebase :

1. Téléchargez le fichier ZIP du SDK du framework. Ce fichier contient des tranches d'architecture pour toutes les architectures cibles disponibles pour tous les SDK Firebase. Son téléchargement peut donc prendre un certain temps.

2. Décompressez le fichier, puis examinez le fichier README pour les frameworks que vous souhaitez inclure dans votre application.

3. Ajoutez l'indicateur d'éditeur de liens -ObjC dans Other Linker Settings dans les paramètres de compilation de votre cible.