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.
- Verwenden Sie eine
- 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.
- Verwenden Sie eine
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.
UPM-Pakete mit .tgz
-Dateien importieren (ab 2018.4)
Importieren Sie .tgz
-Dateien mit einer der folgenden Methoden in Ihr Projekt:
manifest.json
- Erstellen Sie neben dem Ordner
Packages
Ihres Projekts einen neuen Ordner und nennen Sie ihnGooglePackages
. - Legen Sie die
.tgz
-Dateien in diesem Ordner ab. - Öffnen Sie
Packages/manifest.json
in Ihrem Unity-Projektordner mit einem Texteditor. 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 beispielsweisecom.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... } }
Speichern Sie die Datei „manifest.json“.
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:
- Dekomprimieren Sie die
.tgz
-Dateien. - Legen Sie den extrahierten Ordner im Ordner
GooglePackages
ab. 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
- Öffnen Sie das Fenster „Paketmanager“ von Unity.
Klicken Sie links oben im Paketmanager-Fenster auf das Symbol
+
und wählen SieAdd package from tarball
aus, um den Dateibrowser zu öffnen.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:
- Dekomprimieren Sie die Datei
.tgz
. Klicken Sie links oben im Paketmanager-Fenster auf das Symbol
+
und wählen SieAdd package from disk
aus, um den Dateibrowser zu öffnen.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:
- Externer Abhängigkeitsmanager (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Firebase-Authentifizierung (
com.google.firebase.auth
) - 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.
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
- Öffnen Sie das Fenster „Paketmanager“ von Unity.
Wählen Sie im Drop-down-Menü oben links
In Project
aus.Geben Sie
com.google
in die Suchleiste ein, um nach Google-Paketen zu filtern.Klicke auf den jeweiligen Paketnamen und dann auf
Remove
.
manifest.json
- Öffnen Sie
Packages/manifest.json
in Ihrem Unity-Projektordner mit einem Texteditor. - 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“.
- Löschen Sie diese Zeilen und speichern Sie die JSON-Datei.
- 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:
Entfernen Sie alle Google-Pakete aus dem Ordner „Assets“.
- Folgen Sie dieser Anleitung, um Firebase-Pakete zu deinstallieren.
- Löschen Sie den Ordner
GooglePlayPlugins
unterAssets
, um Play-Plug-ins für Unity zu deinstallieren.
Installieren Sie Pakete mit dem Unity-Paketmanager, wie oben beschrieben.