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 von Swift Package Manager ist Version 15.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 einem Projekt zum ersten Mal hinzufügen, können Sie diesen Schritt ignorieren.

  2. Installieren Sie die Firebase-Bibliotheken in Xcode. Gehen Sie dazu zu File > Add Packages (Datei > Pakete hinzufügen).

  3. Wählen Sie in der Eingabeaufforderung das GitHub-Repository von Firebase 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 aufnehmen möchten.

Sobald Sie fertig sind, beginnt Xcode, Ihre Paketabhängigkeiten im Hintergrund aufzulösen und 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 für 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, das Firebase-Produkt 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 ordnungsgemäß funktionieren.

Google Analytics

Für Google Analytics muss das -ObjC-Linker-Flag den Build-Einstellungen des Ziels hinzugefügt werden, wenn es transitivermaßen eingebunden ist.

Crashlytics

Für Crashlytics müssen Sie Symbole zum Debuggen hochladen.

Sie können eine Buildphase mit einem Run Script für Xcode verwenden, um Debugsymbole 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 das Script upload-symbols. Platzieren Sie das Script in einem Unterverzeichnis Ihrer Projektdatei (z. B. scripts/upload-symbols) und achten Sie darauf, dass es ausführbar ist:

chmod +x scripts/upload-symbols

Mit diesem Script können Sie dSYM-Dateien manuell hochladen. Hinweise zur Verwendung und zusätzliche Anweisungen für das Script 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 15.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 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 eines der 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 ‘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'

    Weitere Informationen zur IDFA, der Werbe-ID auf Geräteebene, finden Sie in der Dokumentation von Apple zu Datenschutz und Datennutzung 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 zu sehen:

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

Produktspezifische Überlegungen

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

Crashlytics

Für Crashlytics müssen Sie Symbole zum Debuggen hochladen.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

Karthago

Die Unterstützung von Carthage befindet sich in der experimentellen Phase. Eine Anleitung zum Einbinden von Firebase in Ihre App über Carthage finden Sie auf GitHub.

Manuell einbinden

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

  1. Lade das Framework SDK als ZIP-Datei herunter. Diese Datei enthält Architektur-Slices für alle verfügbaren Zielarchitekturen für alle Firebase SDKs. Daher kann der Download einige Zeit in Anspruch nehmen.

  2. Entpacken Sie die Datei und suchen Sie in der README nach den Frameworks, die Sie in Ihre App aufnehmen möchten.

  3. Fügen Sie das -ObjC-Linker-Flag in der Datei Other Linker Settings in den Build-Einstellungen des Ziels hinzu.