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.
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.Installieren Sie in Xcode die Firebase-Bibliotheken, indem Sie 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 gewünschte Firebase-Version aus. Für neue Projekte empfehlen wir, die neueste Version von Firebase zu verwenden.
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:
Erstellen Sie eine Podfile-Datei, falls Sie noch keine haben. 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 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'
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:
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.
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.-ObjC
-Verknüpfung hinzufügen in Ihrem KontoOther Linker Settings
in den Build-Einstellungen des Ziels.