Firebase zu Ihrem Unity-Projekt hinzufügen

Mit unseren Firebase Unity SDKs können Sie Ihre Unity-Spiele optimieren.

Um zu zeigen, wie einfach es ist, Firebase in Ihr Unity-Projekt einzubinden, haben wir ein Beispielspiel namens MechaHamster erstellt. Wenn Sie Firebase einem Spiel hinzufügen möchten, verwenden Sie die Starter-Version auf GitHub. Wenn Sie eine fertige Version möchten, sehen Sie sich die Versionen im App Store oder im Google Play Store an.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Weitere Informationen dazu, wie Sie Ihre Spiele mit Firebase optimieren können, finden Sie auf der Firebase-Seite für Spiele.

Haben Sie Firebase bereits zu Ihrem Unity-Projekt hinzugefügt? Achten Sie darauf, dass Sie die aktuelle Version des Firebase Unity SDK verwenden.

Vorbereitung

  • Installieren Sie Unity 2021 LTS oder höher. Frühere Versionen sind möglicherweise ebenfalls kompatibel, werden aber nicht aktiv unterstützt.

  • (Nur Apple-Plattformen) Installieren Sie Folgendes:

    • Xcode 26.2 oder höher
    • CocoaPods 1.12.0 oder höher

  • Ihr Unity-Projekt muss die folgenden Anforderungen erfüllen:

    • Für iOS: iOS 15 oder höher
    • Für tvOS: auf tvOS 15 oder höher ausgerichtet
    • Für Android: Ziel-API-Level 24 (Nougat) oder höher

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

    • Für Apple-Plattformen: Richten Sie ein physisches Gerät ein oder verwenden Sie einen iOS- oder tvOS-Simulator.

    • Für Android: Emulatoren müssen ein Emulator-Image mit Google Play verwenden.

Wenn Sie noch kein Unity-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 Ihrem Unity-Projekt hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, das mit Ihrem Unity-Projekt verbunden wird. Weitere Informationen zu Firebase-Projekten finden Sie unter Firebase-Projekte.

Schritt 2: App bei Firebase registrieren

Sie können eine oder mehrere Apps oder Spiele registrieren, um sie mit Ihrem Firebase-Projekt zu verbinden.

  1. Rufen Sie die Firebase-Konsole auf.

  2. Klicken Sie in der Mitte der Projektübersicht auf das Unity-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. Wählen Sie aus, welches Build-Ziel Ihres Unity-Projekts Sie registrieren möchten. Sie können auch beide Ziele gleichzeitig registrieren.

  4. Geben Sie die plattformspezifischen IDs Ihres Unity-Projekts ein.

    • Für iOS: Geben Sie die iOS-ID Ihres Unity-Projekts in das Feld iOS-Paket-ID ein.

    • Für Android: Geben Sie die Android-ID Ihres Unity-Projekts in das Feld Android-Paketname ein.
      Die Begriffe Paketname und Anwendungs-ID werden häufig synonym verwendet.

  5. (Optional) Geben Sie die plattformspezifischen Aliasnamen Ihres Unity-Projekts ein.
    Diese Aliasse sind interne, praktische Kennungen und nur für Sie in der Firebase-Konsole sichtbar.

  6. Klicken Sie auf App registrieren.

Schritt 3: Firebase-Konfigurationsdateien hinzufügen

  1. Rufen Sie die plattformspezifischen Firebase-Konfigurationsdateien im Einrichtungs-Workflow der Firebase-Konsole ab.

    • Für iOS: Klicken Sie auf GoogleService-Info.plist herunterladen.

    • Für Android: Klicken Sie auf google-services.json herunterladen.

  2. Öffnen Sie das Fenster Projekt Ihres Unity-Projekts und verschieben Sie die Konfigurationsdatei(en) in den Ordner Assets.

  3. Klicken Sie in der Firebase-Konsole im Einrichtungs-Workflow auf Weiter.

Schritt 4: Firebase Unity SDKs hinzufügen

  1. Klicken Sie in der Firebase-Konsole auf Firebase Unity SDK herunterladen und entpacken Sie das SDK an einem geeigneten Ort.

    • Sie können das Firebase Unity SDK jederzeit wieder herunterladen.

    • Das Firebase Unity SDK ist nicht plattformspezifisch.

  2. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) auf.

  3. Wählen Sie im entpackten SDK die unterstützten Firebase-Produkte aus, die Sie in Ihrer App verwenden möchten.

    Analytics aktiviert

    • Fügen Sie das Firebase-Paket für Google Analytics hinzu: FirebaseAnalytics.unitypackage
    • Fügen Sie die Pakete für alle anderen Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Beispiel für die Verwendung von Firebase Authentication und Firebase Realtime Database:
      FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

    Analytics nicht aktiviert

    Fügen Sie die Pakete für die Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Wenn Sie beispielsweise Firebase Authentication und Firebase Realtime Database verwenden möchten:
    FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

  4. Klicken Sie im Fenster Import Unity Package (Unity-Paket importieren) auf Import (Importieren).

  5. Klicken Sie in der Firebase-Konsole im Einrichtungs-Workflow auf Weiter.

