Catch up on highlights from Firebase at Google I/O 2023. Learn more

Installez Firebase dans votre application Apple

Gestionnaire de paquets Swift

À partir de la v8.0.0 du SDK Apple Firebase, la prise en charge du gestionnaire de packages Swift de Firebase n'est plus en version bêta et est généralement disponible à l'utilisation. CocoaPods n'est pas requis pour les utilisateurs de Swift Package Manager.

Pour les versions 8 et supérieures de Firebase, Swift Package Manager est la méthode d'installation recommandée.

Par Xcode

La prise en charge de Swift Package Manager nécessite la version 14.1 ou supé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 ensuite être supprimé en toute sécurité. Si vous ajoutez Firebase à un projet pour la première fois, cette étape peut être ignorée.

  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 Firebase GitHub :

    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 commencera à 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 manifeste Package.swift , vous pouvez ajouter Firebase au tableau dependencies de votre package. Pour plus de détails, 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 des dependencies de cette cible.

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

Considérations spécifiques au produit

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 de l'éditeur de liens -ObjC aux paramètres de génération de votre cible s'il est inclus de manière transitive.

Crashlytics

Crashlytics vous demande de télécharger des symboles de débogage.

Vous pouvez utiliser une phase de génération de script d'exécution pour Xcode afin de télécharger automatiquement les symboles de débogage après la génération. Trouvez le script d'exécution ici :

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

Une autre option pour télécharger des symboles consiste à utiliser le script upload-symbols . Placez le script dans un sous-répertoire de votre fichier 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 télécharger manuellement des fichiers dSYM. Pour les notes d'utilisation et les instructions supplémentaires pour le script, exécutez upload-symbols sans aucun paramètre.

Cosses De Cacao

Firebase prend en charge l'installation avec CocoaPods en plus de Swift Package Manager.

La distribution CocoaPods de Firebase nécessite Xcode 14.1 et CocoaPods 1.10.0 ou supérieur. Voici comment installer Firebase à l'aide de 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. À votre Podfile, ajoutez les modules Firebase que vous souhaitez utiliser dans votre application.

    Vous pouvez ajouter n'importe quel produit Firebase pris en charge à votre application.

    Analyse activée

    # 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 la documentation d'Apple sur la confidentialité et l'utilisation des données et sur la transparence du suivi des applications .

    Analyse non activée

    # 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 au produit

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

Crashlytics

Crashlytics vous demande de télécharger des symboles de débogage.

Vous pouvez utiliser une phase de génération de script d'exécution pour Xcode afin de télécharger automatiquement les symboles de débogage après la génération. Trouvez le script d'exécution ici :

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Le support de Carthage est expérimental. 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 zip du SDK du framework . Ce fichier contient des tranches d'architecture pour toutes les architectures cibles disponibles pour tous les SDK Firebase et peut donc prendre un certain temps à télécharger.

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

  3. Ajoutez le drapeau de l'éditeur de liens -ObjC dans vos Other Linker Settings dans les paramètres de construction de votre cible.