Installer des packages Google pour Unity

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

• Packages d'assets :
  • avoir une extension .unitypackage ;
  • Installez-le dans le répertoire Assets de votre projet.
  • Peut être importé dans Unity 5 ou version ultérieure.
  • Inclut généralement les packages dépendants.
• Paquets Unity Package Manager (UPM) :
  • avoir une extension .tgz ;
  • Installez-le dans le répertoire Packages de votre projet.
  • Peut être importé dans Unity 2018.4 ou version ultérieure.
  • Référencez 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 Archive contient des fichiers .unitypackage et .tgz pour toutes les versions de package.

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

Une fois que vous avez pris connaissance de ces options d'installation, consultez les instructions spécifiques au produit supplémentaires pour Firebase.

Importer des packages à l'aide d'OpenUPM

Vous pouvez ajouter des packages externes à votre projet Unity à l'aide du registre OpenUPM. OpenUPM héberge de nombreux plug-ins et SDK utiles, tels que le plug-in Google Play Integrity, qui aide à protéger votre application contre la fraude et les abus.

Voici comment ajouter, par exemple, le plug-in Google Play Integrity à l'aide d'OpenUPM.

OpenUPM-CLI

Si la CLI OpenUPM est installée, vous pouvez installer le Registre OpenUPM à l'aide de la commande suivante:

openupm add com.google.play.integrity

OpenUPM

1. Ouvrez les paramètres du gestionnaire de paquets en sélectionnant l'option de menu Unity Edit > Project Settings > Package Manager (Modifier > Paramètres du projet > Gestionnaire de paquets).

2. Ajoutez OpenUPM en tant que registre à portée à la fenêtre du Gestionnaire de paquets:

   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. Ouvrez le menu du gestionnaire de paquets en sélectionnant l'option de menu Unity Window > Package Manager (Fenêtre > Gestionnaire de paquets).

4. Dans le menu déroulant de l'étendue du gestionnaire, sélectionnez Mes registres.

   

5. Sélectionnez le package Google Play Integrity plug-in for Unity (Plug-in Google Play Integrity pour Unity) dans la liste des packages, puis appuyez sur Install (Installer).

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 "Assets".

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'importer la nouvelle. Pour en savoir plus, 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 à l'aide de 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 le dossier de 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. Par exemple, si vous installez com.google.firebase.storage et ses dépendances, votre 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. Lorsque Unity reprend le focus, il recharge le fichier manifest.json et importe les packages nouvellement ajoutés.

Certaines anciennes versions d'Unity ne sont pas compatibles avec 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 votre fichier manifest.json pour utiliser 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 paquets

1. Ouvrez la fenêtre du gestionnaire de paquets d'Unity.

2. Cliquez sur l'icône + en haut à gauche de la fenêtre du Gestionnaire de paquets, puis sélectionnez Add package from tarball pour ouvrir le navigateur de fichiers.

   

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

Certaines anciennes versions d'Unity ne permettent pas d'ajouter directement des fichiers 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 paquets, puis sélectionnez Add package from disk pour ouvrir le navigateur de fichiers.

   

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

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

Veillez également à importer les fichiers .tgz pour les dépendances du package, que vous trouverez sur la page d'archive, sous 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. Firebase Auth (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 manifest.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 autre. Pour en savoir plus, 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'ajouter les fichiers .tgz pertinents au contrôle des versions. 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'éléments

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

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

UI du gestionnaire de paquets

1. Ouvrez la fenêtre du gestionnaire de paquets 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 chaque nom de package, puis sur Remove.

manifest.json

1. Utilisez un éditeur de texte pour ouvrir Packages/manifest.json dans le dossier de votre projet Unity.
2. Vérifiez si des packages Google figurent 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 le focus, il recharge le fichier manifest.json et supprime les packages supprimés.

Une fois ces packages désinstallés du Gestionnaire de paquets Unity, vous pouvez télécharger et importer des fichiers .unitypackage de remplacement à partir de la page d'archive.

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

Dans certains cas, vous pouvez passer de l'installation de produits sous l'arborescence des é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, dans l'interface utilisateur d'Unity, vérifiez si les packages Google souhaités apparaissent dans l'onglet "Project" (Projet), sous "Assets" (Composants).

Pour migrer vers les packages UPM:

1. Assurez-vous que tous les packages Google ont été 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 paquets Unity, comme décrit ci-dessus.

Instructions de migration spécifiques aux produits

Pour obtenir des instructions sur Firebase, cliquez ici.