Optionen zum Installieren von Firebase in Ihrer Apple-App

Swift Package Manager

Firebase empfiehlt für neue Projekte den Swift Package Manager.

Über Xcode

Für die Unterstützung des Swift Package Manager ist Version 16.2 oder höher erforderlich.

  1. Wenn Sie von einem CocoaPods-basierten Projekt migrieren, führen Sie pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte .xcworkspace-Datei kann danach sicher gelöscht werden. Wenn Sie Firebase zum ersten Mal einem Projekt hinzufügen, können Sie diesen Schritt ignorieren.

  2. Installieren Sie in Xcode die Firebase-Bibliotheken, indem Sie zu File > Add Packages (Datei > Pakete 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 neueste Version von Firebase.

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

Wenn Sie fertig sind, beginnt Xcode, die Paketabhängigkeiten aufzulösen und im Hintergrund herunterzuladen.

Über Package.swift

Wenn Sie Firebase über ein Package.swift-Manifest in ein Swift-Paket einbinden möchten, können Sie Firebase dem dependencies-Array Ihres Pakets hinzufügen. Weitere Informationen finden Sie in der Dokumentation zum Swift Package Manager.

dependencies: [

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

],

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

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

Produktspezifische Überlegungen

Für einige Firebase-Produkte sind zusätzliche Integrationsschritte erforderlich, damit sie richtig funktionieren.

Google Analytics

Google Analytics muss das Linker-Flag -ObjC den Build-Einstellungen des Ziels hinzugefügt werden, wenn es transitiv eingebunden ist.

Crashlytics

Crashlytics erfordert das Hochladen von Debug-Symbolen.

Sie können eine Build-Phase mit einem Ausführungsskript 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 Möglichkeit 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 achten Sie darauf, dass das Skript ausführbar ist:

chmod +x scripts/upload-symbols

Mit diesem Skript können Sie dSYM-Dateien manuell hochladen. Hinweise zur Verwendung und weitere Anleitungen für das Skript erhalten Sie, wenn Sie upload-symbols ohne Parameter ausführen.

CocoaPods

Firebase unterstützt neben dem Swift Package Manager auch die Installation mit CocoaPods.

Für die CocoaPods-Distribution von Firebase sind Xcode 16.2 und CocoaPods 1.12.0 oder höher erforderlich. So installieren Sie Firebase mit CocoaPods:

  1. Erstellen Sie eine Podfile-Datei, falls noch keine vorhanden ist. Führen Sie im Stammverzeichnis Ihres Projekts den folgenden Befehl aus:

    pod init

  2. Fügen Sie Ihrer Podfile-Datei die Firebase-Pods hinzu, die Sie in Ihrer App verwenden möchten.

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

    Analytics aktiviert 

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

    Weitere Informationen zu IDFA, der Werbe-ID auf Geräteebene, finden Sie in der Apple-Dokumentation zum Datenschutz und zur Datennutzung von Nutzern und zur App Tracking Transparency.

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

  3. Installieren Sie die Pods und öffnen Sie dann Ihre .xcworkspace-Datei, um das Projekt in Xcode zu sehen:

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

Produktspezifische Überlegungen

Für einige Firebase-Produkte sind zusätzliche Integrationsschritte erforderlich, damit sie richtig funktionieren.

Crashlytics

Crashlytics erfordert das Hochladen von Debug-Symbolen.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Die Unterstützung von Carthage ist experimentell. Eine Anleitung zum Einbinden von Firebase in Ihre App über Carthage finden Sie auf GitHub.

Manuell einbinden

Firebase bietet eine vorkompilierte binäre XCFramework-Distribution für Nutzer, die Firebase ohne Abhängigkeitsmanager einbinden möchten. So installieren Sie Firebase:

  1. Laden Sie die ZIP-Datei des Framework-SDK herunter. Diese Datei enthält Architekturslices für alle verfügbaren Zielarchitekturen für alle Firebase SDKs. Der Download kann daher einige Zeit dauern.

  2. Entpacken Sie die Datei und lesen Sie die Datei README für die Frameworks, die Sie in Ihre App einbinden möchten.

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