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 für Google APIs for Unity herunterladen.

Die Website bietet Folgendes:

  • Einzelne .NET 4.X-.unitypackage-Dateien, die als Asset-Pakete importiert werden können.
  • Einzelne .tgz-Archive, die mit dem Unity-Paketmanager 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 werden, von denen sie abhängen.

Diese Seite enthält eine Anleitung zum Unity-Paketmanager. Daher ist es sinnvoll, sich in der Unity-Dokumentation mit dem Tool vertraut zu machen.

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 die gleiche Version 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.

Gehen Sie nach dem Download folgendermaßen vor:

  1. Gehen Sie in Ihrem geöffneten Unity-Projekt zu Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket).

  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 nicht mehrere Importmethoden in einem Projekt. 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 Paket-Manager-Fenster von Unity.
  2. Klicken Sie im Fenster „Package Manager“ (Paketmanager) oben links 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 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 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 Unity wieder fokussiert ist, wird 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 Überwachen 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 den Import Ihres Projekts der Unity Package Manager 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. .unitypackage-Ersatzdateien herunterladen und importieren. Es stehen zwei Optionen zur Verfügung:

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 dem Unity-Paketmanager 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, wird in Ihrem Projekt bereits der Unity-Paketmanager für den Import verwendet.

So migrieren Sie zum Unity-Paketmanager:

  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-Paketmanager, wie oben auf dieser Seite beschrieben.