Optionen zum Installieren von Firebase in Ihrer Apple-App

Swift Package Manager

Für neue Projekte wird Swift Package Manager empfohlen.

Über Xcode

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

  1. Wenn Sie ein Projekt migrieren, das auf CocoaPods basiert, führen Sie pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte Datei .xcworkspace kann danach gefahrlos 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 gehen.

  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 gewünschte Firebase-Version aus. 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 einbeziehen möchten.

Anschließend 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 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-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

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

Crashlytics

Für Crashlytics müssen Sie Debugging-Symbole hochladen.

Sie können eine Build-Phase mit einem Ausführungsskript für Xcode verwenden, um Debugsymbole nach dem Build automatisch hochzuladen. Das Ausführungsscript 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 Skripts upload-symbols. Platzieren Sie das Script in einem Unterverzeichnis Ihrer Projektdatei (z. B. scripts/upload-symbols) und sorgen Sie dafür, dass das Script ausführbar ist:

chmod +x scripts/upload-symbols

Mit diesem Skript können Sie dSYM-Dateien manuell hochladen. Wenn Sie Hinweise zur Verwendung und zusätzliche Anleitungen für das Script benötigen, führen Sie upload-symbols ohne Parameter aus.

CocoaPods

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

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

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

    pod init

  2. Fügen Sie Ihrem Podfile 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 zum IDFA, der Werbe-ID auf Geräteebene, finden Sie in der Dokumentation von Apple zu User Privacy and Data Use und 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 die Datei .xcworkspace, um das Projekt in Xcode aufzurufen:

    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

Für Crashlytics müssen Sie Debugging-Symbole hochladen.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Karthago

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

Manuell einbinden

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

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

  2. Entpacken Sie die Datei und sehen Sie sich dann die README an, um die Frameworks zu finden, die Sie in Ihre App aufnehmen möchten.

  3. Fügen Sie in den Buildeinstellungen des Ziels das -ObjC-Linker-Flag in Other Linker Settings ein.