Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Au lieu de télécharger un fichier .zip volumineux 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 .NET 4.X .unitypackage 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 dont ils dépendent.
Cette page fournit des instructions concernant le gestionnaire de packages Unity. Il est donc conseillé de vous renseigner sur 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 depuis le site des API Google pour 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. En d'autres termes, n'importez pas les produits Firebase avec le flux de package d'éléments et le flux du gestionnaire de packages Unity.
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) qui s'ouvre, 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 des API Google pour Unity, gardez les points suivants à l'esprit :
Cette méthode n'est disponible que dans la version 2018.3 et ultérieures.
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. En d'autres termes, n'importez pas les produits Firebase avec le flux du package d'éléments et avec le flux du gestionnaire de packages Unity.
Les dépendances de chaque fichier .tgz du 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 de dépendance, dans le bon ordre :
Gestionnaire de dépendances externes (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).
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 packages
Ouvrez la fenêtre du gestionnaire de packages Unity.
Cliquez sur l'icône + en haut à gauche de la fenêtre du gestionnaire de packages, puis sélectionnez Add package from tarball pour ouvrir l'explorateur de fichiers.
Sélectionnez l'archive tar souhaitée dans l'explorateur de fichiers.
Certaines anciennes versions d'Unity 2019 ne permettent pas d'ajouter directement des fichiers tar.
Dans ce cas, vous devrez :
Décompressez le fichier .tgz.
Cliquez sur l'icône + en haut à gauche de la fenêtre du gestionnaire de packages, puis sélectionnez Add package from disk 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 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 importiez com.google.firebase.storage et ses dépendances, votre manifest.json se présenterait comme suit :
Migrer du Gestionnaire de packages Unity vers les packages d'éléments
Dans certains cas, vous pouvez passer de l'utilisation d'Unity Package Manager pour suivre les produits Firebase à 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 packages d'éléments :
Notez les versions actuelles des packages Firebase dans votre projet et supprimez-les.
Dans le menu Window (Fenêtre), sélectionnez Package Manager (Gestionnaire de packages). Dans la fenêtre Package Manager (Gestionnaire de packages), assurez-vous que l'option "Packages: In Project" (Packages : dans le projet) est sélectionnée.
Notez les versions des packages Firebase importés.
Cliquez sur le nom de chaque package, puis sur 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 actuelles de .unitypackage, vous pouvez télécharger et importer des packages individuels comme décrit ci-dessus sur cette page.
Migrer des packages d'éléments vers Unity Package Manager
Dans certains cas, vous pouvez souhaiter 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, en utilisant 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 External Dependency Manager.
Cliquez sur 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 du gestionnaire de packages Unity, comme décrit ci-dessus sur cette page.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nRather than downloading a large `.zip` file containing all `.unitypackage`\nfiles for both .NET 3.X and .NET 4.X, you can download individual packages from\nthe [Google APIs for Unity site](https://developers.google.com/unity/packages).\n\nThe site provides:\n\n- Individual .NET 4.X `.unitypackage` files to import as Asset packages.\n- Individual `.tgz` archives to import using Unity Package Manager.\n\nThis is especially useful when your app uses a single Firebase product, since\nthe individual `.unitypackage` files contain all needed dependencies, and the\n`.tgz` files are listed alongside related `.tgz` files on which they depend.\n\nThis page provides instructions involving Unity Package Manager, so it's a good\nidea to learn about the tool [from the Unity documentation](https://docs.unity3d.com/Manual/Packages.html).\n| **Note:** If you still need to use .NET 3.x, download the entire Firebase SDK as described in [Add Firebase to your Unity project](/docs/unity/setup#add-sdks).\n\nImport Firebase packages as Assets\n\nWhen importing Firebase products from `.unitypackage` files downloaded from\n[Google APIs for Unity site](https://developers.google.com/unity/packages),\nkeep the following in mind:\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and using the Unity Package\n Manager flow.\n\nAfter downloading, to import:\n\n1. In your open Unity project, navigate to **Assets** \\\u003e **Import Package** \\\u003e\n **Custom Package**.\n\n2. In the *Import Unity Package* window, click **Import**.\n\nImport Firebase packages using Unity Package Manager\n\nWhen importing Firebase products from `.tgz` files downloaded from the [Google APIs for Unity archive](https://developers.google.com/unity/archive), keep the following in mind:\n\n- This method is only available in 2018.3+.\n\n- If you are using multiple Firebase products in your project, you must download\n and upgrade all Firebase products to the same version.\n\n- Do not mix import methods in one project. That is, do not import\n Firebase products with the Asset package flow and with the Unity Package Manager\n flow.\n\n- Dependencies for each product `.tgz` file are linked alongside in their own\n `.tgz` files. You must download and import the product `.tgz` file and\n dependency `.tgz` files, in the correct order:\n\n 1. External Dependency Manager (`com.google.external-dependency-manager`)\n 2. Firebase Core (`com.google.firebase.app`)\n 3. Firebase products used in your project. If you use Realtime Database or Cloud Storage, import Authentication (`com.google.firebase.auth`) first.\n\nAfter downloading, import `.tgz` files into your project using one of the\nfollowing methods: \n\nPackage Manager UI\n\n1. Open Unity's Package Manager window.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from tarball` to open the file browser.\n3. Select the desired tarball in the file browser.\n\nSome older versions of Unity 2019 do not support adding tarballs directly.\nIn this case, you will need to:\n\n1. Unzip the `.tgz` file.\n2. Click the `+` icon in the top-left corner of the Package Manager window and select `Add package from disk` to open the file browser.\n3. Select the extracted folder in the file browser.\n\nmanifest.json\n\n1. Create a new folder next to your project's `Packages` folder and name it `GooglePackages`.\n2. Place the `.tgz` files into that folder.\n3. Use a text editor to open `Packages/manifest.json` under your Unity project folder.\n4. Add an entry for each package you want to import, mapping the package name\n to the location on disk. Be sure to append `file:` to the `.tgz` file path. For\n example, if you were importing `com.google.firebase.storage` and its\n dependency's, your `manifest.json` would look like this:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0.tgz\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz\",\n // com.unity package entries...\n }\n }\n\n5. Save the `manifest.json` file.\n\n6. When Unity regains focus it will reload the `manifest.json` and import the\n newly-added packages.\n\nSome older versions of Unity do not support `.tgz` files in the `manifest.json`.\nIn this case, you should:\n\n1. Unzip the `.tgz` file.\n2. Edit your `manifest.json` to use the path to the extracted folder, instead\n of the `.tgz` file, like so:\n\n {\n \"dependencies\": {\n \"com.google.external-dependency-manager\": \"file:../GooglePackages/com.google.external-dependency-manager-1.2.164\",\n \"com.google.firebase.app\": \"file:../GooglePackages/com.google.firebase.app-7.1.0\",\n \"com.google.firebase.auth\": \"file:../GooglePackages/com.google.firebase.auth-7.1.0\",\n \"com.google.firebase.storage\": \"file:../GooglePackages/com.google.firebase.storage-7.1.0\",\n // com.unity package entries...\n }\n }\n\nMigrate from Unity Package Manager to Asset packages\n\nIn some cases, you might want to switch from using Unity Package Manager to\ntrack Firebase products, to importing products under the `Assets` folder.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase`, your project used Unity Package Manager for\nimport.\n\nTo migrate to Asset packages:\n\n1. Note current Firebase package versions in your project and remove them.\n\n 1. From the **Window** menu, select **Package Manager** . In the *Package\n Manager* window, make sure \"Packages: In Project\" is selected.\n 2. Note the versions of imported Firebase packages.\n 3. Click on each package name, then click **Remove** . Be sure to remove the External Dependency Manager package (`.com.google.external-dependency-manager`) as well as Firebase packages.\n2. Download and import replacement `.unitypackage` files. You have two options:\n\n - If you can upgrade to the latest version of each package, download the Firebase Unity SDK zip file and import as described in [Add Firebase to\n your Unity project](/docs/unity/setup#add-sdks).\n - If you need to preserve current `.unitypackage` versions, you can download and import individual packages as described [above](#alternative_individual_unitypackages) on this page.\n\nMigrate from Asset packages to Unity Package Manager\n\nIn some cases, you might want to switch from importing products under the\n`Assets` folder to importing and tracking products with Unity Package Manager.\n\nIf you're not sure which import method you're using, in your Unity project\nfolder, open the file `Packages/manifest.json`. If the file contains entries\nstarting with `com.google.firebase` your project is already using Unity Package\nManager for import.\n\nTo migrate to Unity Package Manager:\n\n1. Make sure all Firebase packages and the External Dependency Manager package\n are removed from the `Assets` folder, using either of the following methods.\n\n EDM4U UI\n\n\n 1. In your open Unity project, navigate to **Assets \\\u003e External\n Dependency Manager \\\u003e Version Handler \\\u003e Uninstall Managed\n Packages**.\n 2. Select all Firebase packages and External Dependency Manager.\n 3. Click **Uninstall Selected Package**.\n\n \u003cbr /\u003e\n\n Manual removal\n\n Using file system tools, manually delete the following folders:\n - `Assets/Editor Default Resources/Firebase`\n - `Assets/ExternalDependencyManager`\n - `Assets/Firebase`\n - `Assets/Parse`\n - `Assets/Plugins/iOS/Firebase`\n2. Import packages using Unity Package Manager, as described [above](#alternative_unity_package_manager)\n on this page."]]
