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.
- Posséder une extension
- 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.
- Posséder une extension
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".
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
- Créez un dossier à côté du dossier
Packages
de votre projet et nommez-leGooglePackages
. - Placez les fichiers
.tgz
dans ce dossier. - À l'aide d'un éditeur de texte, ouvrez
Packages/manifest.json
sous le dossier de votre projet Unity. 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 à ajouterfile:
au chemin d'accès au fichier.tgz
. Par exemple, si vous installezcom.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... } }
Enregistrez le fichier manifest.json.
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:
- Décompressez les fichiers
.tgz
. - Placez le dossier extrait dans le dossier
GooglePackages
. 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
- Ouvrez la fenêtre du gestionnaire de packages d'Unity.
Cliquez sur l'icône
+
en haut à gauche de la fenêtre du gestionnaire de packages et sélectionnezAdd package from tarball
pour ouvrir l'explorateur de fichiers.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:
- Décompressez le fichier
.tgz
. Cliquez sur l'icône
+
en haut à gauche de la fenêtre du gestionnaire de packages et sélectionnezAdd package from disk
pour ouvrir l'explorateur de fichiers.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:
- Gestionnaire de dépendances externes (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Authentification Firebase (
com.google.firebase.auth
) - 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.
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
- Ouvrez la fenêtre du gestionnaire de packages d'Unity.
Sélectionnez
In Project
dans le menu déroulant en haut à gauche.Saisissez
com.google
dans la barre de recherche pour filtrer les packages Google.Cliquez sur le nom de chaque package, puis sur
Remove
.
manifest.json
- À l'aide d'un éditeur de texte, ouvrez
Packages/manifest.json
sous le dossier de votre projet Unity. - 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".
- Supprimez ces lignes et enregistrez le fichier json.
- 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:
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
sousAssets
.
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.