Options d'installation de Firebase dans votre application Apple

Gestionnaire de paquets Swift

Firebase recommande Swift Package Manager pour les nouveaux projets.

Via Xcode

La compatibilité avec Swift Package Manager nécessite la version 15.2 ou une version ultérieure.

  1. Si vous migrez à partir d'un projet basé sur CocoaPods, exécutez pod deintegrate pour supprimer CocoaPods de votre projet Xcode. .xcworkspace généré par CocoaPods fichier 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 à 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 recommandez 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 vos dépendances de package et en les téléchargeant en arrière-plan.

Via Package.swift

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

dependencies: [

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

],

Ensuite, dans chaque 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 -ObjC Linker au tag paramètres de compilation s'ils sont inclus de manière transitoire.

Crashlytics

Crashlytics nécessite que vous importiez des symboles de débogage.

Vous pouvez utiliser une phase de compilation de script d'exécution pour que Xcode importe automatiquement le débogage après la compilation. Recherchez le script d'exécution ici:

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

Pour importer des symboles, vous pouvez également utiliser la méthode upload-symbols script. Placez le script dans un sous-répertoire du fichier de votre projet (par exemple, scripts/upload-symbols), puis assurez-vous que le script est exécutable:

chmod +x scripts/upload-symbols

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

CocoaPods

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

La distribution CocoaPods de Firebase nécessite Xcode 15.2 et CocoaPods 1.12.0 ou version ultérieure Procédure d'installation Firebase utilisant CocoaPods:

  1. Créez un Podfile si vous n'en avez pas déjà un. À partir de la racine du répertoire de votre projet, exécutez la commande suivante :

    pod init
  2. Dans votre fichier Podfile, ajoutez les pods Firebase que vous souhaitez utiliser dans votre application.

    Vous pouvez ajouter n'importe quel format produits Firebase à votre application.

    Analytics activé

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # 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 'FirebaseAuth'
    pod 'FirebaseFirestore'

    En savoir plus sur l'IDFA, l'identifiant publicitaire au niveau de l'appareil, dans le Confidentialité et utilisation des données des utilisateurs et App Tracking Transparency dans la documentation Google Cloud.

    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 voir 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 nécessite que vous importiez des symboles de débogage.

Vous pouvez utiliser une phase de compilation de script d'exécution pour que Xcode importe automatiquement le débogage après la compilation. Recherchez 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écompilée 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, ce qui peut le téléchargement prend du temps.

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

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