版本:Unity 6 (6000.0)
语言:英语
项目清单
Git 依赖项

嵌入依赖项

项目 Packages 文件夹下显示的任何包都嵌入到该项目中。您可以通过多种方式创建一个 嵌入包嵌入包是指存储在 Unity 项目根目录的 Packages 目录下的可变包。这与您从包服务器下载并不可变的大多数包不同。更多信息
查看 术语表

嵌入包不需要在 项目清单每个 Unity 项目都有一个项目清单,它充当包管理器的入口点。此文件必须位于 <project>/Packages 目录中。包管理器使用它来配置许多内容,包括该项目的依赖项列表以及要查询包的任何包存储库。更多信息
查看 术语表
中作为依赖项出现。但是,如果您嵌入已安装包的版本,您的项目清单仍会列出对原始安装版本的依赖项。在这种情况下,磁盘上的包优先于列为依赖项的包版本,因此不需要从项目清单中删除它。例如,如果项目清单指定对 com.unity.example 包的 1.3.1 版本的依赖项,但项目也包含一个同名嵌入包,则包管理器会使用嵌入包(无论其明显版本如何),而不是从注册表下载 1.3.1 版本。

确保跟踪嵌入包的内容以及对它进行的任何更改。如果您的 Unity 项目在源代码管理下,请将嵌入到该项目的任何包添加到相同的源代码管理中。

创建新的自定义包

要嵌入新包,请在 Packages 文件夹下的文件夹内创建您的新包内容。有关更多信息,请遵循 创建您自己的自定义包的说明

通常,您的新包会保留在您的项目中,直到您准备将其与其他用户共享并在其他项目中测试它。然后,您可以将其发布到 作用域包注册表

从缓存复制 Unity 包

从注册表安装的包是 不可变的您不能更改不可变(只读)包的内容。这与可变相反。大多数包都是不可变的,包括从包注册表或通过 Git URL 下载的包。
查看 术语表
,这意味着您无法编辑它。如果您想编辑一个包,您可以通过将其复制到您的 Projects 文件夹中使其变得 可变的您可以更改可变包的内容。这与不可变相反。只有本地包嵌入包是可变的。
查看 术语表
。这种包类型称为嵌入包,它会覆盖您的包缓存中的内容。之后,您可以从 Project 文件夹中删除嵌入包的文件夹,包管理器会自动切换到不可变的缓存包。

在缓存中找到您的包文件夹最可靠的方法是直接在 Unity 编辑器中找到安装的版本

  1. 通过打开窗口菜单并选择常规>项目打开项目窗口。

  2. 项目窗口显示 Assets 文件夹内容的窗口(项目选项卡)更多信息
    查看 术语表
    中找到要嵌入的已安装包。

  3. 右键单击所选包的文件夹,然后选择在资源管理器中显示(Windows)或在 Finder 中显示(macOS)。该包的文件夹将在文件浏览器中直接打开,并使用 <package-name> 命名约定。

    注意:如果您要嵌入的包不在您的项目中,您可以使用文件浏览器或命令行直接从项目的包缓存(<project>/Library/PackageCache)中获取它,并导航到正确的文件夹。但是,让编辑器为您找到它更可靠,因为除了在项目缓存中定位包外,它还会定位从本地文件夹或 tarball 安装的包,以及已嵌入的包。

    File browser opened to the package folder under the projects package cache
    打开到项目包缓存下包文件夹的文件浏览器
  4. 复制包文件夹并将其直接粘贴到项目的 Packages 文件夹中。不要将其放在 Assets 文件夹内,因为包管理器不会扫描该文件夹以查找包。

  5. 如果您的项目已经在源代码管理下,请将新嵌入的包添加到源代码管理中。

如果您要删除嵌入包,请使用文件浏览器或命令行在您的 Packages 文件夹中找到该包。考虑备份嵌入包的文件夹,否则您将丢失对包所做的任何更改。然后,从 Packages 文件夹中删除该包的文件夹。包管理器将自动恢复到不可变的缓存包。

其他资源

项目清单
Git 依赖项