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 Website „Google APIs for Unity“ herunterladen.

Die Website bietet Folgendes:

  • 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 werden, von denen sie abhängen.

Auf dieser Seite finden Sie eine Anleitung für den Unity Package Manager. Es empfiehlt sich, sich in der Unity-Dokumentation über das Tool zu informieren.

Firebase-Pakete als Assets importieren

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

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

  • Verwenden Sie in einem Projekt nicht verschiedene Importmethoden. Importieren Sie Firebase-Produkte also nicht über den Asset-Paket-Workflow und den 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 dem Unity Package Manager importieren

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

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

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

  • Verwenden Sie in einem Projekt nicht verschiedene Importmethoden. Importieren Sie Firebase-Produkte also nicht über den Asset-Paket-Workflow und den Unity Package Manager-Workflow.

  • Die Abhängigkeiten für jede Produkt-.tgz-Datei sind in eigenen .tgz-Dateien verknüpft. Sie müssen die Produktdatei .tgz und die Abhängigkeitsdatei .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. In Ihrem Projekt verwendete Firebase-Produkte. 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:

Paketmanager-Benutzeroberfläche

  1. Öffnen Sie das Fenster „Package Manager“ (Paketmanager) von Unity.
  2. Klicken Sie links oben im Fenster „Package Manager“ (Paketmanager) auf das Symbol + und wählen Sie Add package from tarball 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 Folgendes tun:

  1. Entpacken Sie die Datei .tgz:
  2. Klicken Sie links oben im Fenster „Paketmanager“ auf das Symbol + und wählen Sie Add package from disk 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 mit dem Namen GooglePackages.
  2. Legen Sie die .tgz-Dateien in diesen Ordner ab.
  3. Öffnen Sie Packages/manifest.json im Unity-Projektordner in einem Texteditor.

  4. Fügen Sie für jedes Paket, das Sie importieren möchten, einen Eintrag hinzu und ordnen Sie den Paketnamen dem Speicherort auf dem Laufwerk zu. Fügen Sie dem Dateipfad .tgz das Zeichen file: an. Wenn Sie beispielsweise com.google.firebase.storage und seine Abhängigkeiten importieren, würde manifest.json so aussehen:

    {
  "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 der Fokus wieder auf Unity liegt, wird die manifest.json neu geladen und die neu hinzugefügten Pakete 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 anstelle der Datei .tgz der Pfad zum extrahierten Ordner 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...
  }
}

Vom Unity Package Manager zu Asset-Paketen migrieren

In einigen Fällen möchten Sie möglicherweise von der Verwendung des Unity Package Managers zum Erfassen von Firebase-Produkten zum Importieren von Produkten in den 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 mit com.google.firebase beginnt, wurde für Ihr Projekt der Unity Package Manager für den Import verwendet.

So migrierst du 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 den Namen jedes Pakets und dann auf Entfernen. Entfernen Sie das Paket „External Dependency Manager“ (.com.google.external-dependency-manager) sowie die Firebase-Pakete.

  2. Laden Sie Ersatz.unitypackage-Dateien herunter und importieren Sie sie. Es stehen zwei Optionen zur Verfügung:

    • Wenn Sie auf die neueste Version jedes Pakets upgraden können, laden Sie die Zip-Datei des Firebase Unity SDK herunter und importieren Sie sie wie unter Firebase Ihrem Unity-Projekt hinzufügen beschrieben.
    • Wenn Sie die aktuellen .unitypackage-Versionen beibehalten möchten, können Sie einzelne Pakete herunterladen und importieren, wie oben auf dieser Seite beschrieben.

Von Asset-Paketen zum Unity Package Manager migrieren

In einigen Fällen möchten Sie möglicherweise vom Importieren von Produkten unter dem Ordner Assets zum Importieren und Überwachen von Produkten mit dem 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 mit com.google.firebase beginnt, verwendet Ihr Projekt bereits den Unity Package Manager für den Import.

So migrieren Sie zum Unity Package Manager:

  1. Entfernen Sie alle Firebase-Pakete und das Paket „External Dependency Manager“ aus dem Ordner Assets. 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 (Assets > Externer Abhängigkeitsmanager > Versions-Handler > Verwaltete Pakete deinstallieren) auf.
    2. Wählen Sie alle Firebase-Pakete und den externen Abhängigkeitsmanager aus.
    3. Klicken Sie auf Ausgewähltes Paket deinstallieren.

    Manuelle Entfernung

    Löschen Sie die folgenden Ordner manuell mithilfe von 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.