Google-Pakete für Unity installieren

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

• Asset-Pakete:
  • Die Datei muss die Erweiterung .unitypackage haben.
  • Installieren Sie die Abhängigkeiten im Assets-Verzeichnis Ihres Projekts.
  • Kann in Unity 5 und höher importiert werden.
  • In der Regel werden abhängige Pakete einbezogen.
• UPM-Pakete (Unity Package Manager):
  • Die Datei muss die Erweiterung .tgz haben.
  • Installieren Sie die Abhängigkeiten im Packages-Verzeichnis 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 neuesten .unitypackage-Dateien für alle verfügbaren Pakete und .tgz-Dateien für einige der Pakete.

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

Unten finden Sie eine Anleitung zur Installation beider Arten von Paketen sowie eine Migrationsanleitung für den Übergang von einem Typ zum anderen.

Wenn Sie mit diesen Installationsoptionen vertraut sind, lesen Sie sich die zusätzlichen produktspezifischen Anleitungen für Firebase durch.

Pakete mit OpenUPM importieren

Sie können Ihrem Unity-Projekt externe Pakete über die OpenUPM-Registrierung hinzufügen. OpenUPM hostet viele nützliche Plug-ins und SDKs, z. B. das Google Play Integrity-Plug-in, mit dem Sie Ihre App vor Betrug und Missbrauch schützen können.

So fügen Sie beispielsweise das Google Play Integrity-Plug-in mit OpenUPM hinzu:

OpenUPM-CLI

Wenn Sie die OpenUPM-CLI installiert haben, können Sie die OpenUPM-Registrierung mit dem folgenden Befehl installieren:

openupm add com.google.play.integrity

OpenUPM

1. Öffnen Sie die Paketmanager-Einstellungen, indem Sie im Unity-Menü Bearbeiten > Projekteinstellungen > Paketmanager auswählen.

2. Fügen Sie OpenUPM als Bereichsregistrierung zum Paketmanager-Fenster hinzu:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Öffnen Sie das Paketmanager-Menü, indem Sie im Unity-Menü Window > Package Manager auswählen.

4. Wählen Sie im Drop-down-Menü für den Verwaltungskontobereich Meine Registrierungen aus.

   

5. Wählen Sie das Paket Google Play Integrity plugin for Unity aus der Paketliste aus und klicken Sie auf Install (Installieren).

Asset-Pakete mit .unitypackage-Dateien importieren

Importieren Sie die .unitypackage-Datei, indem Sie im Unity-Menü die Option Assets > Import package > Custom Package auswählen und alle Elemente importieren. Dadurch werden die Paketinhalte Ihrem Projekt im Verzeichnis „Assets“ hinzugefügt.

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

UPM-Pakete mit .tgz-Dateien importieren (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 mit dem Namen GooglePackages.
2. Legen Sie die .tgz-Dateien in diesem Ordner ab.
3. Öffnen Sie Packages/manifest.json in einem Texteditor in Ihrem Unity-Projektordner.

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 zu, relativ zur Datei Packages/manifest.json. Hängen Sie file: an den Dateipfad .tgz an. Wenn Sie beispielsweise com.google.firebase.storage und seine Abhängigkeiten installieren, 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 im Fokus ist, wird die Datei „manifest.json“ neu geladen und die neu hinzugefügten Pakete werden 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 Dateien .tgz.
2. Legen Sie den extrahierten Ordner im Ordner GooglePackages ab.

3. Bearbeiten Sie die Datei „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...
     }
   }
   

Benutzeroberfläche des Paketmanagers

1. Öffnen Sie das Package Manager-Fenster von 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 das gewünschte Tarball aus.

Einige ältere Versionen von Unity unterstützen das direkte Hinzufügen von Tarballs nicht. In diesem Fall müssen Sie Folgendes tun:

1. Dekomprimieren Sie die Datei .tgz.

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

   

   Hinweis :In Unity 2018 befindet sich das Symbol + unten links im Bereich „Paketliste“.

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

Achten Sie darauf, auch die .tgz-Dateien für die Abhängigkeiten des Pakets zu importieren. 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. External Dependency Manager (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase Auth (com.google.firebase.auth)
4. Firebase Storage (com.google.firebase.storage)

Wenn Sie alle .tgz-Dateien auf einmal hinzufügen möchten, ohne sich um die Reihenfolge kümmern 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 finden Sie unten.

Versionsverwaltung

Wenn Sie eine Versionsverwaltungssoftware zum Verwalten Ihrer Projektdateien verwenden, empfehlen wir, die entsprechenden .tgz-Dateien der Versionsverwaltung hinzuzufügen. Sie können die manifest.json-Datei Ihres Projekts manuell bearbeiten (siehe oben) und mit 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 einigen Fällen möchten Sie möglicherweise von der Verwendung des Unity Package Manager zum Verwalten von Google-Paketen zur Installation von Paketen im Ordner „Assets“ wechseln.

Achten Sie darauf, dass alle Google-Pakete aus dem Unity Package Manager entfernt werden. Verwenden Sie dazu eine der folgenden Methoden:

Benutzeroberfläche des Paketmanagers

1. Öffnen Sie das Package Manager-Fenster von Unity.

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

   

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

   

4. Klicken Sie auf die einzelnen Paketnamen und dann auf Remove.

manifest.json

1. Öffnen Sie Packages/manifest.json in einem Texteditor in Ihrem Unity-Projektordner.
2. Prüfen Sie, ob unter „dependencies“ Pakete von Google aufgeführt 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 wieder im Fokus ist, wird die manifest.json-Datei neu geladen und die gelöschten Pakete werden entfernt.

Nachdem Sie diese Pakete aus dem Unity Package Manager deinstalliert haben, können Sie Ersatz-.unitypackage-Dateien 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 im Asset-Baum zur Installation und Nachverfolgung von Produkten mit dem Unity-Paketmanager wechseln.

Wenn Sie sich nicht sicher sind, welche Installationsmethode Sie verwenden, sehen Sie in der Unity-Benutzeroberfläche auf dem Tab „Project“ unter „Assets“ nach, ob die gewünschten Google-Pakete angezeigt werden.

So migrieren Sie zu UPM-Paketen:

1. Achten Sie darauf, dass alle Google-Pakete aus dem Ordner „Assets“ entfernt wurden.

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

2. Installieren Sie Pakete mit dem Unity Package Manager, wie oben beschrieben.

Produktspezifische Migrationsanleitungen

Eine Anleitung für Firebase finden Sie hier.