Voraussetzungen
Installieren Sie Folgendes:
- Xcode 12.2 oder höher
- CocoaPods 1.10.0 oder höher
Stellen Sie sicher, dass Ihr Projekt die folgenden Anforderungen erfüllt:
- Ihr Projekt muss auf iOS 10 oder höher ausgerichtet sein.
Richten Sie ein physisches iOS-Gerät ein oder verwenden Sie den iOS-Simulator, um Ihre App auszuführen.
Für Cloud Messaging unter iOS gelten folgende Voraussetzungen:
- Richten Sie ein physisches iOS-Gerät ein .
- Erhalten Sie einen Apple Push Notification-Authentifizierungsschlüssel für Ihr Apple Developer-Konto .
- Aktivieren Sie Push-Benachrichtigungen in Xcode unter App> Funktionen .
- Melden Sie sich mit Ihrem Google-Konto bei Firebase an .
Wenn Sie noch kein Xcode-Projekt haben und nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Schnellstartbeispiele herunterladen.
Schritt 1 : Erstellen Sie ein Firebase-Projekt
Bevor Sie Ihrer iOS-App Firebase hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrer iOS-App herzustellen. Besuchen Sie Firebase-Projekte verstehen , um mehr über Firebase-Projekte zu erfahren.
Schritt 2 : Registrieren Sie Ihre App bei Firebase
Nachdem Sie ein Firebase-Projekt erstellt haben, können Sie Ihre iOS-App hinzufügen.
Besuchen Sie Firebase-Projekte verstehen , um mehr über bewährte Methoden und Überlegungen zum Hinzufügen von Apps zu einem Firebase-Projekt zu erfahren, einschließlich der Behandlung mehrerer Build-Varianten.
Gehen Sie zur Firebase-Konsole .
Klicken Sie in der Mitte der
auf das iOS- Symbol ( ), um den Setup-Workflow zu starten.Wenn Sie Ihrem Firebase-Projekt bereits eine App hinzugefügt haben, klicken Sie auf App hinzufügen, um die Plattformoptionen anzuzeigen.
Geben Sie die Bundle-ID Ihrer App in das Feld iOS-Bundle-ID ein.
Eine Bundle-ID identifiziert eine Anwendung im Apple-Ökosystem eindeutig.
Suchen Sie Ihre Bundle-ID: Öffnen Sie Ihr iOS-Projekt in Xcode, wählen Sie die App der obersten Ebene im Projektnavigator aus und wählen Sie dann die Registerkarte Allgemein .
Der Wert des Felds Bundle Identifier ist die iOS-Bundle-ID (z. B.
com.yourcompany.yourproject
).Beachten Sie, dass bei der Bundle-ID zwischen Groß- und Kleinschreibung unterschieden wird und diese für diese Firebase iOS-App nicht geändert werden kann, nachdem sie bei Ihrem Firebase-Projekt registriert wurde.
(Optional) Geben Sie weitere App-Informationen ein: App-Kurzname und App Store-ID .
App-Spitzname : Eine interne Komfortkennung, die nur in der Firebase-Konsole für Sie sichtbar ist
App Store ID : Wird von Firebase Dynamic Links verwendet, um Benutzer auf Ihre App Store-Seite umzuleiten, und von Google Analytics, um Conversion-Ereignisse in Google Ads zu importieren . Wenn Ihre App noch keine App Store-ID hat, können Sie die ID später in Ihren Projekteinstellungen hinzufügen.
Klicken Sie auf App registrieren .
Schritt 3 : Fügen Sie eine Firebase-Konfigurationsdatei hinzu
Klicken Sie auf GoogleService-Info.plist herunterladen , um Ihre Firebase iOS-Konfigurationsdatei (
GoogleService-Info.plist
)GoogleService-Info.plist
.Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht geheime Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Grundlegendes zu Firebase-Projekten .
Sie können Ihre Firebase-Konfigurationsdatei jederzeit erneut herunterladen.
Stellen Sie sicher, dass der Name der Konfigurationsdatei nicht mit zusätzlichen Zeichen wie
(2)
.
Verschieben Sie Ihre Konfigurationsdatei in das Stammverzeichnis Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, wählen Sie, um die Konfigurationsdatei allen Zielen hinzuzufügen.
Wenn Ihr Projekt mehrere Bundle-IDs enthält, müssen Sie jede Bundle-ID einer registrierten App in der Firebase-Konsole GoogleService-Info.plist
, damit jede App über eine eigene GoogleService-Info.plist
Datei verfügt.
Schritt 4 : Fügen Sie Ihrer App Firebase-SDKs hinzu
Wir empfehlen die Verwendung von CocoaPods zur Installation der Firebase-Bibliotheken. Wenn Sie CocoaPods jedoch lieber nicht verwenden möchten, können Sie die SDK-Frameworks direkt integrieren oder den Swift Package Manager (Beta) verwenden .
Verwenden Sie eines der Schnellstartbeispiele ? Das Xcode-Projekt und die Poddatei (mit Pods) sind bereits vorhanden, Sie müssen jedoch noch Ihre Firebase-Konfigurationsdatei hinzufügen und die Pods installieren .
Erstellen Sie eine Poddatei, falls Sie noch keine haben:
cd your-project-directory
pod init
Fügen Sie Ihrer Poddatei die Firebase-Pods hinzu, die Sie in Ihrer App verwenden möchten.
Sie können Ihrer iOS-App jedes der unterstützten Firebase-Produkte hinzufügen.
Analytics aktiviert
platform :ios, ‘10.0’
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# 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 'Firebase/Auth' pod 'Firebase/Firestore'Analytics nicht aktiviert
platform :ios, ‘10.0’
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'Installieren Sie die Pods und öffnen Sie dann Ihre
.xcworkspace
Datei, um das Projekt in Xcode.xcworkspace
:pod install
open your-project.xcworkspace
Schritt 5 : Initialisieren Sie Firebase in Ihrer App
Der letzte Schritt besteht darin, Ihrer Anwendung Initialisierungscode hinzuzufügen. Möglicherweise haben Sie dies bereits getan, um Firebase zu Ihrer App hinzuzufügen. Wenn Sie ein Schnellstart-Beispielprojekt verwenden , wurde dies für Sie erledigt.
- Importieren Sie das Firebase-Modul in Ihr
UIApplicationDelegate
:Schnell
import Firebase
Ziel c
@import Firebase;
- Konfigurieren Sie eine freigegebene
FirebaseApp
Instanz, normalerweise in derapplication:didFinishLaunchingWithOptions:
Ihrer Appapplication:didFinishLaunchingWithOptions:
method:Schnell
// Use Firebase library to configure APIs FirebaseApp.configure()
Ziel c
// Use Firebase library to configure APIs [FIRApp configure];
- Wenn Sie Firebase Analytics hinzugefügt haben, können Sie Ihre App ausführen, um eine Bestätigung an die Firebase-Konsole zu senden, dass Sie Firebase erfolgreich installiert haben.
Das ist es! Sie können mit den nächsten Schritten fortfahren .
Verfügbare Pods
In diesem Abschnitt werden die für iOS unterstützten Firebase-Produkte und ihre Pods aufgelistet. Weitere Informationen zu diesen Firebase iOS-Bibliotheken:
Firebase iOS SDK GitHub Repo
Service oder Produkt | Pods | Analytics hinzufügen? |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
Analytik | pod 'Firebase/Analytics' | |
App-Verteilung | pod 'Firebase/AppDistribution' | |
Authentifizierung | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Cloud-Funktionen für Firebase Client SDK | pod 'Firebase/Functions' | |
Cloud Messaging | pod 'Firebase/Messaging' | |
Cloud-Speicher | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
Dynamische Links | pod 'Firebase/DynamicLinks' | |
In-App-Messaging | pod 'Firebase/InAppMessaging' | (erforderlich) |
Benutzerdefinierte Firebase ML-Modell-APIs | pod 'Firebase/MLModelDownloader' | |
Leistungsüberwachung | pod 'Firebase/Performance' | |
Echtzeitdatenbank | pod 'Firebase/Database' | |
Remote-Konfiguration | pod 'Firebase/RemoteConfig' |
Ohne CocoaPods integrieren
Wenn Sie keine Cocoapods verwenden möchten, können Sie die Firebase-SDKs weiterhin nutzen, indem Sie die Frameworks direkt importieren oder den Swift Package Manager verwenden.
Frameworks
Zusätzlich zur Unterstützung der iOS-Plattform enthält die Zip-Datei jetzt .xcframework-Dateien, die eine Community-basierte Catalyst-Unterstützung hinzufügen. Weitere Informationen finden Sie in der Firebase iOS SDK-README-Datei auf GitHub .
Laden Sie das Framework SDK zip herunter. Dies ist eine ~ 200 MB große Datei und das Herunterladen kann einige Zeit dauern.
Entpacken Sie die Datei und überprüfen Sie die
README
Datei auf die Frameworks, die Sie in Ihre App aufnehmen möchten.Fügen Sie das
ObjC
Linker-Flag in IhrenOther Linker Settings
in den Build-Einstellungen Ihres Ziels hinzu.
Schneller Paketmanager
Die Unterstützung von Swift Package Manager befindet sich derzeit in der Beta-Phase. Befolgen Sie die Dokumentation zu GitHub und senden Sie Feedback an den GitHub Issue Tracker .
Nächste Schritte
Erfahren Sie mehr über Firebase:
Besuchen Sie Firebase-Projekte verstehen , um mehr über Firebase-Projekte und Best Practices für Projekte zu erfahren.
Entdecken Sie Beispiel-Firebase-Apps .
Machen Sie praktische Erfahrungen mit dem Firebase iOS Codelab .
Entdecken Sie den Open Source Code in GitHub .
Bereiten Sie den Start Ihrer App vor:
- Richten Sie Budgetbenachrichtigungen für Ihr Projekt in der Google Cloud Console ein.
- Überwachen Sie Ihr Dashboard für Nutzung und Abrechnung in der Firebase-Konsole.
- Überprüfen Sie die Checkliste für den Firebase-Start .
Fügen Sie Ihrer App Firebase-Dienste hinzu:
Erhalten Sie mit Analytics Einblicke in das Benutzerverhalten.
Richten Sie die Benutzerauthentifizierung mit Authentifizierung ein .
Speichern Sie Daten wie Benutzerinformationen im Cloud Firestore oder in der Echtzeitdatenbank .
Speichern Sie Dateien wie Fotos und Videos mit Cloud Storage .
Lösen Sie Backend-Code aus, der in einer sicheren Umgebung mit Cloud-Funktionen ausgeführt wird .
Senden Sie Benachrichtigungen mit Cloud Messaging .
Finden Sie heraus, wann und warum Ihre App mit Crashlytics abstürzt.