Google-Pakete für Unity installieren

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

• Asset-Pakete:
  • Sie haben die Erweiterung .unitypackage.
  • Installieren Sie die Datei im Assets-Verzeichnis Ihres Projekts.
  • Kann in Unity 5 und höher importiert werden.
  • Sie enthalten in der Regel abhängige Pakete.
• UPM-Pakete (Unity Package Manager):
  • Sie haben die Erweiterung .tgz.
  • Installieren Sie die Datei im Packages-Verzeichnis Ihres Projekts.
  • Kann in Unity 2018.4 und höher importiert werden.
  • Verweise 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 zum Installieren beider Pakettypen sowie eine Anleitung zur Migration von einem Typ zum anderen.

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

Pakete mit OpenUPM importieren

Über die OpenUPM-Registry können Sie Ihrem Unity-Projekt externe Pakete hinzufügen. OpenUPM beherbergt 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.

Im Folgenden wird beschrieben, wie Sie beispielsweise das Google Play Integrity-Plug-in mit OpenUPM hinzufügen.

OpenUPM-CLI

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

openupm add com.google.play.integrity

OpenUPM

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

2. Fügen Sie OpenUPM dem Fenster „Package Manager“ als eingeschränkte Registry 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 Menü des Paketmanagers, indem Sie die Unity-Menüoption Fenster > Paketmanager auswählen.

4. Wählen Sie im Drop-down-Menü „Verwaltungskonto“ die Option Meine Registrierungen aus.

   

5. Wählen Sie in der Paketliste das Paket Google Play Integrity-Plug-in für Unity aus und klicken Sie auf Installieren.

Asset-Pakete mit .unitypackage-Dateien importieren

Importiere die .unitypackage-Datei, indem du die Unity-Menüoption Assets > Import package > Custom Package auswählst und alle Elemente importierst. Dadurch wird der Paketinhalt Ihrem Projekt im Verzeichnis „Assets“ hinzugefügt.

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

UPM-Pakete mit .tgz-Dateien importieren (2018.4 und höher)

Sie können .tgz-Dateien auf eine der folgenden Arten in Ihr Projekt importieren:

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 diesen Ordner ab.
3. Öffnen Sie Packages/manifest.json im Unity-Projektordner in 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 zu, bezogen auf die Datei Packages/manifest.json. Fügen Sie dem Dateipfad .tgz das Zeichen file: an. Wenn Sie beispielsweise com.google.firebase.storage und seine Abhängigkeiten installieren, würde Ihre 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 den Fokus erhält, 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“, sodass anstelle 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-Benutzeroberfläche

1. Öffnen Sie das Fenster „Package Manager“ (Paketmanager) von Unity.

2. Klicken Sie links oben im Fenster „Package Manager“ (Paketmanager) 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 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 links oben 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 wird das Symbol + links unten im Bereich der Paketliste angezeigt.

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

Importieren Sie auch die .tgz-Dateien für die Abhängigkeiten des Pakets. Sie 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 du alle .tgz-Dateien gleichzeitig hinzufügen möchtest, ohne dir Gedanken über die Reihenfolge zu machen, kannst du 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 einer Versionskontrollsoftware verwalten, empfehlen wir, die entsprechenden .tgz-Dateien der Versionskontrolle hinzuzufügen. Sie können die manifest.json-Datei Ihres Projekts manuell bearbeiten (siehe Anleitung oben) und mithilfe relativer Pfade auf lokale .tgz-Dateien verweisen.

Wenn Sie Git verwenden, empfehlen wir Git Large File Storage (LFS) zum Verwalten großer .tgz-Dateien.

Von UPM-Paketen zu Asset-Paketen migrieren

In einigen Fällen kann es sinnvoll sein, anstelle des Unity Package Managers Google-Pakete im Assets-Ordner zu installieren.

Entfernen Sie alle Google-Pakete aus dem Unity-Paketmanager. Verwenden Sie dazu eine der folgenden Methoden:

Paketmanager-Benutzeroberfläche

1. Öffnen Sie das Fenster „Package Manager“ (Paketmanager) 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 im Unity-Projektordner in einem Texteditor.
2. Prüfen Sie, ob unter „Abhängigkeiten“ Pakete von Google aufgeführt sind. Der Paketname muss 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 den Fokus erhält, wird die Datei manifest.json 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 Assets-Baum zum Installieren und Überwachen von Produkten mit dem Unity-Paketmanager wechseln.

Wenn Sie sich nicht sicher sind, welche Installationsmethode Sie verwenden, prüfen Sie in der Unity-Benutzeroberfläche, 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.
   • Wenn Sie 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.