Installieren Sie Firebase in Ihrer Apple-App

Swift-Paket-Manager

Ab Version 8.0.0 des Firebase Apple SDK ist die Unterstützung für den Swift Package Manager von Firebase aus der Betaphase heraus und steht allgemein zur Verwendung zur Verfügung. CocoaPods ist für Benutzer von Swift Package Manager nicht erforderlich.

Für Xcode-Versionen 12.5 und höher ist Swift Package Manager die empfohlene Installationsmethode.

Über Xcode

Für die Unterstützung von Swift Package Manager ist Xcode 12.5 oder höher erforderlich.

  1. Wenn Sie von einem CocoaPods-basierten Projekt migrieren, führen pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte .xcworkspace -Datei kann anschließend problemlos gelöscht werden. Wenn Sie Firebase zum ersten Mal zu einem Projekt hinzufügen, kann dieser Schritt ignoriert werden.

  2. Installieren Sie in Xcode die Firebase-Bibliotheken, indem Sie zu Datei > Swift-Pakete > Paketabhängigkeit hinzufügen… navigieren.

  3. Wählen Sie in der angezeigten Eingabeaufforderung das Firebase GitHub-Repository aus:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Wählen Sie die Version von Firebase aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir die Verwendung der neuesten Version von Firebase.

  5. Wählen Sie die Firebase-Bibliotheken aus, die Sie in Ihre App aufnehmen möchten.

Sobald Sie fertig sind, beginnt Xcode damit, Ihre Paketabhängigkeiten aufzulösen und sie im Hintergrund herunterzuladen.

Über Package.swift

Um Firebase über ein Package.swift Manifest in ein Swift-Paket zu integrieren, können Sie Firebase zum dependencies Ihres Pakets hinzufügen. Weitere Einzelheiten finden Sie in der Swift Package Manager-Dokumentation .

dependencies: [

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

],

Fügen Sie es dann in jedem Ziel, das von einem Firebase-Produkt abhängt, dem dependencies dieses Ziels hinzu.

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

Produktspezifische Überlegungen

Einige Firebase-Produkte erfordern zusätzliche Integrationsschritte, um ordnungsgemäß zu funktionieren.

Google Analytics

Google Analytics erfordert das Hinzufügen des Linker-Flags -ObjC zu den Build-Einstellungen Ihres Ziels, wenn es transitiv enthalten ist.

Crashlytics

Crashlytics erfordert, dass Sie Debug-Symbole hochladen.

Sie können eine Run-Script-Build-Phase für Xcode verwenden, um Debug-Symbole nach dem Build automatisch hochzuladen. Das Ausführungsskript finden Sie hier:

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

Eine weitere Option zum Hochladen von Symbolen ist die Verwendung des upload-symbols Skripts. Platzieren Sie das Skript in einem Unterverzeichnis Ihrer Projektdatei (z. B. scripts/upload-symbols ) und stellen Sie dann sicher, dass das Skript ausführbar ist:

chmod +x scripts/upload-symbols

Dieses Skript kann verwendet werden, um dSYM-Dateien manuell hochzuladen. Führen Sie für Nutzungshinweise und zusätzliche Anweisungen für das Skript upload-symbols ohne Parameter aus.

KakaoPods

Firebase unterstützt die Installation mit CocoaPods zusätzlich zum Swift Package Manager.

Die CocoaPods-Distribution von Firebase erfordert Xcode 12.5 und CocoaPods 1.10.0 oder höher. So installieren Sie Firebase mit CocoaPods:

  1. Erstellen Sie eine Pod-Datei, falls Sie noch keine haben. Führen Sie im Stammverzeichnis Ihres Projektverzeichnisses den folgenden Befehl aus:

    pod init
  2. Fügen Sie Ihrer Poddatei die Firebase-Pods hinzu, die Sie in Ihrer App verwenden möchten.

    Sie können Ihrer App jedes der unterstützten Firebase-Produkte hinzufügen.

    Analytics aktiviert

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

    Erfahren Sie mehr über IDFA, die Werbekennung auf Geräteebene, in der Apple-Dokumentation zum Datenschutz und zur Datennutzung sowie zur Transparenz der App-Verfolgung .

    Analytics nicht aktiviert

    # 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. Installieren Sie die Pods und öffnen Sie dann Ihre .xcworkspace -Datei, um das Projekt in Xcode anzuzeigen:

    pod install --repo-update
    open your-project.xcworkspace

Produktspezifische Überlegungen

Einige Firebase-Produkte erfordern zusätzliche Integrationsschritte, um ordnungsgemäß zu funktionieren.

Crashlytics

Crashlytics erfordert, dass Sie Debug-Symbole hochladen.

Sie können eine Run-Script-Build-Phase für Xcode verwenden, um Debug-Symbole nach dem Build automatisch hochzuladen. Das Ausführungsskript finden Sie hier:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Karthago

Die Karthago-Unterstützung ist experimentell. Lesen Sie die Anweisungen auf GitHub zum Einbinden von Firebase in Ihre App über Carthage.

Integrieren Sie manuell

Firebase bietet eine vorgefertigte binäre XCFramework-Distribution für Benutzer, die Firebase integrieren möchten, ohne einen Abhängigkeitsmanager zu verwenden. So installieren Sie Firebase:

  1. Laden Sie die Framework-SDK-ZIP-Datei herunter. Diese Datei enthält Architektur-Slices für alle verfügbaren Zielarchitekturen für alle Firebase-SDKs und kann daher einige Zeit zum Herunterladen benötigen.

  2. Entpacken Sie die Datei und überprüfen Sie dann die README -Datei auf die Frameworks, die Sie in Ihre App einschließen möchten.

  3. Fügen Sie das Linker-Flag -ObjC in Ihren Other Linker Settings in den Build-Einstellungen Ihres Ziels hinzu.