Google-Pakete für Unity installieren

Google-Pakete für Unity werden in zwei verschiedenen Formaten verteilt:

• Asset-Pakete:
  • Verwenden Sie eine .unitypackage-Erweiterung.
  • Installieren Sie das Projekt im Verzeichnis Assets Ihres Projekts.
  • Kann in Unity 5 und höher importiert werden.
  • Schließen Sie im Allgemeinen abhängige Pakete ein.
• UPM-Pakete (Unity Package Manager):
  • Verwenden Sie eine .tgz-Erweiterung.
  • Installieren Sie das Projekt im Verzeichnis Packages Ihres Projekts.
  • Kann in Unity 2018.4 und höher importiert werden.
  • Verweisen Sie auf abhängige Pakete, die separat installiert werden müssen.

Die Seite Pakete enthält die aktuellen .unitypackage-Dateien für alle verfügbaren Pakete.

Die Seite Archiv enthält .unitypackage- und .tgz-Dateien für alle Paketversionen.

Unten finden Sie eine Anleitung zur Installation beider Pakettypen sowie Migrationsanleitungen für den Übergang vom Typ zum anderen.

Lesen Sie die zusätzlichen produktspezifischen Anleitungen für Firebase, wenn Sie mit diesen Installationsoptionen vertraut sind.

Asset-Pakete mit .unitypackage-Dateien importieren

Wählen Sie die Unity-Menüoption Assets > Import package > Custom Package aus und importieren Sie alle Elemente, um die Datei .unitypackage zu importieren. Dadurch wird der Paketinhalt zu Ihrem Projekt im Asset-Verzeichnis hinzugefügt.

Hinweis: Wenn Sie das Paket bereits über das Paketmanager-Fenster von Unity installiert haben, deinstallieren Sie die alte Version des Pakets, bevor Sie die neue Version importieren. Eine Anleitung dazu finden Sie unten.

UPM-Pakete mit .tgz-Dateien importieren (ab 2018.4)

Importieren Sie .tgz-Dateien mit einer der folgenden Methoden in Ihr Projekt:

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 in Ihrem Unity-Projektordner mit einem Texteditor.

4. Fügen Sie für jedes Paket, das Sie installieren möchten, einen Eintrag hinzu und ordnen Sie den Paketnamen dem Speicherort auf dem Laufwerk in Bezug auf die Datei Packages/manifest.json zu. Achten Sie darauf, file: an den Dateipfad .tgz anzuhängen. Wenn Sie beispielsweise com.google.firebase.storage und die zugehörigen Abhängigkeiten installieren, würde die Datei „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 aktiviert wird, wird die Datei „manifest.json“ neu geladen und die neu hinzugefügten Pakete importiert.

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

1. Dekomprimieren Sie die .tgz-Dateien.
2. Legen Sie den extrahierten Ordner im Ordner GooglePackages ab.

3. Bearbeiten Sie die Datei „manifest.json“ so, dass statt 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...
     }
   }
   

Paketmanager-UI

1. Öffnen Sie das Fenster „Paketmanager“ von Unity.

2. Klicken Sie links oben im Paketmanager-Fenster auf das Symbol + und wählen Sie Add package from tarball aus, um den Dateibrowser zu öffnen.

   

3. Wählen Sie im Dateibrowser das gewünschte Tarball-Paket aus.

Einige ältere Versionen von Unity unterstützen das direkte Hinzufügen von Tarballs nicht. In diesem Fall sind folgende Schritte erforderlich:

1. Dekomprimieren Sie die Datei .tgz.

2. Klicken Sie links oben im Paketmanager-Fenster auf das Symbol + und wählen Sie Add package from disk aus, um den Dateibrowser zu öffnen.

   

   Hinweis: Bei Unity 2018 wird das Symbol + links unten im Bereich mit der Paketliste platziert.

3. Wählen Sie den extrahierten Ordner im Dateibrowser aus.

