Plutôt que de télécharger un grand fichier .zip
contenant tous les fichiers .unitypackage
pour .NET 3.X et .NET 4.X, vous pouvez télécharger des packages individuels sur le site des API Google pour Unity.
Le site fournit les éléments suivants :
- Fichiers
.unitypackage
.NET 4.X individuels à importer en tant que packages d'éléments. - Archives
.tgz
individuelles à importer à l'aide du Gestionnaire de packages Unity.
Cela est particulièrement utile lorsque votre application utilise un seul produit Firebase, car les fichiers .unitypackage
individuels contiennent toutes les dépendances nécessaires et les fichiers .tgz
sont listés à côté des fichiers .tgz
associés sur lesquels ils dépendent.
Cette page fournit des instructions concernant le gestionnaire de paquets Unity. Il est donc recommandé de vous familiariser avec cet outil dans la documentation Unity.
Importer des packages Firebase en tant qu'éléments
Lorsque vous importez des produits Firebase à partir de fichiers .unitypackage
téléchargés sur le site des API Google pour Unity, gardez à l'esprit les points suivants :
Si vous utilisez plusieurs produits Firebase dans votre projet, vous devez télécharger et mettre à niveau tous les produits Firebase vers la même version.
Ne mélangez pas les méthodes d'importation dans un même projet. Autrement dit, n'importez pas de produits Firebase avec le flux de package d'éléments et le flux du Gestionnaire de packages Unity.
Après avoir téléchargé le fichier, procédez comme suit pour l'importer:
Dans votre projet Unity ouvert, accédez à Assets (Éléments) > Import Package (Importer un package) > Custom Package (Package personnalisé).
Dans la fenêtre Import Unity Package (Importer un package Unity) qui s'ouvre, cliquez sur Import (Importer).
Importer des packages Firebase à l'aide du gestionnaire de packages Unity
Lorsque vous importez des produits Firebase à partir de fichiers .tgz
téléchargés depuis l'archive des API Google pour Unity, gardez à l'esprit les points suivants:
Cette méthode n'est disponible que dans la version 2018.3 ou ultérieure.
Si vous utilisez plusieurs produits Firebase dans votre projet, vous devez télécharger et mettre à niveau tous les produits Firebase vers la même version.
Ne mélangez pas les méthodes d'importation dans un même projet. Autrement dit, n'importez pas de produits Firebase avec le flux de package d'éléments ni avec le flux du Gestionnaire de paquets Unity.
Les dépendances de chaque fichier
.tgz
de produit sont associées dans leurs propres fichiers.tgz
. Vous devez télécharger et importer le fichier.tgz
du produit et les fichiers.tgz
des dépendances dans l'ordre suivant :- Gestionnaire de dépendances externe (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Produits Firebase utilisés dans votre projet Si vous utilisez Realtime Database ou Cloud Storage, importez d'abord Authentication (
com.google.firebase.auth
).
- Gestionnaire de dépendances externe (
Après le téléchargement, importez les fichiers .tgz
dans votre projet à l'aide de l'une des méthodes suivantes :
UI du gestionnaire de packages
- Ouvrez la fenêtre du gestionnaire de paquets d'Unity.
- Cliquez sur l'icône
+
en haut à gauche de la fenêtre du Gestionnaire de paquets, puis sélectionnezAdd package from tarball
pour ouvrir le navigateur de fichiers. - Sélectionnez le fichier tarball souhaité dans l'explorateur de fichiers.
Certaines anciennes versions d'Unity 2019 ne permettent pas d'ajouter directement des fichiers 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 paquets, puis sélectionnezAdd package from disk
pour ouvrir le navigateur de fichiers. - Sélectionnez le dossier extrait dans l'explorateur de fichiers.
manifest.json
- Créez un dossier à côté du dossier
Packages
de votre projet et nommez-leGooglePackages
. - Placez les fichiers
.tgz
dans ce dossier. - Utilisez un éditeur de texte pour ouvrir
Packages/manifest.json
dans le dossier de votre projet Unity. Ajoutez une entrée pour chaque package que vous souhaitez importer, en mappant le nom du package à l'emplacement sur le disque. Veillez à ajouter
file:
au chemin d'accès au fichier.tgz
. Par exemple, si vous importezcom.google.firebase.storage
et ses dépendances, votremanifest.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... } }
Enregistrez le fichier
manifest.json
.Lorsque Unity récupère le focus, il recharge le
manifest.json
et importe les packages nouvellement ajoutés.
Certaines anciennes versions d'Unity ne sont pas compatibles avec les fichiers .tgz
dans le manifest.json
.
Dans ce cas, vous devez :
- Décompressez le fichier
.tgz
. Modifiez votre
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... } }
Migrer du Gestionnaire de paquets Unity vers les packages d'éléments
Dans certains cas, vous pouvez passer de l'utilisation du Gestionnaire de paquets Unity au suivi des produits Firebase, puis à l'importation de produits dans le dossier Assets
.
Si vous ne savez pas quelle méthode d'importation vous utilisez, ouvrez le fichier Packages/manifest.json
dans le dossier de votre projet Unity. Si le fichier contient des entrées commençant par com.google.firebase
, votre projet a utilisé Unity Package Manager pour l'importation.
Pour migrer vers les packs d'éléments :
Notez les versions actuelles des packages Firebase dans votre projet, puis supprimez-les.
- Dans le menu Window (Fenêtre), sélectionnez Package Manager (Gestionnaire de paquets). Dans la fenêtre Gestionnaire de packages, assurez-vous que l'option "Packages: In Project" est sélectionnée.
- Notez les versions des packages Firebase importés.
- Cliquez sur chaque nom de package, puis sur Supprimer. Assurez-vous de supprimer le package External Dependency Manager (
.com.google.external-dependency-manager
) ainsi que les packages Firebase.
Téléchargez et importez des fichiers
.unitypackage
de remplacement. Deux possibilités s'offrent à vous :- Si vous pouvez passer à la dernière version de chaque package, téléchargez le fichier ZIP du SDK Unity Firebase et importez-le comme décrit dans Ajouter Firebase à votre projet Unity.
- Si vous devez conserver les versions actuelles de
.unitypackage
, vous pouvez télécharger et importer des packages individuels comme décrit ci-dessus sur cette page.
Migrer des packs d'éléments vers le Gestionnaire de paquets Unity
Dans certains cas, vous pouvez passer de l'importation de produits dans le dossier Assets
à l'importation et au suivi des produits avec Unity Package Manager.
Si vous ne savez pas quelle méthode d'importation vous utilisez, ouvrez le fichier Packages/manifest.json
dans le dossier de votre projet Unity. Si le fichier contient des entrées commençant par com.google.firebase
, votre projet utilise déjà le gestionnaire de packages Unity pour l'importation.
Pour migrer vers le Gestionnaire de paquets Unity :
Assurez-vous que tous les packages Firebase et le package du gestionnaire de dépendances externes sont supprimés du dossier
Assets
à l'aide de l'une des méthodes suivantes.Interface utilisateur EDM4U
- Dans votre projet Unity ouvert, accédez à Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages (Éléments > Gestionnaire de dépendances externes > Gestionnaire de versions > Désinstaller les packages gérés).
- Sélectionnez tous les packages Firebase et le gestionnaire de dépendances externes.
- Cliquez sur Désinstaller le package sélectionné.
Suppression manuelle
À l'aide d'outils de système de fichiers, supprimez manuellement les dossiers suivants :
Assets/Editor Default Resources/Firebase
Assets/ExternalDependencyManager
Assets/Firebase
Assets/Parse
Assets/Plugins/iOS/Firebase
Importez des packages à l'aide du gestionnaire de packages Unity, comme décrit ci-dessus sur cette page.