Installer des packages Google pour Unity

Les packages Google pour Unity sont distribués dans deux formats différents:

• Packages de ressources:
  • Elle comporte une extension .unitypackage.
  • Effectuez l'installation dans le répertoire Assets de votre projet.
  • Vous pouvez l'importer dans Unity 5 ou version ultérieure.
  • Incluez généralement des packages dépendants.
• Packages UPM (Unity Package Manager) :
  • Elle comporte une extension .tgz.
  • Effectuez l'installation dans le répertoire Packages de votre projet.
  • Peut être importé dans Unity 2018.4 ou version ultérieure.
  • Référencer les packages dépendants qui doivent être installés séparément.

La page Packages contient les derniers fichiers .unitypackage. pour tous les packages disponibles et les fichiers .tgz pour certains d'entre eux.

La page Archives contient les fichiers .unitypackage et .tgz pour toutes les versions du package.

Vous trouverez ci-dessous des instructions sur la façon d’installer ces deux types de packages, ainsi que contenant des instructions de migration pour passer d'un type à l'autre.

Une fois que vous êtes familiarisé avec ces options d'installation, reportez-vous à des instructions spécifiques au produit supplémentaires pour Firebase.

Importer des packages d'éléments avec des fichiers .unitypackage

Importez le fichier .unitypackage en sélectionnant l'option de menu Unity. Assets > Import package > Custom Package et importez tous les éléments. Le contenu du package est alors ajouté à votre projet sous la section "Assets" .

Remarque :Si vous avez déjà installé le package à l'aide du package Unity depuis la fenêtre du gestionnaire de packages, désinstallez l'ancienne version en important la nouvelle. Voir ci-dessous pour obtenir des instructions.

Importer des packages UPM avec des fichiers .tgz (2018.4+)

Importez des fichiers .tgz dans votre projet en utilisant l'une des méthodes suivantes:

manifest.json

1. Créez un dossier à côté du dossier Packages de votre projet et nommez-le GooglePackages
2. Placez les fichiers .tgz dans ce dossier.
3. Utilisez un éditeur de texte pour ouvrir Packages/manifest.json dans votre projet Unity .

4. Ajoutez une entrée pour chaque package que vous souhaitez installer, en mappant le nom du package. à l'emplacement sur le disque, par rapport au fichier Packages/manifest.json. Veillez à ajouter file: au chemin d'accès au fichier .tgz. Pour par exemple, si vous installez com.google.firebase.storage et ses le fichier manifest.json se présente comme suit:

   {
     "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. Enregistrez le fichier manifest.json.

6. Une fois qu'Unity est à nouveau sélectionné, il recharge le fichier manifest.json et importe les packages nouvellement ajoutés.

Certaines anciennes versions d'Unity ne prennent pas en charge les fichiers .tgz dans le fichier manifest.json. Dans ce cas, vous devez:

1. Décompressez les fichiers .tgz.
2. Placez le dossier extrait dans le dossier GooglePackages.

3. Modifiez plutôt le fichier manifest.json pour utiliser le chemin d'accès au dossier extrait. du fichier .tgz, comme ceci:

   {
     "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...
     }
   }
   

UI du gestionnaire de packages

1. Ouvrez la fenêtre Gestionnaire de packages d'Unity.

2. Cliquez sur l'icône + en haut à gauche de la fenêtre du gestionnaire de packages. sélectionnez Add package from tarball pour ouvrir l'explorateur de fichiers.

   

3. Sélectionnez le package tarball souhaité dans l'explorateur de fichiers.

Certaines anciennes versions d'Unity ne prennent pas en charge l'ajout direct de tarball. Dans ce cas, procédez comme suit:

1. Décompressez le fichier .tgz.

2. Cliquez sur l'icône + en haut à gauche du gestionnaire de packages. fenêtre et sélectionnez Add package from disk pour ouvrir l'explorateur de fichiers.

   

   Remarque :Unity 2018 place l'icône + en bas à gauche de la liste de packages. volet.

3. Sélectionnez le dossier extrait dans l'explorateur de fichiers.

Veillez également à importer les fichiers .tgz pour les dépendances du package, Vous les trouverez sur la page des archives, sous la section du package souhaité.

Par exemple, si vous installez com.google.firebase.storage, vous devez installez ces fichiers .tgz dans l'ordre suivant:

1. Gestionnaire de dépendances externe (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Authentification Firebase (com.google.firebase.auth)
4. Stockage Firebase (com.google.firebase.storage)

Si vous préférez ajouter tous les fichiers .tgz en même temps, sans vous soucier sur la commande, suivez les instructions fournies dans le onglet "manifest.json".

Remarque :Si vous avez déjà installé le package avec un .unitypackage assurez-vous de supprimer cette version du package avant en ajoutant un nouveau. Voir ci-dessous pour obtenir des instructions.

Contrôle des versions

Si vous utilisez un logiciel de contrôle des versions pour gérer les fichiers de votre projet, nous recommandez d'ajouter les fichiers .tgz pertinents au contrôle des versions. Vous pouvez modifiez les manifest.json de votre projet (consultez instructions ci-dessus) et référencer des fichiers .tgz locaux en utilisant chemins relatifs.

Si vous utilisez Git, nous vous recommandons Stockage de fichiers volumineux Git (LFS) permettant de gérer les fichiers .tgz volumineux.

Migrer des packages UPM vers des packages d'éléments

Dans certains cas, vous devrez peut-être abandonner Gestionnaire de packages Unity pour gérer les packages Google, installer des packages dans le dossier Assets.

Assurez-vous que tous les packages Google sont supprimés du gestionnaire de packages Unity à l'aide de l'une des méthodes suivantes:

UI du gestionnaire de packages

1. Ouvrez la fenêtre Gestionnaire de packages d'Unity.

2. Sélectionnez In Project dans le menu déroulant en haut à gauche.

   

3. Saisissez com.google dans la barre de recherche pour filtrer les packages Google.

   

4. Cliquez sur le nom de chaque package, puis sur Remove.

manifest.json

1. Utilisez un éditeur de texte pour ouvrir Packages/manifest.json dans votre projet Unity .
2. Vérifiez s'il existe des packages de Google sous "dépendances". Le package Le nom doit commencer par "com.google", par exemple "com.google.firebase.app".
3. Supprimez ces lignes et enregistrez le fichier JSON.
4. Une fois qu'Unity revient au focus, il recharge le fichier manifest.json et supprime les packages supprimés.

Une fois ces packages désinstallés du gestionnaire de packages Unity, vous pouvez télécharger et importer des fichiers .unitypackage de remplacement à partir des archives .

Migrer des packages d'éléments vers les packages UPM

Dans certains cas, vous souhaiterez peut-être abandonner l'installation de produits dans Arborescence des éléments permettant d'installer et de suivre des produits avec Unity Package Manager.

Si vous ne savez pas quelle méthode d'installation vous utilisez, dans l'UI Unity, vérifiez si les packages Google souhaités s'affichent dans l'onglet "Projet", sous Composants.

Pour migrer vers des packages UPM:

1. Assurez-vous que tous les packages Google sont supprimés du dossier "Assets" (Éléments).

   • Pour désinstaller les packages Firebase, suivez ces instructions.
   • Pour désinstaller les plug-ins Play pour Unity, supprimez le dossier GooglePlayPlugins moins de Assets.

2. Installer des packages à l'aide du gestionnaire de packages Unity, comme décrit ci-dessus.

Instructions de migration spécifiques aux produits

Pour obtenir des instructions sur Firebase, cliquez ici.