Firebase zu Ihrem Apple-Projekt hinzufügen

Vorbereitung

  • Installieren Sie Folgendes:

    • Xcode 26.2 oder höher

  • Ihr Projekt muss die folgenden Anforderungen erfüllen:

    • Ihr Projekt muss auf die folgenden Plattformversionen oder höher ausgerichtet sein:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

  • 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 Beispiele für den Schnelleinstieg herunterladen.

Schritt 1: Firebase-Projekt erstellen

Bevor Sie Firebase zu Ihrer Apple-App hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, das mit Ihrer App verbunden wird. 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 die App in Ihrem Firebase-Projekt registrieren. Die Registrierung Ihrer App wird oft als „Hinzufügen“ Ihrer App zu Ihrem Projekt bezeichnet.

  1. Rufen Sie die Firebase-Konsole auf.

  2. Klicken Sie in der Mitte der Projektübersicht 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 Paket-ID Ihrer App in das Feld Paket-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 Firebase-Konfigurationsdatei (GoogleService-Info.plist) Ihrer App abzurufen.

  2. Verschieben Sie die 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 mehrere Paket-IDs in Ihrem Projekt haben, müssen Sie jede Paket-ID mit einer registrierten App in der Firebase-Konsole verknüpfen, damit jede App eine eigene GoogleService-Info.plist-Datei haben kann.

Schritt 4: Firebase SDKs zu Ihrer App 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, müssen Sie FirebaseAnalytics hinzufügen. Diese bietet alle Analysefunktionen. Sie können auch einzelne Funktionen auswählen. Weitere Informationen finden Sie in den FAQs zur aktuellen Organisation von Modulen im Google Analytics for Firebase SDK.

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 Initialisierungscode hinzu. Möglicherweise haben Sie dies bereits getan, als Sie Firebase zu Ihrer App hinzugefügt haben. Wenn Sie ein Schnellstart-Beispielprojekt 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. Beispiel für die Verwendung von 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 application(_:didFinishLaunchingWithOptions:)-Methode des App-Delegats eine freigegebene FirebaseApp-Instanz:

    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 ein App-Delegat erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling des App-Delegaten deaktivieren. Weitere Informationen finden Sie 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 eine Bestätigung an die Firebase-Konsole zu senden, dass Sie Firebase erfolgreich installiert haben.

Geschafft! Sie können mit den nächsten Schritten fortfahren.

Wenn Sie Probleme bei der Einrichtung haben, finden Sie weitere Informationen unter Fehlerbehebung und häufig gestellte Fragen 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 Name der Bibliothek / des Frameworks Analytics hinzufügen?
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (erforderlich)
Firebase Installationen FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
VERWORFENE ODER NICHT UNTERSTÜTZTE BIBLIOTHEKEN
Dynamic Links FirebaseDynamicLinks
Firebase ML Custom Model APIs FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) hieß früher „Vertex AI in Firebase“ und wurde unter dem Modul FirebaseVertexAI verteilt. Firebase AI Logic wurde früher auch unter dem Modul FirebaseAI bereitgestellt.

2 Firebase SQL Connect hieß früher „Firebase Data Connect“.

Ohne Swift Package Manager einbinden

Wenn Sie Swift Package Manager nicht verwenden möchten, können Sie Firebase trotzdem einbinden, indem Sie die vorkompilierten Frameworks direkt importieren.

Frameworks

Die ZIP-Datei unterstützt jetzt nicht nur die iOS-Plattform, sondern enthält auch .xcframework-Dateien. Weitere Informationen finden Sie in der README-Datei zum Firebase SDK für Apple-Plattformen auf GitHub.

  1. Laden Sie die Framework-SDK-ZIP-Datei herunter. Diese Datei ist etwa 200 MB groß und der Download kann einige Zeit dauern.

  2. Entpacken Sie die Datei und binden Sie die Frameworks ein, die Sie in Ihre App aufnehmen möchten.

    Anleitungen zur Integration finden Sie an 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 Other Linker Flags in den Build-Einstellungen Ihres Ziels hinzu.

Nächste Schritte

Weitere Informationen zu Firebase:

Firebase-Dienste zu Ihrer App hinzufügen: