Firebase zu Ihrem Apple-Projekt hinzufügen

Vorbereitung

  • Installieren Sie Folgendes:

    • Xcode 15.2 oder höher

  • Ihr Projekt muss die folgenden Anforderungen erfüllen:

    • Ihr Projekt muss auf folgende Plattformversionen oder höher ausgerichtet sein:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • 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 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.

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. Das Registrieren der Anwendung wird oft als "Hinzufügen" der Anwendung zum Projekt bezeichnet.

  1. Rufen Sie die Firebase-Konsole auf.

  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 aufzurufen.

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

  4. Optional: Geben Sie weitere App-Informationen ein: App-Alias und App Store-ID.

  5. Klicken Sie auf App registrieren.

Schritt 3: Firebase-Konfigurationsdatei hinzufügen

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

  2. Verschieben Sie Ihre 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: Der App Firebase SDKs hinzufügen

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

  1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
  2. Fügen Sie bei entsprechender Aufforderung 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, fügen Sie FirebaseAnalytics hinzu. Bei Analytics ohne Funktion für die IDFA-Erfassung fügen Sie stattdessen FirebaseAnalyticsWithoutAdId hinzu.

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.

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

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Konfigurieren Sie in der Methode application(_:didFinishLaunchingWithOptions:) des Anwendungsdelegats eine freigegebene Instanz FirebaseApp:

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegierten erstellen und ihn über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das App-Delegate-Swizzling deaktivieren. Weitere Informationen findest du in der SwiftUI-Anleitung.

    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 der Firebase-Konsole zu bestätigen, dass Sie Firebase erfolgreich installiert haben.

Geschafft! Du kannst dann 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 Apple-Plattformbibliotheken:

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.

  1. 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.

  2. 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:

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

  3. Fügen Sie das -ObjC-Linker-Flag in der Datei Other Linker Settings in den Build-Einstellungen des Ziels hinzu.

Nächste Schritte

Weitere Informationen zu Firebase:

Fügen Sie Ihrer App Firebase-Dienste hinzu: