Fügen Sie Ihrem Apple-Projekt Firebase hinzu

Voraussetzungen

• Folgendes installieren:

  • Xcode 13.3.1 oder höher

• Stellen Sie sicher, dass Ihr Projekt diese Anforderungen erfüllt:

  • Ihr Projekt muss auf diese Plattformversionen oder höher ausgerichtet sein:
    • iOS 11
    • macOS 10.13
    • tvOS 12
    • watchOS 6

• Richten Sie ein physisches Apple-Gerät ein oder verwenden Sie einen Simulator, um Ihre App auszuführen.

  Möchten Sie Cloud Messaging verwenden?

  Für Cloud Messaging auf Apple-Plattformen sind dies die Voraussetzungen:

  • Richten Sie ein physisches Apple-Gerät ein.
  • Fordern Sie einen Authentifizierungsschlüssel für Apple-Push-Benachrichtigungen für Ihr Apple-Entwicklerkonto an.
  • Aktivieren Sie Push-Benachrichtigungen in Xcode unter App > Capabilities .

• 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 Schnellstart-Beispiele herunterladen.

Schritt 1 : Erstellen Sie ein Firebase-Projekt

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. Besuchen Sie Firebase-Projekte verstehen, um mehr über Firebase-Projekte zu erfahren.

Erstellen Sie ein Firebase-Projekt

1. Klicken Sie in der Firebase-Konsole auf Projekt hinzufügen .

   • Geben Sie zum Hinzufügen von Firebase-Ressourcen zu einem vorhandenen Google Cloud-Projekt seinen Projektnamen ein oder wählen Sie ihn aus dem Dropdown-Menü aus.

   • Um ein neues Projekt anzulegen, geben Sie den gewünschten Projektnamen ein. Optional können Sie auch die unterhalb des Projektnamens angezeigte Projekt-ID bearbeiten.

     Firebase generiert basierend auf dem Namen, den Sie ihm geben, eine eindeutige ID für Ihr Firebase-Projekt. Wenn Sie diese Projekt-ID bearbeiten möchten, müssen Sie dies jetzt tun, da sie nicht mehr geändert werden kann, nachdem Firebase Ressourcen für Ihr Projekt bereitgestellt hat. Besuchen Sie Firebase-Projekte verstehen , um zu erfahren, wie Firebase die Projekt-ID verwendet.

2. Wenn Sie dazu aufgefordert werden, lesen und akzeptieren Sie die Firebase-Nutzungsbedingungen .

3. Klicken Sie auf Weiter .

4. (Optional) Richten Sie Google Analytics für Ihr Projekt ein, damit Sie mit einem der folgenden Firebase-Produkte ein optimales Erlebnis haben:

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase-In-App-Messaging Firebase-Remote-Konfiguration

   Remote Config-Personalisierung Firebase A/B-Tests

   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 Standort für Analytics-Berichte aus und akzeptieren Sie dann die Einstellungen für die Datenfreigabe und die Google Analytics-Nutzungsbedingungen für Ihr Projekt.

   Sie können Google Analytics später jederzeit auf der Registerkarte „ Integrationen “ Projekteinstellungen einrichten.

5. 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. Wenn der Vorgang abgeschlossen ist, werden Sie zur Übersichtsseite für Ihr Firebase-Projekt in der Firebase-Konsole weitergeleitet.

Schritt 2 : Registrieren Sie Ihre App bei Firebase

Um Firebase in Ihrer Apple-App zu verwenden, müssen Sie Ihre App bei Ihrem Firebase-Projekt registrieren. Das Registrieren Ihrer App wird oft als „Hinzufügen“ Ihrer App zu Ihrem Projekt bezeichnet.

Hinweis: Sehen Sie sich unsere Best Practices zum Hinzufügen von Apps zu einem Firebase-Projekt an, einschließlich Informationen zum Umgang mit mehreren Varianten.

1. Gehen Sie zur Firebase-Konsole .

2. Klicken Sie in der Mitte der Projektübersichtsseite auf das iOS+ -Symbol, 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 anzuzeigen.

