Vorbereitung
Installieren Sie Folgendes:
- Xcode 15.2 oder höher
Ihr Projekt muss die folgenden Anforderungen erfüllen:
- Ihr Projekt muss auf die folgenden oder höheren Plattformversionen ausgerichtet sein:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Ihr Projekt muss auf die folgenden oder höheren Plattformversionen ausgerichtet sein:
Richten Sie ein physisches Apple-Gerät ein oder verwenden Sie einen Simulator, um Ihre App auszuführen.
Möchtest du Cloud Messaging verwenden?
Für Cloud Messaging auf Apple-Plattformen gelten die folgenden Voraussetzungen:
- Richten Sie ein physisches Apple-Gerät ein.
- Holen Sie sich einen Apple Push Notification-Authentifizierungsschlüssel für Ihr Apple-Entwicklerkonto.
- Aktivieren Sie Push-Benachrichtigungen in Xcode unter App > Funktionen.
Wenn Sie noch kein Xcode-Projekt haben und nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Schnellstartbeispiele herunterladen.
Schritt 1: Firebase-Projekt erstellen
Bevor Sie Firebase zu Ihrer Apple-App hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrer App herzustellen. Weitere Informationen zu Firebase-Projekten finden Sie unter Firebase-Projekte.
Firebase-Projekt erstellen
-
Klicken Sie in der Firebase Console auf Projekt hinzufügen.
-
Wenn Sie einem vorhandenen Google Cloud-Projekt Firebase-Ressourcen hinzufügen möchten, geben Sie den Projektnamen ein oder wählen Sie ihn aus dem Drop-down-Menü aus.
-
Geben Sie den gewünschten Projektnamen ein, um ein neues Projekt zu erstellen. Optional können Sie auch die Projekt-ID bearbeiten, die unter dem Projektnamen angezeigt wird.
-
-
Lesen Sie sich die Firebase-Nutzungsbedingungen durch und akzeptieren Sie sie.
-
Klicken Sie auf Weiter.
-
Optional: Richten Sie Google Analytics für Ihr Projekt ein, um die folgenden Firebase-Produkte optimal nutzen zu können:
Wählen Sie entweder ein vorhandenes Google Analytics-Konto aus oder erstellen Sie ein neues Konto.
Wenn Sie ein neues Konto erstellen, wählen Sie Ihren AnalyticsSpeicherort für Berichte aus und akzeptieren Sie die Datenfreigabeeinstellungen und Google Analytics-Nutzungsbedingungen für Ihr Projekt.
-
Klicken Sie auf Projekt erstellen (oder auf Firebase hinzufügen, wenn Sie ein vorhandenes Google Cloud-Projekt verwenden).
Firebase stellt automatisch Ressourcen für Ihr Firebase-Projekt bereit. Nach Abschluss des Vorgangs werden Sie zur Übersichtsseite für Ihr Firebase-Projekt in der Firebase Console weitergeleitet.
Schritt 2: App bei Firebase registrieren
Wenn Sie Firebase in Ihrer Apple-App verwenden möchten, müssen Sie Ihre App in Ihrem Firebase-Projekt registrieren. Die Registrierung Ihrer App wird oft als „Hinzufügen“ der App zu Ihrem Projekt bezeichnet.
Rufen Sie die Firebase Console auf.
Klicken Sie in der Mitte der Projektübersicht auf das Symbol iOS+, um den Einrichtungsworkflow zu starten.
Wenn Sie Ihrem Firebase-Projekt bereits eine App hinzugefügt haben, klicken Sie auf App hinzufügen, um die Plattformoptionen aufzurufen.
Geben Sie die Bundle-ID Ihrer App in das Feld Bundle-ID ein.
Was ist eine Bundle-ID und wo finde ich sie?
Eine Bundle-ID identifiziert eine Anwendung im Apple-System eindeutig.
Paket-ID ermitteln: Öffnen Sie Ihr Projekt in Xcode, wählen Sie im Project Navigator die App der obersten Ebene aus und dann den Tab Allgemein.
Der Wert des Felds Bundle Identifier (Paket-ID) ist die Paket-ID (z. B.
com.yourcompany.yourproject
).Beachten Sie, dass bei der Bundle-ID die Groß- und Kleinschreibung beachtet wird. Sie kann für diese Firebase App nicht mehr geändert werden, nachdem sie in Ihrem Firebase-Projekt registriert wurde.
Optional: Geben Sie weitere App-Informationen ein: App-Alias und App Store-ID.
Wie werden der App-Spitzname und die App Store-ID in Firebase verwendet?
App-Alias: Eine interne, praktische Kennung, die nur in der Firebase-Konsole angezeigt wird.
App Store-ID: Wird von Firebase Dynamic Links verwendet, um Nutzer auf Ihre App Store-Seite weiterzuleiten, und von Google Analytics, um Conversion-Ereignisse in Google Ads zu importieren. Wenn Ihre App noch keine App Store-ID hat, können Sie sie später in den Projekteinstellungen hinzufügen.
Klicken Sie auf App registrieren.
Schritt 3: Firebase-Konfigurationsdatei hinzufügen
Klicken Sie auf GoogleService-Info.plist herunterladen, um die Konfigurationsdatei für Firebase-Apple-Plattformen (
GoogleService-Info.plist
) abzurufen.Was muss ich über diese Konfigurationsdatei wissen?
Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht verborgene Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Firebase-Projekte.
Sie können Ihre Firebase-Konfigurationsdatei jederzeit wieder herunterladen.
Achten Sie darauf, dass der Name der Konfigurationsdatei keine zusätzlichen Zeichen wie z. B.
(2)
enthält.
Verschieben Sie die Konfigurationsdatei in das Stammverzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung aus, dass die Konfigurationsdatei allen Zielen hinzugefügt werden soll.
Wenn Sie mehrere Bundle-IDs in Ihrem Projekt haben, müssen Sie jede Bundle-ID mit einer registrierten App in der Firebase-Konsole verknüpfen, damit jede App eine eigene GoogleService-Info.plist
-Datei haben kann.
Schritt 4: Firebase SDKs zur App hinzufügen
Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.
- Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
- Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
- Wählen Sie die SDK-Version aus, die Sie verwenden möchten.
Wählen Sie die Firebase-Bibliotheken aus, die Sie verwenden möchten.
Wenn Google Analytics in Ihrem Firebase-Projekt aktiviert ist, fügen Sie
FirebaseAnalytics
hinzu. Bei Analytics ohne Funktion für die IDFA-Erfassung fügen Sie stattdessenFirebaseAnalyticsWithoutAdId
hinzu.
https://github.com/firebase/firebase-ios-sdk
Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.
Schritt 5: Firebase in Ihrer App initialisieren
Im letzten Schritt fügen Sie Ihrer Anwendung den Initialisierungscode hinzu. Möglicherweise haben Sie das bereits getan, als Sie Firebase Ihrer App hinzugefügt haben. Wenn Sie ein Beispielprojekt für den Schnellstart verwenden, wurde dies bereits für Sie erledigt.
- Importieren Sie das
FirebaseCore
-Modul in IhreUIApplicationDelegate
sowie alle anderen Firebase-Module, die Ihr App-Delegat verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentication:import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Konfigurieren Sie eine freigegebene Instanz von
FirebaseApp
in derapplication(_:didFinishLaunchingWithOptions:)
-Methode Ihres App-Delegierten:// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs [FIRApp configure];
- Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegierten erstellen und über
UIApplicationDelegateAdaptor
oderNSApplicationDelegateAdaptor
an dasApp
-Objekt anhängen. Außerdem müssen Sie das App-Delegate-Swizzling deaktivieren. Weitere Informationen finden Sie in der SwiftUI-Anleitung.@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Wenn Sie das Firebase SDK für Google Analytics eingebunden haben, können Sie Ihre App ausführen, um der Firebase-Konsole zu bestätigen, dass Sie Firebase erfolgreich installiert haben.
Geschafft! Sie können mit den nächsten Schritten fortfahren.
Wenn Sie jedoch Probleme bei der Einrichtung haben, lesen Sie den Hilfeartikel Fehlerbehebung und FAQs zu Apple-Plattformen.
Verfügbare Bibliotheken
In diesem Abschnitt sind die Firebase-Produkte aufgeführt, die für Apple-Plattformen unterstützt werden. Weitere Informationen zu diesen Firebase-Bibliotheken für Apple-Plattformen:
Dienstleistung oder Produkt | Pods | SwiftPM-Bibliotheken | Google Analytics: ">Analytics hinzufügen? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
– | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(erforderlich) |
Firebase Installationen | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML APIs für benutzerdefinierte Modelle | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
Integration ohne Swift Package Manager
Wenn Sie den Swift Package Manager nicht verwenden möchten, können Sie die Firebase SDKs trotzdem nutzen, indem Sie CocoaPods verwenden oder die Frameworks direkt importieren.
CocoaPods
Weitere Informationen zur Einbindung von CocoaPods findest du in unserem Leitfaden.
Frameworks
Die ZIP-Datei unterstützt jetzt nicht nur die iOS-Plattform, sondern auch .xcframework
-Dateien. Weitere Informationen finden Sie in der README-Datei des Firebase SDK für Apple-Plattformen auf GitHub.
Lade das Framework SDK als ZIP-Datei herunter. Diese Datei hat eine Größe von etwa 200 MB und der Download kann einige Zeit in Anspruch nehmen.
Entpacken Sie die Datei und integrieren Sie dann die Frameworks, die Sie in Ihre App aufnehmen möchten.
Eine Anleitung zur Integration finden Sie an den folgenden Stellen:
- Im GitHub-Repository des Firebase iOS SDK
- In der Datei
README.md
in der heruntergeladenen ZIP-Distribution.
Informationen zu Framework-Versionen oder Abhängigkeiten finden Sie in der Datei
METADATA.md
in der heruntergeladenen ZIP-Datei.Fügen Sie das
-ObjC
-Linker-Flag in der DateiOther Linker Settings
in den Build-Einstellungen des Ziels hinzu.
Nächste Schritte
Weitere Informationen zu Firebase:
Unter Firebase-Projekte finden Sie weitere Informationen zu Firebase-Projekten und Best Practices für Projekte.
Firebase-Beispiel-Apps ansehen
Im Firebase iOS-Codelab können Sie praktische Erfahrungen sammeln.
Sehen Sie sich den Open-Source-Code auf GitHub an.
Einführung der App vorbereiten:
- Richten Sie in der Google Cloud Console Budgetbenachrichtigungen für Ihr Projekt ein.
- Im Firebase-Dashboard Nutzung und Abrechnung können Sie sich ein Gesamtbild der Nutzung Ihres Projekts in mehreren Firebase-Diensten machen.
- Sehen Sie sich die Checkliste für die Einführung von Firebase an.
Sie haben Probleme mit Firebase und Ihrem Apple-Projekt? Fehlerbehebung und FAQs zu Apple-Plattformen
Fügen Sie Ihrer App Firebase-Dienste hinzu:
Mit Analytics erhalten Sie Informationen zum Nutzerverhalten.
Richten Sie die Nutzerauthentifizierung mit Authentication ein.
Speichern Sie Daten wie Nutzerinformationen mit Cloud Firestore oder Realtime Database.
Mit Cloud Storage können Sie Dateien wie Fotos und Videos speichern.
Mit Cloud Functions können Sie Back-End-Code auslösen, der in einer sicheren Umgebung ausgeführt wird.
Benachrichtigungen mit Cloud Messaging senden
Mit Crashlytics können Sie herausfinden, wann und warum Ihre App abstürzt.