Google-Pakete für Unity installieren

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

  • Asset-Pakete: <ph type="x-smartling-placeholder">
      </ph>
    • Es muss eine .unitypackage-Erweiterung haben.
    • Installieren Sie es 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): <ph type="x-smartling-placeholder">
      </ph>
    • Es muss eine .tgz-Erweiterung haben.
    • Installieren Sie es 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 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 der beiden Pakettypen. mit Migrationsanleitungen für den Wechsel vom Typ auf den anderen.

Sobald du mit diesen Installationsoptionen vertraut bist, schau dir die zusätzliche produktspezifische Anleitungen für Firebase.

Asset-Pakete mit .unitypackage-Dateien werden importiert

Importieren Sie die Datei .unitypackage über die Unity-Menüoption Assets > Import package > Custom Package und importiert alle Elemente. Dadurch wird der Paketinhalt zu Ihrem Projekt im Bereich „Assets“ hinzugefügt. -Verzeichnis.

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

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 geben Sie ihm einen Namen GooglePackages.
  2. Legen Sie die .tgz-Dateien in diesem Ordner ab.
  3. Öffnen Sie Packages/manifest.json mit einem Texteditor in Ihrem Unity-Projekt Ordner.
  4. Fügen Sie für jedes Paket, das Sie installieren möchten, einen Eintrag hinzu, indem Sie den Paketnamen zuordnen zum Speicherort auf dem Laufwerk, relativ zur Datei Packages/manifest.json. Vergessen Sie nicht, file: an den Dateipfad .tgz anzuhängen. Für Wenn Sie beispielsweise com.google.firebase.storage und dessen Abhängigkeiten festlegen, 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. Sobald Unity wieder fokussiert ist, 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 der Pfad zum extrahierten Ordner verwendet wird. der Datei .tgz. Beispiel:

    {
      "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 Paket-Manager-Fenster 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.

    Screenshot des Unity Package Manager-Fensters mit dem

  3. Wählen Sie das gewünschte Tarball-Paket im Dateibrowser 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 auf das Symbol +. und wählen Sie Add package from disk aus, um den Dateibrowser zu öffnen.

    Screenshot des Unity Package Manager-Fensters mit dem

  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. das Sie auf der Archivseite unter dem Abschnitt des gewünschten Pakets.

Bei der Installation von com.google.firebase.storage würden Sie beispielsweise Installiere diese .tgz-Dateien in der folgenden Reihenfolge:

  1. Externer Abhängigkeitsmanager (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 lieber alle .tgz-Dateien gleichzeitig hinzufügen möchten, zur Bestellung erhalten Sie in der manifest.json

Versionsverwaltung

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

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

Von UPM-Paketen zu Asset-Paketen migrieren

In einigen Fällen möchten Sie vielleicht Unity-Paketmanager zum Verwalten von Google-Paketen bis zur Installation von Paketen im Ordner „Assets“.

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

Paketmanager-Benutzeroberfläche

  1. Öffnen Sie das Paket-Manager-Fenster von Unity.
  2. Wählen Sie im Drop-down-Menü oben links In Project aus.

    Screenshot des Unity Package Manager-Fensters mit dem

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

    Screenshot des Unity Package Manager-Fensters mit

  4. Klicken Sie auf den jeweiligen Paketnamen und dann auf Remove.

manifest.json

  1. Öffnen Sie Packages/manifest.json mit einem Texteditor in Ihrem Unity-Projekt Ordner.
  2. Prüfen Sie, ob unter „Abhängigkeiten“ Pakete von Google aufgeführt sind. Das Paket sollte mit „com.google“ beginnen, zum Beispiel „com.google.firebase.app“.
  3. Löschen Sie diese Zeilen und speichern Sie die JSON-Datei.
  4. Wenn Unity wieder den Fokus hat, wird die manifest.json-Datei neu geladen und entfernt die gelöschten Pakete.

Nachdem Sie diese Pakete aus dem Unity Package Manager deinstalliert haben, .unitypackage-Ersatzdateien aus dem Archiv herunterladen und importieren .

Von Asset-Paketen zu UPM-Paketen migrieren

In einigen Fällen möchten Sie vielleicht von der Installation von Produkten unter der Asset-Baum zur Installation und zum Tracking von Produkten mit dem Unity-Paketmanager.

Wenn Sie nicht sicher sind, welche Installationsmethode Sie verwenden, gehen Sie in der Unity-Benutzeroberfläche prüfen Sie, ob die gewünschten Google-Pakete auf dem Tab "Project" (Projekt) unter Assets

So migrieren Sie zu UPM-Paketen:

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

    • So deinstallieren Sie Firebase-Pakete: finden Sie in dieser Anleitung.
    • Lösche den Ordner GooglePlayPlugins, um Play-Plug-ins für Unity zu deinstallieren weniger als Assets.
  2. Pakete mit dem Unity Package Manager installieren, wie beschrieben siehe oben.

Produktspezifische Migrationsanleitung

Hier finden Sie eine Anleitung für Firebase.