Installer des packages Google pour Unity

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

• Packages d'éléments :
  • Posséder une extension .unitypackage
  • Effectuez l'installation dans le répertoire Assets de votre projet.
  • Peut être importé dans Unity 5 ou version ultérieure.
  • Incluez généralement des packages dépendants.
• Packages UPM (Unity Package Manager) :
  • Posséder une extension .tgz
  • Effectuez l'installation dans le répertoire Packages de votre projet.
  • Peut être importé dans Unity 2018.4 et versions ultérieures.
  • 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.

La page Archive contient les fichiers .unitypackage et .tgz pour toutes les versions de package.

Vous trouverez ci-dessous des instructions sur l'installation des deux types de packages, ainsi que des instructions de migration pour passer d'un type à l'autre.

Une fois que vous vous êtes familiarisé avec ces options d'installation, consultez les instructions supplémentaires spécifiques au produit 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 en important tous les éléments. Le contenu du package est alors ajouté à votre projet dans le répertoire "Éléments".

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

Importer des packages UPM avec des fichiers .tgz (2018.4 et versions ultérieures)

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. À l'aide d'un éditeur de texte, ouvrez Packages/manifest.json sous le dossier de votre projet Unity.

4. Ajoutez une entrée pour chaque package à 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. Par exemple, si vous installez com.google.firebase.storage et ses dépendances, votre fichier manifest.json se présentera 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. Lorsque Unity récupère son focus, 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 le fichier manifest.json de sorte qu'il utilise le chemin d'accès au dossier extrait au lieu du fichier .tgz, comme suit:

   {
     "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 du gestionnaire de packages d'Unity.

2. Cliquez sur l'icône + en haut à gauche de la fenêtre du gestionnaire de packages et 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 de Unity ne prennent pas en charge l'ajout direct de tarballs. Dans ce cas, vous devez:

1. Décompressez le fichier .tgz.

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

   

   Remarque :Unity 2018 place l'icône + dans l'angle inférieur gauche du volet de la liste des packages.

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

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

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

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

Si vous préférez ajouter tous les fichiers .tgz en même temps, sans vous soucier de l'ordre, vous pouvez suivre les instructions de l'onglet manifeste.json.

Remarque :Si vous avez déjà installé le package avec un fichier .unitypackage, veillez à supprimer cette version du package avant d'en ajouter une nouvelle. Pour obtenir des instructions, consultez les instructions ci-dessous.

Contrôle des versions

Si vous utilisez un logiciel de contrôle des versions pour gérer les fichiers de votre projet, nous vous recommandons d'y ajouter les fichiers .tgz pertinents. Vous pouvez modifier manuellement le fichier manifest.json de votre projet (voir les instructions ci-dessus) et référencer des fichiers .tgz locaux à l'aide de chemins d'accès relatifs.

Si vous utilisez git, nous vous recommandons d'utiliser Git Large File Storage (LFS) pour gérer les fichiers .tgz volumineux.

Migrer des packages UPM vers des packages d'assets

Dans certains cas, vous pouvez passer de l'utilisation d'Unity Package Manager pour gérer les packages Google à l'installation de packages dans le dossier "Assets" (Éléments).

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

UI du gestionnaire de packages

1. Ouvrez la fenêtre du 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. À l'aide d'un éditeur de texte, ouvrez Packages/manifest.json sous le dossier de votre projet Unity.
2. Vérifiez si des packages de Google sont présents sous "dépendances". Le nom du package doit commencer par "com.google", par exemple "com.google.firebase.app".
3. Supprimez ces lignes et enregistrez le fichier json.
4. Lorsque Unity récupère son 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 les fichiers .unitypackage de remplacement à partir de la page d'archive.

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

Dans certains cas, vous pouvez passer de l'installation de produits dans l'arborescence d'éléments à l'installation et au suivi des produits avec Unity Package Manager.

Si vous ne savez pas quelle méthode d'installation vous utilisez, vérifiez si les packages Google souhaités apparaissent dans l'interface utilisateur d'Unity dans l'onglet "Project" (Projet), sous "Assets" (Éléments).

Pour migrer vers des packages UPM:

1. Assurez-vous que tous les packages Google sont supprimés du dossier "Assets".

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

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

Instructions de migration spécifiques aux produits

Cliquez ici pour obtenir des instructions sur Firebase.