Firebase 将于 5 月 10 日重返 Google I/O 大会!立即报名

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.

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.

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.

  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-Nickname 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 die Konfigurationsdatei für Ihre Firebase-Apple-Plattformen ( GoogleService-Info.plist ) abzurufen.

  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.

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

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:

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:

Fügen Sie Ihrer App Firebase-Dienste 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.

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.

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.

  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-Nickname 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 die Konfigurationsdatei für Ihre Firebase-Apple-Plattformen ( GoogleService-Info.plist ) abzurufen.

  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.

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

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:

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:

Fügen Sie Ihrer App Firebase-Dienste hinzu: