Additional Unity installation options

Rather than downloading a large.zip file containing all.unitypackagefiles for both .NET 3.X and .NET 4.X, you can download individual packages fromtheGoogle APIs for Unity site.

The site provides:

  • Individual .NET 4.X.unitypackage files to import as Asset packages.
  • Individual.tgz archives to import using Unity Package Manager.

This is especially useful when your app uses a single Firebase product, sincethe individual.unitypackage files contain all needed dependencies, and the.tgz files are listed alongside related.tgz files on which they depend.

This page provides instructions involving Unity Package Manager, so it's a goodidea to learn about the toolfrom the Unity documentation.

Note: If you still need to use .NET 3.x, download the entire Firebase SDK asdescribed inAdd Firebase to your Unity project.

Import Firebase packages as Assets

When importing Firebase products from.unitypackage files downloaded fromGoogle APIs for Unity site,keep the following in mind:

  • If you are using multiple Firebase products in your project, you must downloadand upgrade all Firebase products to the same version.

  • Do not mix import methods in one project. That is, do not importFirebase products with the Asset package flow and using the Unity PackageManager flow.

After downloading, to import:

  1. In your open Unity project, navigate toAssets >Import Package >Custom Package.

  2. In theImport Unity Package window, clickImport.

Import Firebase packages using Unity Package Manager

When importing Firebase products from.tgz files downloaded from theGoogle APIs for Unity archive, keep the following in mind:

  • This method is only available in 2018.3+.

  • If you are using multiple Firebase products in your project, you must downloadand upgrade all Firebase products to the same version.

  • Do not mix import methods in one project. That is, do not importFirebase products with the Asset package flow and with the Unity Package Managerflow.

  • Dependencies for each product.tgz file are linked alongside in their own.tgz files. You must download and import the product.tgz file anddependency.tgz files, in the correct order:

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Firebase products used in your project. If you useRealtime Database orCloud Storage, importAuthentication (com.google.firebase.auth) first.

After downloading, import.tgz files into your project using one of thefollowing methods:

Package Manager UI

  1. Open Unity's Package Manager window.
  2. Click the+ icon in the top-left corner of the Package Manager window andselectAdd package from tarball to open the file browser.
  3. Select the desired tarball in the file browser.

Some older versions of Unity 2019 do not support adding tarballs directly.In this case, you will need to:

  1. Unzip the.tgz file.
  2. Click the+ icon in the top-left corner of the Package Managerwindow and selectAdd package from disk to open the file browser.
  3. Select the extracted folder in the file browser.

manifest.json

  1. Create a new folder next to your project'sPackages folder and name itGooglePackages.
  2. Place the.tgz files into that folder.
  3. Use a text editor to openPackages/manifest.json under your Unity projectfolder.
  4. Add an entry for each package you want to import, mapping the package nameto the location on disk. Be sure to appendfile: to the.tgz file path. Forexample, if you were importingcom.google.firebase.storage and itsdependency's, yourmanifest.json would look like this:

    {"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. Save themanifest.json file.

  6. When Unity regains focus it will reload themanifest.json and import thenewly-added packages.

Some older versions of Unity do not support.tgz files in themanifest.json.In this case, you should:

  1. Unzip the.tgz file.
  2. Edit yourmanifest.json to use the path to the extracted folder, insteadof the.tgz file, like so:

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

Migrate from Unity Package Manager to Asset packages

In some cases, you might want to switch from using Unity Package Manager totrack Firebase products, to importing products under theAssets folder.

If you're not sure which import method you're using, in your Unity projectfolder, open the filePackages/manifest.json. If the file contains entriesstarting withcom.google.firebase, your project used Unity Package Manager forimport.

To migrate to Asset packages:

  1. Note current Firebase package versions in your project and remove them.

    1. From theWindow menu, selectPackage Manager. In thePackageManager window, make sure "Packages: In Project" is selected.
    2. Note the versions of imported Firebase packages.
    3. Click on each package name, then clickRemove. Be sure to remove theExternal Dependency Manager package (.com.google.external-dependency-manager)as well as Firebase packages.
  2. Download and import replacement.unitypackage files. You have two options:

    • If you can upgrade to the latest version of each package, download theFirebase Unity SDK zip file and import as described inAdd Firebase toyour Unity project.
    • If you need to preserve current.unitypackage versions, you can downloadand import individual packages as describedaboveon this page.

Migrate from Asset packages to Unity Package Manager

In some cases, you might want to switch from importing products under theAssets folder to importing and tracking products with Unity Package Manager.

If you're not sure which import method you're using, in your Unity projectfolder, open the filePackages/manifest.json. If the file contains entriesstarting withcom.google.firebase your project is already using Unity PackageManager for import.

To migrate to Unity Package Manager:

  1. Make sure all Firebase packages and the External Dependency Manager packageare removed from theAssets folder, using either of the following methods.

    EDM4U UI

    1. In your open Unity project, navigate toAssets > External Dependency Manager > Version Handler > Uninstall Managed Packages.
    2. Select all Firebase packages and External Dependency Manager.
    3. ClickUninstall Selected Package.

    Manual removal

    Using file system tools, manually delete the following folders:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. Import packages using Unity Package Manager, as describedaboveon this page.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-18 UTC.