3. Geben Sie die Bundle-ID Ihrer App in das Feld „ Bundle-ID “ ein.

   Was ist eine Paket-ID und wo finden Sie sie?

   • Eine Bundle-ID identifiziert eine Anwendung im Apple-Ökosystem eindeutig.

   • Finden Sie Ihre Bundle-ID: Öffnen Sie Ihr Projekt in Xcode, wählen Sie die App der obersten Ebene im Projektnavigator aus und wählen Sie dann die Registerkarte Allgemein aus.

     Der Wert des com.yourcompany.yourproject ) .

   • Beachten Sie, dass beim Bundle-ID-Wert zwischen Groß- und Kleinschreibung unterschieden wird und er für diese Firebase-App nicht mehr geändert werden kann, nachdem sie bei Ihrem Firebase-Projekt registriert wurde.

   Stellen Sie sicher, dass Sie die Bundle-ID eingeben, die Ihre App tatsächlich verwendet. Beim Paket-ID-Wert wird zwischen Groß- und Kleinschreibung unterschieden und er kann für diese Firebase-App von Apple nicht geändert werden, nachdem sie bei Ihrem Firebase-Projekt registriert wurde.

4. (Optional) Geben Sie weitere App-Informationen ein: App-Nickname und App Store-ID .

   Wie werden der App-Nickname und die App Store-ID in Firebase verwendet?

   • App-Nickname : Eine interne, praktische Kennung, die nur für Sie in der Firebase-Konsole 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.

5. Klicken Sie auf App registrieren .

Schritt 3 : Fügen Sie eine Firebase-Konfigurationsdatei hinzu

1. Klicken Sie auf GoogleService-Info.plist herunterladen , um die Konfigurationsdatei für Ihre Firebase-Apple-Plattformen ( GoogleService-Info.plist ) abzurufen.

   Was müssen Sie über diese Konfigurationsdatei wissen?

   • Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht geheime Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Firebase-Projekte verstehen .

   • Sie können Ihre Firebase-Konfigurationsdatei jederzeit erneut herunterladen.

   • Stellen Sie sicher, dass dem Namen der Konfigurationsdatei keine zusätzlichen Zeichen wie (2) angehängt werden.

2. Verschieben Sie Ihre Konfigurationsdatei in das Stammverzeichnis Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, wählen Sie aus, dass die Konfigurationsdatei allen Zielen hinzugefügt werden soll.

Wenn Sie in Ihrem Projekt mehrere Paket-IDs haben, müssen Sie jede Paket-ID mit einer registrierten App in der Firebase-Konsole verknüpfen, damit jede App ihre eigene GoogleService-Info.plist Datei haben kann.

Schritt 4 : Fügen Sie Firebase SDKs zu Ihrer App hinzu

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

Besuchen Sie unsere Installationsanleitung , um mehr über die verschiedenen Möglichkeiten zu erfahren, wie Sie Firebase SDKs zu Ihrem Apple-Projekt hinzufügen können, einschließlich des direkten Imports von Frameworks und der Verwendung von CocoaPods.

1. Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
2. Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple-Plattform-SDK-Repository hinzu:

  https://github.com/firebase/firebase-ios-sdk

3. Wählen Sie die SDK-Version aus, die Sie verwenden möchten.
   Hinweis: Wir empfehlen die Verwendung der standardmäßigen (neuesten) SDK-Version, aber Sie können bei Bedarf eine ältere Version auswählen.

4. Wählen Sie die Firebase-Bibliotheken aus, die Sie verwenden möchten.

   Wenn Google Analytics in Ihrem Firebase-Projekt aktiviert ist, stellen Sie sicher, dass Sie FirebaseAnalytics hinzufügen. Fügen Sie für Analytics ohne IDFA-Erfassungsfunktion stattdessen FirebaseAnalyticsWithoutAdId hinzu.

Wenn Sie fertig sind, beginnt Xcode automatisch mit dem Auflösen und Herunterladen Ihrer Abhängigkeiten im Hintergrund.

Schritt 5 : Initialisieren Sie Firebase in Ihrer App

Der letzte Schritt besteht darin, Ihrer Anwendung Initialisierungscode hinzuzufügen. Möglicherweise haben Sie dies bereits beim Hinzufügen von Firebase zu Ihrer App getan. Wenn Sie ein Schnellstart-Beispielprojekt verwenden, wurde dies für Sie erledigt.

1. Importieren Sie das FirebaseCore -Modul in Ihr UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegierter verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentifizierung:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Schnell

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Ziel c

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Konfigurieren Sie eine freigegebene FirebaseApp -Instanz in der Methode application(_:didFinishLaunchingWithOptions:) Ihres App-Delegaten:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Schnell

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Ziel c

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegaten erstellen und ihn über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App -Struktur anfügen. Sie müssen auch das Swizzling von App-Delegaten deaktivieren. Weitere Informationen finden Sie in den SwiftUI-Anweisungen .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Wenn Sie das Firebase SDK für Google Analytics eingebunden 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 .

Wenn Sie jedoch Probleme bei der Einrichtung haben, besuchen Sie die Fehlerbehebung und FAQ für Apple-Plattformen .

