Weitere Installationsoptionen für Unity

Anstatt eine große .zip-Datei herunterzuladen, die alle .unitypackage-Dateien für .NET 3.X und .NET 4.X enthält, können Sie einzelne Pakete von der Google APIs for Unity-Website 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 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 zusammen mit den zugehörigen .tgz-Dateien aufgeführt sind, von denen sie abhängen.

Auf dieser Seite finden Sie eine Anleitung zum Unity Package Manager. Es empfiehlt sich, die Unity-Dokumentation zu diesem Tool zu lesen.

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 herunterladen und auf dieselbe Version aktualisieren.

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

So importieren Sie die Datei nach dem Herunterladen:

  1. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) 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 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 herunterladen und auf dieselbe Version aktualisieren.

  • Verwenden Sie in einem Projekt nicht mehrere Importmethoden. Das bedeutet, dass Sie Firebase-Produkte nicht sowohl mit dem Asset-Paket- als auch mit dem Unity Package Manager-Ablauf importieren sollten.

  • Abhängigkeiten für jede .tgz-Datei des Produkts sind daneben 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. In Ihrem Projekt verwendete Firebase-Produkte. Wenn Sie Realtime Database oder Cloud Storage verwenden, importieren Sie zuerst Authentication (com.google.firebase.auth).

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

Paketmanager-Benutzeroberfläche

  1. Öffnen Sie das Fenster „Package Manager“ (Paketmanager) in Unity.
  2. Klicken Sie oben links 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 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 oben links 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 und nennen Sie ihn GooglePackages.
  2. Legen Sie die .tgz-Dateien in diesem Ordner ab.
  3. Öffnen Sie Packages/manifest.json im Unity-Projektordner mit 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. Hängen Sie file: an den Dateipfad .tgz an. Wenn Sie beispielsweise com.google.firebase.storage und die zugehörigen 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 den Fokus erhält, wird manifest.json neu geladen und die neu hinzugefügten Pakete werden importiert.

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

  1. Entpacken Sie die Datei .tgz:

  2. Bearbeiten Sie Ihre 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...
  }
}

Vom Unity Package Manager zu Asset-Paketen migrieren

In einigen Fällen möchten Sie möglicherweise vom 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 in Ihrem Unity-Projektordner die Datei Packages/manifest.json. Wenn die Datei Einträge enthält, die mit com.google.firebase beginnen, wurde für den Import in Ihr Projekt der Unity Package Manager 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 darauf, dass im Fenster Package Manager die Option „Packages: In Project“ ausgewählt ist.
    2. Notieren Sie sich die Versionen der importierten Firebase-Pakete.
    3. Klicken Sie auf die einzelnen Paketnamen und dann auf Entfernen. Entfernen Sie das Paket „External Dependency Manager“ (.com.google.external-dependency-manager) sowie die 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 jedes Pakets durchführen können, laden Sie die ZIP-Datei des Firebase Unity SDK herunter und importieren Sie sie wie unter Firebase zu einem 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 im Ordner Assets zum Importieren und Verfolgen von Produkten mit dem Unity Package Manager wechseln.

Wenn Sie sich 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 in Ihrem Projekt bereits der Unity Package Manager 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 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 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.