Swift Package Manager
Firebase empfiehlt für neue Projekte Swift Package Manager.
Über Xcode
Für die Unterstützung von Swift Package Manager ist Version 15.2 oder höher erforderlich.
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 generierten.xcworkspace
-Datei anschließend sicher gelöscht werden. Wenn Sie Firebase einem Projekt zum ersten Mal hinzufügen, können Sie diesen Schritt ignorieren.Installieren Sie die Firebase-Bibliotheken in Xcode unter File > Add Packages (Datei > Pakete hinzufügen).
Wählen Sie in der angezeigten Eingabeaufforderung das Firebase GitHub-Repository aus:
https://github.com/firebase/firebase-ios-sdk.git
Wählen Sie die Version von Firebase aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir die neueste Version von Firebase.
Wählen Sie die Firebase-Bibliotheken aus, die Sie in Ihre App einbinden möchten.
Anschließend beginnt Xcode mit der Auflösung der Paketabhängigkeiten. wenn sie im Hintergrund heruntergeladen werden.
Ü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 unter
die
Dokumentation zum Swift-Paketmanager
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, zum
dependencies
-Array
dieses Ziels erreicht.
.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 eingeschlossen ist.
Crashlytics
Crashlytics erfordert, dass Sie Fehlerbehebungssymbole hochladen.
Sie können eine Script-Build-Phase für Xcode verwenden, um die Fehlerbehebung automatisch hochzuladen Symbole nach der Erstellung. 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
. 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 Anleitungen 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 So installieren Sie Firebase mit CocoaPods:
Erstellen Sie eine Podfile-Datei, falls noch keine vorhanden ist. Führen Sie im Stammverzeichnis Ihres Projektverzeichnisses den folgenden Befehl aus:
pod init
Fügen Sie der Podfile-Datei die Firebase-Pods hinzu, die Sie in Ihrer Anwendung verwenden möchten.
Sie können alle unterstützten Firebase-Produkte in Ihre App einbinden.
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'
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
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 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. 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:
Lade das Framework SDK-Zip-Archiv herunter. Diese Datei enthält Architektursegmente für alle verfügbaren Zielarchitekturen für alle Firebase SDKs. der Download einige Zeit in Anspruch nimmt.
Entpacken Sie die Datei und suchen Sie in der
README
nach den Frameworks, die Sie in Ihre App aufnehmen möchten.Fügen Sie das
-ObjC
-Linker-Flag in derOther Linker Settings
in den Build-Einstellungen des Ziels hinzu.