了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Fügen Sie Ihrem Apple-Projekt Firebase hinzu

Voraussetzungen

  • Installieren Sie Folgendes:

    • Xcode 14.1 oder höher

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

    • Ihr Projekt muss auf diese Plattformversionen oder höher abzielen:
      • 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.

Wenn Sie noch kein Xcode-Projekt haben und einfach nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Schnellstartbeispiele 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.

Schritt 2 : Registrieren Sie Ihre App bei Firebase

Um Firebase in Ihrer Apple-App verwenden zu können, 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.

  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.

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

  5. Klicken Sie auf App registrieren .

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

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

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

Wenn Ihr Projekt mehrere Bundle-IDs enthält, müssen Sie jede Bundle-ID einer registrierten App in der Firebase-Konsole zuordnen, damit jede App über eine eigene GoogleService-Info.plist Datei verfügen kann.

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

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

  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 Platforms SDK-Repository hinzu:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Wählen Sie die SDK-Version aus, die Sie verwenden möchten.

  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ür Analytics ohne IDFA-Erfassungsfunktion fügen Sie stattdessen FirebaseAnalyticsWithoutAdId hinzu.

Wenn Sie fertig sind, beginnt Xcode automatisch mit der Auflösung und dem 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 getan, als Sie Firebase zu Ihrer App hinzugefügt haben. 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. Um beispielsweise Cloud Firestore und Authentifizierung zu verwenden:

    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 gemeinsam genutzte FirebaseApp Instanz in der application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegierten:

    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 anhängen. Sie müssen auch das Swizzling von App-Delegierten 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, lesen Sie die Fehlerbehebung und häufig gestellten Fragen zu Apple-Plattformen .

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 Firebase-Apple-Plattformbibliotheken:

Dienstleistung oder Produkt Schoten 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 Functions für 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-Nachrichten pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(erforderlich)
Firebase-Installationen pod 'FirebaseInstallations' FirebaseInstallations
Benutzerdefinierte Firebase ML-Modell-APIs pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Leistungsüberwachung pod 'FirebasePerformance' FirebasePerformance
Echtzeitdatenbank pod 'FirebaseDatabase' FirebaseDatabase
Remote-Konfiguration pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integrieren Sie, ohne den Swift Package Manager zu verwenden

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

Kakaoschoten

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

Rahmenwerke

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

  1. Laden Sie die Framework-SDK-Zip-Datei herunter. Dies ist eine ca. 200 MB große Datei, deren Download möglicherweise einige Zeit in Anspruch nimmt.

  2. Entpacken Sie die Datei und integrieren Sie dann die Frameworks, die Sie in Ihre App einbinden möchten.

    Anweisungen zur Integration finden Sie an einer der folgenden Stellen:

    Informationen zu Framework-Versionen oder Abhängigkeiten finden Sie in der Datei METADATA.md in der heruntergeladenen ZIP-Distribution.

  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:

Fügen Sie Ihrer App Firebase-Dienste hinzu: