Optionen zum Installieren von Firebase in Ihrer Apple-App

Swift-Paketmanager

Firebase empfiehlt für neue Projekte Swift Package Manager.

Über Xcode

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

  1. Bei der Migration von einem CocoaPods-basierten Projekt führen Sie pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt. Die von CocoaPods generierten .xcworkspace -Datei anschließend sicher gelöscht werden. Wenn Sie Firebase einem Projekt hinzufügen kann dieser Schritt ignoriert werden.

  2. Installieren Sie in Xcode die Firebase-Bibliotheken, indem Sie Datei > Pakete hinzufügen.

  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 neueste Version von Firebase zu verwenden.

  5. Wählen Sie die Firebase-Bibliotheken aus, die Sie in Ihre App einbinden 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 Füge Firebase zum dependencies-Array des Pakets hinzu. 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 es dann in jedem von einem Firebase-Produkt abhängigen Ziel zum dependencies-Array dieses Ziels erreicht.

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

Produktspezifische Überlegungen

Einige Firebase-Produkte funktionieren nur mit zusätzlichen Integrationsschritten korrekt sind.

Google Analytics

Für Google Analytics muss das Verknüpfungs-Flag -ObjC dem Zielelement hinzugefügt werden Build-Einstellungen, wenn sie vorübergehend enthalten sind.

Crashlytics

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

Sie können eine Script-Build-Phase für Xcode verwenden, um die Fehlerbehebung automatisch hochzuladen Symbole nach der Erstellung. Hier finden Sie das Ausführungsskript:

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

Eine weitere Möglichkeit zum Hochladen von Symbolen ist die Verwendung des upload-symbols . Speichern Sie das Skript in einem Unterverzeichnis Ihrer Projektdatei, z. B. scripts/upload-symbols) und prüfen Sie, ob das Skript ausführbar ist:

chmod +x scripts/upload-symbols

Mit diesem Skript können dSYM-Dateien manuell hochgeladen werden. Für Nutzungshinweise und zusätzliche Anweisungen für das Skript finden, führen Sie upload-symbols ohne Parameter.

CocoaPods

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

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

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

    pod init

  2. Fügen Sie der Podfile-Datei die Firebase-Pods hinzu, die Sie in Ihrer Anwendung 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 Datenschutz und Datennutzung und App Tracking Transparency Dokumentation.

    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:

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

Produktspezifische Überlegungen

Einige Firebase-Produkte funktionieren nur mit zusätzlichen Integrationsschritten korrekt sind.

Crashlytics

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

Sie können eine Script-Build-Phase für Xcode verwenden, um die Fehlerbehebung automatisch hochzuladen Symbole nach der Erstellung. Hier finden Sie das Ausführungsskript:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Karthago

Die Unterstützung für Karthago ist experimentell. Weitere Informationen finden Sie in der Anleitung auf GitHub um Firebase über Carthage in Ihre App einzubinden.

Manuell einbinden

Firebase bietet eine vordefinierte binäre XCFramework-Verteilung für Nutzer, die um Firebase ohne Abhängigkeitsmanager zu integrieren. So installieren Sie Firebase:

  1. Laden Sie die Framework SDK-ZIP herunter. Diese Datei enthält Architektursegmente für alle verfügbaren Zielarchitekturen für alle Firebase SDKs. der Download einige Zeit in Anspruch nimmt.

  2. Entpacken Sie die Datei und sehen Sie sich dann unter README die Frameworks an, die Sie ausführen möchten. die Sie in Ihrer App verwenden können.

  3. -ObjC-Verknüpfung hinzufügen in Ihrem Konto Other Linker Settings in den Build-Einstellungen des Ziels.