您可以将任何包含包的本地文件夹或压缩包指定为依赖项。此功能有助于本地离线开发和测试。
注意:如果您想将本地文件系统上的包作为 Git 依赖项引用,请使用 file://<url>
格式。Unity 不支持直接使用文件路径引用本地可访问的 Git 存储库。有关 file://<url>
格式的更多信息,请参阅 Git 依赖项包管理器直接从 Git 存储库获取 Git 依赖项,而不是从包注册表获取。Git 依赖项使用 Git URL 引用而不是版本,并且无法保证包的质量、稳定性、有效性,甚至无法保证其 package.json
文件中声明的版本是否符合有关此包的正式发布版本的语义版本控制规则。 更多信息
在 术语表 中查看。
本节介绍如何使用 项目清单每个 Unity 项目都包含一个项目清单,它充当包管理器的入口点。该文件必须位于 <project>/Packages
目录中。包管理器使用它来配置许多内容,包括该项目的依赖项列表,以及要查询包的任何包存储库。 更多信息
在 术语表 中查看 来设置本地依赖项。如果您想使用包管理器窗口,请按照以下页面上的说明进行操作。
路径引用始终以 file:
前缀开头,并使用正斜杠 (/
) 作为路径分隔符。
注意:在 Windows 上,您也可以使用反斜杠 (\
),但前提是您必须对每个反斜杠进行转义(例如,"file:..\\github\\my_package_folder"
或 "file:C:\\Users\\my_username\\github\\my_package_folder"
)。这些路径不像正斜杠那样易于阅读,容易出现输入错误,并且只能在 Windows 机器上使用。出于这些原因,建议使用正斜杠。
您可以使用绝对路径或相对于项目的 Packages
文件夹的路径(即项目清单的根文件夹)。换句话说,以两个点 (..
) 开头的路径是指项目路径的根目录,因此 ../another_folder
是 Packages
文件夹的同级文件夹。
提示:当在同一个存储库中跟踪项目和包时,使用正斜杠的相对路径可以在不同的机器和操作系统之间提供更好的可移植性。
对于 Windows 绝对路径,驱动器号及其冒号(通常为 C:
)位于 file:
前缀之后,但在其他方面与 Linux 或 macOS 路径相同。
在 file:
前缀之后,路径是标准的相对路径。在以下示例中
Packages
文件夹为 C:\Users\my_username\Projects\my_project\Packages
。Projects
、github
和 Downloads
文件夹是同级文件夹。my_package_c
是一个 嵌入式包嵌入式包是可以修改的包,您将它们存储在 Unity 项目根目录下的 Packages
目录中。这与您从包服务器下载的大多数包不同,这些包是不可修改的。 更多信息Packages
文件夹中,以使其可修改)。{
"dependencies": {
"my_package_a": "file:../github/my_package_folder",
"my_package_b": "file:../Downloads/my_package_tarball.tgz"
"my_package_c": "file:com.unity.textmeshpro"
}
}
在 file:
前缀之后,路径是标准的便携式操作系统接口 (POSIX) 路径,以正斜杠 /
开头
{
"dependencies": {
"my_package_a": "file:/Users/my_username/github/my_package_folder",
"my_package_b": "file:/Users/my_username/Downloads/my_package_tarball.tgz"
}
}
请注意,驱动器号紧随 file:
前缀
{
"dependencies": {
"my_package_a": "file:C:/Users/my_username/github/my_package_folder",
"my_package_b": "file:C:/Users/my_username/Downloads/my_package_tarball.tgz"
}
}