Autres options d'installation d'Unity

Plutôt que de télécharger un fichier .zip volumineux contenant tous les .unitypackage fichiers pour .NET 3.X et .NET 4.X, vous pouvez télécharger des packages individuels à partir du site Google APIs for 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 d'Unity Package Manager

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 dont ils dépendent.

Cette page fournit des instructions concernant Unity Package Manager. Il est donc conseillé de vous familiariser avec cet outil à l'aide de 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 depuis le site Google APIs for Unity, gardez les points suivants à l'esprit :

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 avec le flux Unity Package Manager.

Après le téléchargement, pour 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), cliquez sur Import (Importer).

Importer des packages Firebase à l'aide d'Unity Package Manager

Lorsque vous importez des produits Firebase à partir de fichiers .tgz téléchargés depuis l'archive Google APIs for Unity, gardez les points suivants à l'esprit :

Cette méthode n'est disponible qu'à partir de la version 2018.3.
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 avec le flux Unity Package Manager.
Les dépendances de chaque fichier .tgz de produit sont liées à côté dans leurs propres fichiers .tgz. Vous devez télécharger et importer le fichier .tgz du produit et les fichiers .tgz de dépendance dans l'ordre correct :
1. External Dependency Manager (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Produits Firebase utilisés dans votre projet. Si vous utilisez Realtime Database ou Cloud Storage, importez Authentication (com.google.firebase.auth) first.

Après le téléchargement, importez les fichiers .tgz dans votre projet à l'aide de l'une des méthodes suivantes :

Interface utilisateur du gestionnaire de paquets

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électionnez Add package from tarball (Ajouter un package à partir d'un fichier tarball) pour ouvrir l'explorateur de fichiers.
Sélectionnez le fichier tarball souhaité dans l'explorateur de fichiers.

Certaines versions antérieures d'Unity 2019 ne sont pas compatibles avec l'ajout direct de fichiers tarball. Dans ce cas, vous devez procéder comme suit :

Décompressez le fichier .tgz.
Cliquez sur l'icône + en haut à gauche de la fenêtre du gestionnaire de paquets, puis sélectionnez Add package from disk (Ajouter un package à partir du disque) pour ouvrir l'explorateur 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-le GooglePackages.
Placez les fichiers .tgz dans ce dossier.
Utilisez un éditeur de texte pour ouvrir Packages/manifest.json sous 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 du fichier .tgz. Par exemple, si vous importez 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...
  }
}

Enregistrez le fichier manifest.json.
Lorsque Unity reprend le focus, il recharge le fichier manifest.json et importe les packages nouvellement ajoutés.

Certaines versions antérieures d'Unity ne sont pas compatibles avec les fichiers .tgz dans le fichier manifest.json. Dans ce cas, vous devez procéder comme suit :

Décompressez le fichier .tgz.

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

Migrer d'Unity Package Manager vers des packages d'éléments

Dans certains cas, vous pouvez passer d'Unity Package Manager pour suivre les produits Firebase à l'importation de produits sous 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 des packages d'éléments :

Notez les versions actuelles des packages Firebase dans votre projet et supprimez-les.
1. Dans le menu Window (Fenêtre), sélectionnez Package Manager (Gestionnaire de paquets). Dans la fenêtre Package Manager (Gestionnaire de paquets), assurez-vous que l'option "Packages: In Project" (Packages : dans le projet) est sélectionnée.
2. Notez les versions des packages Firebase importés.
3. Cliquez sur le nom de chaque package, puis sur Remove (Supprimer). Veillez à supprimer le package External Dependency Manager (.com.google.external-dependency-manager) ainsi que les packages Firebase.
Téléchargez et importez les 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 .unitypackage actuelles, vous pouvez télécharger et importer des packages individuels comme décrit plus haut sur cette page.

Migrer de packages d'éléments vers Unity Package Manager

Dans certains cas, vous pouvez passer de l'importation de produits sous le dossier Assets à l'importation et au suivi de 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à Unity Package Manager pour l'importation.

Pour migrer vers Unity Package Manager :

Assurez-vous que tous les packages Firebase et le package External Dependency Manager sont supprimés du dossier Assets, à l'aide de l'une des méthodes suivantes.
Interface utilisateur EDM4U
1. Dans votre projet Unity ouvert, accédez à Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages (Éléments > External Dependency Manager > Gestionnaire de versions > Désinstaller les packages gérés).
2. Sélectionnez tous les packages Firebase et External Dependency Manager.
3. Cliquez sur Uninstall Selected Package (Désinstaller le package sélectionné).
Suppression manuelle
À l'aide des outils du 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 d'Unity Package Manager, comme décrit plus haut sur cette page.