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.

Auf der Website finden Sie Folgendes:

  • Einzelne .unitypackage-Dateien für .NET 4.X, die als Asset-Pakete importiert werden können.
  • Einzelne .tgz-Archive, die mit dem Unity Package Manager importiert werden können.

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 eine Anleitung zur Verwendung des Unity Package Manager. Informationen zum Tool finden Sie in der Unity-Dokumentation.

Firebase-Pakete als Assets importieren

Beachten Sie beim Importieren von Firebase-Produkten aus .unitypackage Dateien, die von der Google APIs for Unity-Website heruntergeladen wurden, Folgendes:

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

  • Verwenden Sie nicht mehrere 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 Dateien nach dem Download:

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

  2. Klicken Sie im Fenster Import Unity Package auf Import.

Firebase-Pakete mit dem 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.

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

  • Abhängigkeiten für jede .tgz-Datei des Produkts sind in eigenen .tgz-Dateien verknüpft. Sie müssen die .tgz-Datei des Produkts und die .tgz-Dateien der Abhängigkeiten 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).

Importieren Sie die .tgz-Dateien nach dem Download mit einer der folgenden Methoden in Ihr Projekt:

Benutzeroberfläche des Paketmanagers

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

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

  1. Entpacken Sie die .tgz-Datei.
  2. Klicken Sie oben links im Fenster „Package Manager“ (Paketmanager) auf das Symbol + und wählen Sie Add package from disk (Paket von Festplatte hinzufügen) aus, um den Dateibrowser zu öffnen.
  3. Wählen Sie im Dateibrowser den extrahierten Ordner aus.

manifest.json

  1. Erstellen Sie neben dem Ordner Packages Ihres Projekts einen neuen Ordner und nennen Sie ihn GooglePackages.
  2. Platzieren Sie die .tgz-Dateien in diesem Ordner.
  3. Öffnen Sie in einem Texteditor die Datei Packages/manifest.json in Ihrem Unity-Projektordner.

  4. Fügen Sie für jedes Paket, das Sie importieren möchten, einen Eintrag hinzu, in dem Sie den Paketnamen dem Speicherort auf der Festplatte zuordnen. Hängen Sie unbedingt file: an den Pfad der .tgz-Datei an. Wenn Sie beispielsweise com.google.firebase.storage und die zugehörigen Abhängigkeiten importieren, sieht Ihre manifest.json-Datei 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 den Fokus erhält, wird die Datei manifest.json neu geladen und die neu hinzugefügten Pakete werden importiert.

Einige ältere Versionen von Unity unterstützen keine .tgz-Dateien in der Datei manifest.json. In diesem Fall sollten Sie so vorgehen:

  1. Entpacken Sie die .tgz-Datei.

  2. Bearbeiten Sie die Datei manifest.json so, dass der Pfad zum extrahierten Ordner anstelle der .tgz-Datei 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 Verfolgen von Firebase-Produkten zum Importieren von Produkten in den Ordner Assets wechseln.

Wenn Sie nicht sicher sind, welche Importmethode Sie verwenden, öffnen Sie in Ihrem Unity-Projektordner die Datei Packages/manifest.json. Wenn die Datei Einträge enthält, die mit com.google.firebase beginnen, wurde 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ü Window (Fenster) die Option Package Manager (Paketmanager) aus. Achten Sie im Fenster Package Manager (Paketmanager) darauf, dass „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 Remove (Entfernen). Entfernen Sie unbedingt das Paket „External Dependency Manager“ (.com.google.external-dependency-manager) sowie die Firebase-Pakete.

  2. Laden Sie die Ersatzdateien .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üssen, können Sie einzelne Pakete herunterladen und importieren, wie oben auf dieser Seite beschrieben.

Von Asset-Paketen zu Unity Package Manager migrieren

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

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

So migrieren Sie zum Unity Package Manager:

  1. Achten Sie darauf, dass alle Firebase-Pakete und das Paket „External Dependency Manager“ aus dem Ordner Assets entfernt wurden. 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 „External Dependency Manager“ aus.
    3. Klicken Sie auf Uninstall Selected Package (Ausgewähltes Paket deinstallieren).

    Manuelles Entfernen

    Löschen Sie mit den Tools des Dateisystems manuell die folgenden Ordner:

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