Version: 2021.2
Project manifest
Git dependencies

Embedded dependencies

Any package that appears under your project’s Packages folder is embedded in that project. You can embed packages in several ways:

Embedded packages do not need to appear in the project manifestEach Unity project has a project manifest, which acts as an entry point for the Package Manager. This file must be available in the <project>/Packages directory. The Package Manager uses it to configure many things, including a list of dependencies for that project, as well as any package repository to query for packages. More info
See in Glossary
as a dependencyIn the context of the Package Manager, a dependency is a specific package version (expressed in the form package_name@package_version) that a project or another package requires in order to work. Projects and packages use the dependencies attribute in their manifests to define the set of packages they require. For projects, these are considered direct dependencies; for packages, these are indirect, or transitive, dependencies. More info
See in Glossary
; however, if you embedded a version of an installed package, your project manifest still lists the dependency on the original installed version. In that case, the package on disk takes priority over the version of the package listed as a dependency, so it does not need to be removed from the project manifest. For example, if the project manifest specifies a dependency on version 1.3.1 of the com.unity.example package but the project also has an embedded package
See in Glossary
with that name, the Package Manager uses the embedded package, regardless of its apparent version, instead of downloading version 1.3.1 from the registry.

Make sure you track the contents of your embedded packages, and any changes you make to it. If your Unity project is under source control, add any packages embedded in that project to the same source control.

Creating a new custom package

To embed a new package, create your new package content inside a folder under the Packages folder. For more information, follow the instructions for creating your own custom package.

Typically, your new package remains embedded in your project until you are ready to share it with other users and test it in other projects. Then you can publish it to a scoped package registry.

Copying a Unity package from the cache

The most reliable way to find your package’s folder in the cache is to locate the installed version directly in the Unity Editor:

  1. From the Project view, find the installed package you want to embed.

  2. Right-click to open the context menu and select Show in Explorer (Windows) or Reveal in Finder (macOS). That package’s folder opens directly in a file browser and uses the <package-name>@<package-version> naming convention.

    File browser opened to the package folder under the projects package cache
    File browser opened to the package folder under the project’s package cache

    Tip: Alternately, you can open your project’s package cache (<project>/Library/PackageCache) directly in your file browser or command line and navigate to the correct folder, but it’s more reliable to let the Editor find it for you, because in addition to locating packages in the project cache, it also locates packages that are installed from a local folder or tarball, and packages that are already embedded.

  3. Copy the package folder and paste it directly in your project’s Packages folder. Don’t put it inside the Assets folder, because the Package Manager does not scan that folder for packages.

  4. Remove the @<package-version> portion of the folder name.

  5. Add the newly embedded package to source control if your project is already under source control.

Note: You can also find package folders under the global cache, but the global cache contains packages from all versions of the Unity Editor that have ever been installed on your system, so be careful to pick a version that is compatible with your project’s Editor version.

Project manifest
Git dependencies