Schritt 5: Versionsanforderungen für Google Play-Dienste prüfen

Für einige Produkte im Firebase Unity SDK for Android ist Google Play services erforderlich. Hier erfahren Sie, für welche Produkte diese Abhängigkeit gilt. Google Play services muss auf dem neuesten Stand sein, damit diese Produkte verwendet werden können.

Fügen Sie am Anfang Ihrer Anwendung die folgende using-Anweisung und den Initialisierungscode hinzu. Sie können Google Play services prüfen und optional auf die erforderliche Version aktualisieren, bevor Sie andere Methoden im SDK aufrufen.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Fertig! Ihr Unity-Projekt ist registriert und für die Verwendung von Firebase konfiguriert.

Wenn du Probleme bei der Einrichtung hast, findest du weitere Informationen unter Unity – Fehlerbehebung und häufig gestellte Fragen.

Desktop-Workflow einrichten (Beta)

Wenn du ein Spiel erstellst, ist es oft viel einfacher, es zuerst im Unity-Editor und auf Desktop-Plattformen zu testen und dann später in der Entwicklung auf Mobilgeräten bereitzustellen und zu testen. Zur Unterstützung dieses Workflows bieten wir eine Teilmenge der Firebase Unity SDKs an, die unter Windows, macOS, Linux und im Unity-Editor ausgeführt werden können.

  1. Richten Sie ein Unity-Projekt für eine Desktop-Plattform ein. Folgen Sie dazu der Anleitung für eine mobile Plattform (beginnen Sie mit dem Schritt App bei Firebase registrieren oben).

  2. Führen Sie Ihr Unity-Projekt in der Unity-IDE aus oder wählen Sie die Option zum Erstellen Ihres Unity-Projekts für Desktop aus.

  3. (Optional) Führen Sie Ihr Unity-Projekt im Bearbeitungsmodus aus.

    Das Firebase Unity SDK kann auch im Bearbeitungsmodus von Unity ausgeführt werden, sodass es in Editor-Plug-ins verwendet werden kann.

    1. Wenn Sie eine FirebaseApp erstellen, die vom Editor verwendet wird, verwenden Sie nicht die Standardinstanz.

    2. Geben Sie stattdessen einen eindeutigen Namen für den FirebaseApp.Create()-Aufruf an.

      Dies ist wichtig, um einen Konflikt zwischen den Optionen der von der Unity-IDE verwendeten Instanz und der von Ihrem Unity-Projekt verwendeten Instanz zu vermeiden.

Unterstützte Firebase-Produkte

Weitere Informationen zu den Unity Firebase-Bibliotheken finden Sie in der Referenzdokumentation.

Verfügbare Firebase-Bibliotheken für Mobilgeräte

Das Firebase Unity SDK unterstützt die folgenden Firebase-Produkte auf Apple und Android:

Firebase-Produkt Unity-Paket
AdMob Wird separat im AdMob Unity-Plug-in verteilt
Firebase AI Logic FirebaseAI.unitypackage
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage
VERWORFENE ODER NICHT UNTERSTÜTZTE BIBLIOTHEKEN
Dynamic Links FirebaseDynamicLinks.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage

Verfügbare Firebase-Bibliotheken für Desktop-Computer

Das Firebase-Unity-SDK bietet Unterstützung für Desktop-Workflows für eine Teilmenge von Produkten, sodass bestimmte Teile von Firebase im Unity-Editor und in eigenständigen Desktop-Builds unter Windows, macOS und Linux verwendet werden können.

Firebase-Produkt (Desktop) Unity-Paket
Firebase AI Logic FirebaseAI.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

Die restlichen Desktop-Bibliotheken werden von Firebase als Stub-Implementierungen (nicht funktionsfähig) bereitgestellt, um die Entwicklung für Windows, macOS und Linux zu vereinfachen. Daher müssen Sie keinen Code bedingt kompilieren, um die Desktop-Version zu unterstützen.

Nächste Schritte