Weitere Installationsoptionen für Unity

Anstatt eine große .zip-Datei mit allen .unitypackage-Dateien für .NET 3.X und .NET 4.X herunterzuladen, können Sie einzelne Pakete von der Google APIs for Unity-Website herunterladen.

Die Website bietet:

  • Einzelne .NET 4.X-.unitypackage-Dateien, die als Asset-Pakete importiert werden sollen.
  • Einzelne .tgz-Archive, die mit dem Unity Package Manager importiert werden sollen.

Das ist besonders nützlich, wenn Ihre App ein einzelnes Firebase-Produkt verwendet, da die einzelnen .unitypackage-Dateien alle erforderlichen Abhängigkeiten enthalten und die .tgz-Dateien neben den zugehörigen .tgz-Dateien aufgeführt sind, von denen sie abhängen.

Auf dieser Seite finden Sie Anleitungen zum Unity Package Manager. Es empfiehlt sich daher, sich in der Unity-Dokumentation über das Tool zu informieren.

Firebase-Pakete als Assets importieren

Wenn Sie Firebase-Produkte aus .unitypackage-Dateien importieren, die von der Google APIs for Unity-Website heruntergeladen wurden, beachten Sie Folgendes:

  • Wenn Sie mehrere Firebase-Produkte in Ihrem Projekt verwenden, müssen Sie alle Firebase-Produkte in derselben Version herunterladen und aktualisieren.

  • Mischen Sie nicht verschiedene Importmethoden in einem Projekt. Importieren Sie Firebase-Produkte also nicht mit dem Asset-Paket-Workflow und dem Unity Package Manager-Workflow.

So importieren Sie die Datei nach dem Herunterladen:

  1. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package auf.

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

Firebase-Pakete mit Unity Package Manager importieren

Beachten Sie beim Importieren von Firebase-Produkten aus .tgz-Dateien, die aus dem Google APIs for Unity-Archiv heruntergeladen wurden, Folgendes:

  • Diese Methode ist nur in Version 2018.3 und höher verfügbar.

  • Wenn Sie mehrere Firebase-Produkte in Ihrem Projekt verwenden, müssen Sie alle Firebase-Produkte in derselben Version herunterladen und aktualisieren.

  • Mischen Sie nicht verschiedene Importmethoden in einem Projekt. Importieren Sie Firebase-Produkte also nicht mit dem Asset-Paket-Ablauf und dem Unity-Paketmanager-Ablauf.

  • Abhängigkeiten für jede .tgz-Datei sind in eigenen .tgz-Dateien verknüpft. Sie müssen die Produktdatei .tgz und die Abhängigkeitsdateien .tgz in der richtigen Reihenfolge herunterladen und importieren:

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Firebase-Produkte, die in Ihrem Projekt verwendet werden. Wenn Sie Realtime Database oder Cloud Storage verwenden, importieren Sie zuerst Authentication (com.google.firebase.auth).

Nach dem Herunterladen können Sie .tgz-Dateien mit einer der folgenden Methoden in Ihr Projekt importieren:

Benutzeroberfläche des Paketmanagers

  1. Öffnen Sie das Fenster „Package Manager“ (Paketmanager) in Unity.
  2. Klicken Sie links oben im Fenster „Package Manager“ auf das Symbol + und wählen Sie Add package from tarball aus, um den Dateibrowser zu öffnen.
  3. Wählen Sie im Dateibrowser das gewünschte Tarball aus.

Einige ältere Versionen von Unity 2019 unterstützen das direkte Hinzufügen von Tarballs nicht. In diesem Fall müssen Sie Folgendes tun:

  1. Entpacken Sie die Datei .tgz:
  2. Klicken Sie links oben im Fenster „Package Manager“ auf das Symbol + und wählen Sie Add package from disk aus, um den Dateibrowser zu öffnen.
  3. Wählen Sie den extrahierten Ordner im Dateibrowser aus.