Hinweis: Wenn Sie auf macOS oder macOS Catalyst abzielen, müssen Sie Ihrem Ziel die Schlüsselbundfreigabefunktion hinzufügen. Navigieren Sie in Xcode zur Registerkarte Signing & Capabilities Ihres Ziels und klicken Sie dann auf + Capabilities , um eine neue Funktion hinzuzufügen.

Verfügbare Bibliotheken

In diesem Abschnitt werden die Firebase-Produkte aufgeführt, die für Apple-Plattformen unterstützt werden. Erfahren Sie mehr über diese Apple-Plattformbibliotheken von Firebase:

• Referenzdokumentation ( Swift | Obj-C )

• Firebase Apple Plattformen SDK GitHub Repo

Für Apps, die CocoaPods verwenden, ist der Firebase -Pod in Version 9.0 und höher veraltet. Stattdessen müssen Sie Produkt-Pods direkt in Ihrer Pod-Datei referenzieren (z. B. FirebaseCore anstelle von Firebase/Core und FirebaseFirestore anstelle von Firebase/Firestore ).

Dienstleistung oder Produkt	Hülsen	SwiftPM-Bibliotheken	Analytics hinzufügen?
AdMob	pod 'Google-Mobile-Ads-SDK'	N / A
Analytik	pod 'FirebaseAnalytics'	FirebaseAnalytics
App-Check	pod 'FirebaseAppCheck'	FirebaseAppCheck
App-Verteilung	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
Authentifizierung	pod 'FirebaseAuth'	FirebaseAuth
Cloud-Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
Cloud-Funktionen für das Firebase-Client-SDK	pod 'FirebaseFunctions'	FirebaseFunctions
Cloud-Messaging	pod 'FirebaseMessaging'	FirebaseMessaging
Cloud-Speicher	pod 'FirebaseStorage'	FirebaseStorage
Crashlytics	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
Dynamische 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
Leistungsüberwachung	pod 'FirebasePerformance'	FirebasePerformance
Echtzeit-Datenbank	pod 'FirebaseDatabase'	FirebaseDatabase
Remote-Konfig	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

Integrieren Sie, ohne den Swift Package Manager zu verwenden

Wenn Sie Swift Package Manager nicht verwenden möchten, können Sie die Vorteile der Firebase SDKs dennoch nutzen, indem Sie CocoaPods verwenden oder die Frameworks direkt importieren.

KakaoPods

Erfahren Sie mehr über die CocoaPods-Integration in unserem Leitfaden .

Rahmen

Zusätzlich zur Unterstützung der iOS-Plattform enthält die ZIP-Datei jetzt .xcframework Dateien. Einzelheiten finden Sie in der README-Datei zum Firebase-Apple-Plattform-SDK auf GitHub .

1. Laden Sie die Framework-SDK-ZIP-Datei herunter. Dies ist eine ca. 200 MB große Datei, deren Download einige Zeit in Anspruch nehmen kann.

2. Entpacken Sie die Datei und überprüfen Sie dann die README -Datei auf die Frameworks, die Sie in Ihre App einschließen möchten.

3. Fügen Sie das Linker-Flag -ObjC in Ihren Other Linker Settings in den Build-Einstellungen Ihres Ziels hinzu.

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.

• Erkunden Sie Beispiel-Firebase-Apps .

• Sammeln Sie praktische Erfahrungen mit dem Firebase iOS Codelab .

• Erkunden 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 das Nutzungs- und Abrechnungs -Dashboard in der Firebase-Konsole, um sich einen Überblick über die Nutzung Ihres Projekts über mehrere Firebase-Dienste hinweg zu verschaffen.
  • Überprüfen Sie die Firebase-Startcheckliste .

• Haben Sie Probleme mit Firebase und Ihrem Apple-Projekt? Besuchen Sie die Problembehandlung und FAQ für Apple-Plattformen .

Fügen Sie Ihrer App Firebase-Dienste hinzu:

• Gewinnen Sie mit Analytics Einblicke in das Nutzerverhalten.

• Richten Sie die Benutzerauthentifizierung mit Authentication ein.

• Speichern Sie Daten wie Benutzerinformationen mit Cloud Firestore oder Realtime Database .

• Speichern Sie Dateien wie Fotos und Videos mit Cloud Storage .

• Lösen Sie mit Cloud Functions Back-End-Code aus, der in einer sicheren Umgebung ausgeführt wird.

• Senden Sie Benachrichtigungen mit Cloud Messaging .

• Finden Sie mit Crashlytics heraus, wann und warum Ihre App abstürzt.