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 daher, 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 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.

  • Kombinieren Sie keine Importmethoden in einem Projekt. 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.

  • Kombinieren Sie keine Importmethoden in einem Projekt. Importieren Sie Firebase-Produkte also nicht sowohl über den Asset-Paket- als auch über den Unity Package Manager-Ablauf.

  • Abhängigkeiten für jede .tgz-Produktdatei 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 die 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 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 Verfolgen 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 External Dependency Manager-Paket (.com.google.external-dependency-manager) sowie die Firebase-Pakete.

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

    • Wenn Sie ein Upgrade auf die aktuelle 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 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 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, 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 External Dependency Manager-Paket mit einer der folgenden Methoden aus dem Ordner Assets.

    EDM4U-Benutzeroberfläche

    1. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages (Assets > External Dependency Manager > Versions-Handler > Verwaltete Pakete deinstallieren) 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.