manifest.json

  1. Erstellen Sie neben dem Ordner Packages Ihres Projekts einen neuen Ordner mit dem Namen GooglePackages.
  2. Legen Sie die .tgz-Dateien in diesem Ordner ab.
  3. Öffnen Sie Packages/manifest.json in einem Texteditor in Ihrem Unity-Projektordner.

  4. Fügen Sie für jedes Paket, das Sie importieren möchten, einen Eintrag hinzu und ordnen Sie den Paketnamen dem Speicherort auf der Festplatte zu. Hängen Sie file: an den Dateipfad .tgz an. Wenn Sie beispielsweise com.google.firebase.storage und seine Abhängigkeiten importieren, sieht Ihre manifest.json so aus:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
    // com.unity package entries...
  }
}

  5. Speichern Sie die Datei manifest.json.

  6. Wenn Unity wieder im Fokus ist, wird manifest.json neu geladen und die neu hinzugefügten Pakete werden importiert.

Einige ältere Versionen von Unity unterstützen keine .tgz-Dateien im manifest.json. In diesem Fall sollten Sie Folgendes tun:

  1. Entpacken Sie die Datei .tgz:

  2. Bearbeiten Sie die Datei manifest.json so, dass der Pfad zum extrahierten Ordner anstelle der Datei .tgz verwendet wird:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
    // com.unity package entries...
  }
}

Von Unity Package Manager zu Asset-Paketen migrieren

In einigen Fällen möchten Sie möglicherweise von der Verwendung des Unity Package Manager zum Tracking von Firebase-Produkten zum Importieren von Produkten im Ordner Assets wechseln.

Wenn Sie sich nicht sicher sind, welche Importmethode Sie verwenden, öffnen Sie im Ordner Ihres Unity-Projekts die Datei Packages/manifest.json. Wenn die Datei Einträge enthält, die mit com.google.firebase beginnen, wurde in Ihrem Projekt der Unity Package Manager für den Import verwendet.

So migrieren Sie zu Asset-Paketen:

  1. Notieren Sie sich die aktuellen Firebase-Paketversionen in Ihrem Projekt und entfernen Sie sie.

    1. Wählen Sie im Menü Fenster die Option Paketmanager aus. Achten Sie darauf, dass im Fenster Package Manager (Paketmanager) die Option „Packages: In Project“ (Pakete: Im Projekt) ausgewählt ist.
    2. Notieren Sie sich die Versionen der importierten Firebase-Pakete.
    3. Klicken Sie auf jeden Paketnamen und dann auf Entfernen. Entfernen Sie unbedingt das External Dependency Manager-Paket (.com.google.external-dependency-manager) sowie Firebase-Pakete.

  2. Laden Sie die Ersatzdateien für .unitypackage herunter und importieren Sie sie. Es stehen zwei Optionen zur Verfügung:

    • Wenn Sie ein Upgrade auf die neueste Version der einzelnen Pakete durchführen können, laden Sie die ZIP-Datei des Firebase Unity SDK herunter und importieren Sie sie wie unter Firebase zu Ihrem Unity-Projekt hinzufügen beschrieben.
    • Wenn Sie die aktuellen .unitypackage-Versionen beibehalten möchten, können Sie einzelne Pakete wie oben auf dieser Seite beschrieben herunterladen und importieren.

Von Asset-Paketen zum Unity Package Manager migrieren

In einigen Fällen möchten Sie möglicherweise vom Importieren von Produkten im Ordner Assets zum Importieren und Tracking von Produkten mit Unity Package Manager wechseln.

Wenn Sie sich nicht sicher sind, welche Importmethode Sie verwenden, öffnen Sie im Ordner Ihres Unity-Projekts die Datei Packages/manifest.json. Wenn die Datei Einträge enthält, die mit com.google.firebase beginnen, verwendet Ihr Projekt bereits den Unity Package Manager für den Import.

So migrieren Sie zum Unity Package Manager:

  1. Achten Sie darauf, dass alle Firebase-Pakete und das External Dependency Manager-Paket aus dem Ordner Assets entfernt werden. Verwenden Sie dazu eine der folgenden Methoden.

    EDM4U-Benutzeroberfläche

    1. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages auf.
    2. Wählen Sie alle Firebase-Pakete und den External Dependency Manager aus.
    3. Klicken Sie auf Uninstall Selected Package (Ausgewähltes Paket deinstallieren).

    Manuelles Entfernen

    Löschen Sie die folgenden Ordner manuell mit Dateisystemtools:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Importieren Sie Pakete mit dem Unity Package Manager, wie oben auf dieser Seite beschrieben.