Importieren Sie auch die .tgz-Dateien für die Abhängigkeiten des Pakets. Diese finden Sie auf der Archivseite im Abschnitt des gewünschten Pakets.

Wenn Sie beispielsweise com.google.firebase.storage installieren, würden Sie diese .tgz-Dateien in der folgenden Reihenfolge installieren:

1. Externer Abhängigkeitsmanager (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase-Authentifizierung (com.google.firebase.auth)
4. Firebase Storage (com.google.firebase.storage)

Wenn Sie alle .tgz-Dateien auf einmal hinzufügen möchten, ohne sich Gedanken über die Reihenfolge machen zu müssen, können Sie der Anleitung auf dem Tab manifest.json folgen.

Hinweis: Wenn Sie das Paket bereits mit einer .unitypackage-Datei installiert haben, müssen Sie diese Version des Pakets löschen, bevor Sie eine neue hinzufügen. Eine Anleitung dazu finden Sie unten.

Versionsverwaltung

Wenn Sie Ihre Projektdateien mit Versionsverwaltungssoftware verwalten, empfehlen wir, die entsprechenden .tgz-Dateien zur Versionsverwaltung hinzuzufügen. Sie können die manifest.json Ihres Projekts manuell bearbeiten (siehe Anleitung oben) und mithilfe von relativen Pfaden auf lokale .tgz-Dateien verweisen.

Wenn Sie Git verwenden, empfehlen wir Git Large File Storage (LFS) für die Verwaltung großer .tgz-Dateien.

Von UPM-Paketen zu Asset-Paketen migrieren

In manchen Fällen möchten Sie möglicherweise vom Unity Package Manager zur Verwaltung von Google-Paketen zur Installation von Paketen im Ordner „Assets“ wechseln.

Entfernen Sie alle Google-Pakete mit einer der folgenden Methoden aus dem Unity-Paketmanager:

Paketmanager-UI

1. Öffnen Sie das Fenster „Paketmanager“ von Unity.

2. Wählen Sie im Drop-down-Menü oben links In Project aus.

   

3. Geben Sie com.google in die Suchleiste ein, um nach Google-Paketen zu filtern.

   

4. Klicke auf den jeweiligen Paketnamen und dann auf Remove.

manifest.json

1. Öffnen Sie Packages/manifest.json in Ihrem Unity-Projektordner mit einem Texteditor.
2. Sehen Sie unter „Abhängigkeiten“ nach, ob Pakete von Google vorhanden sind. Der Paketname sollte mit „com.google“ beginnen, z. B. „com.google.firebase.app“.
3. Löschen Sie diese Zeilen und speichern Sie die JSON-Datei.
4. Wenn Unity den Fokus wiedererlangt, wird die Datei manifest.json neu geladen und die gelöschten Pakete entfernt.

Nachdem du diese Pakete aus dem Unity Package Manager deinstalliert hast, kannst du .unitypackage-Ersatzdateien von der Archivseite herunterladen und importieren.

Von Asset-Paketen zu UPM-Paketen migrieren

In einigen Fällen möchten Sie möglicherweise von der Installation von Produkten in der Asset-Baumstruktur hin zur Installation und Nachverfolgung von Produkten mit dem Unity Package Manager wechseln.

Wenn Sie nicht sicher sind, welche Installationsmethode Sie verwenden, prüfen Sie in der Unity-UI, ob die gewünschten Google-Pakete auf dem Tab „Projekt“ unter „Assets“ angezeigt werden.

So migrieren Sie zu UPM-Paketen:

1. Entfernen Sie alle Google-Pakete aus dem Ordner „Assets“.

   • Folgen Sie dieser Anleitung, um Firebase-Pakete zu deinstallieren.
   • Löschen Sie den Ordner GooglePlayPlugins unter Assets, um Play-Plug-ins für Unity zu deinstallieren.

2. Installieren Sie Pakete mit dem Unity-Paketmanager, wie oben beschrieben.

Produktspezifische Migrationsanleitung

Hier finden Sie eine Anleitung zu Firebase.