Installez Firebase dans votre application Apple

Gestionnaire de paquets Swift

A partir de v8.0.0 du Firebase SDK d' Apple, de Firebase Package Swift Gestionnaire de soutien est hors de bêta et est généralement disponible. CocoaPods n'est pas requis pour les utilisateurs de Swift Package Manager.

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

Via Xcode

La prise en charge de Swift Package Manager nécessite Xcode 12.5 ou supérieur.

  1. En cas de migration d'un projet basé sur CocoaPods, exécutez pod deintegrate pour enlever CocoaPods de votre projet Xcode. Le CocoaPods généré .xcworkspace fichier peut être supprimé en toute sécurité après. 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> Paquets Swift> Ajouter un package de dépendance ...

  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 vos packages et à les télécharger en arrière-plan.

via Package.swift

Pour intégrer Firebase à un package Swift via un Package.swift manifeste, vous pouvez ajouter à Firebase dependencies tableau de votre colis. Pour plus de détails, consultez la documentation Package Swift Gestionnaire .

dependencies: [

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

],

Ensuite , dans une cible qui dépend d'un produit Firebase, l' ajouter à la dependencies tableau 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 du -ObjC drapeau éditeur de liens pour les paramètres de construction de votre cible si elle est incluse transitive.

Crashlytiques

Crashlytics vous oblige à 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 les symboles de téléchargement est d'utiliser le upload-symbols des upload-symbols script. Placez le script dans un sous - répertoire de votre fichier de projet (par exemple des scripts/upload-symbols ), 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 des instructions supplémentaires pour le script, exécutez upload-symbols sans aucun paramètre.

CocoaPods

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

La distribution CocoaPods de Firebase nécessite Xcode 12.5 et CocoaPods 1.10.0 ou supérieur. Voici comment installer Firebase à l'aide de CocoaPods :

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

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

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

    Analytics activé

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    En savoir plus sur IDFA, le dispositif identifiant le niveau de la publicité, dans Apple la vie privée des utilisateurs et l' utilisation des données et applications de suivi de transparence documentation.

    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 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. Installez les gousses, puis ouvrez votre .xcworkspace fichier 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.

Crashlytiques

Crashlytics vous oblige à 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 soutien de Carthage est expérimental. Voir 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écharger le SDK cadre zip . 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 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.