本地文件夹或 tarball 路径

您可以将依赖项指定为包含包的任何本地文件夹或 tarball。此功能有助于本地离线开发和测试。

注意：如果要将本地文件系统上的包作为 Git 依赖项引用，请使用file://<url>format 代替。Unity 不支持使用文件路径直接引用本地可访问的 Git 存储库。有关file://<url>格式，请参阅Git 依赖项包管理器直接从 Git 存储库中检索 Git 依赖项，而不是从包注册表中检索 Git 依赖项。Git 依赖项使用 Git URL 引用而不是版本，并且无法保证包的质量、稳定性、有效性，甚至无法保证其package.json文件遵循有关此包的正式发布版本的语义版本控制规则。更多信息
请参阅术语表.

本节介绍如何使用项目清单每个 Unity 项目都有一个项目清单，用作包管理器的入口点。此文件必须在<project>/Packages目录。包管理器使用它来配置许多内容，包括该项目的依赖项列表，以及要查询包的任何包存储库。更多信息
请参阅术语表以设置本地依赖项。如果要改用“包管理器”窗口，请按照以下页面上的说明进行作：

• 从本地文件夹安装包
• 从本地 tarball 文件安装包

路径引用始终以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:prefix，则路径是标准相对路径。在以下示例中：

• 项目的Packages文件夹是C:\Users\my_username\Projects\my_project\Packages.
• 这Projects,github和Downloads文件夹是对等文件夹。
• my_package_c是一个嵌入式包嵌入式包是存储在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"
  }
}

Linux 或 macOS 中的绝对路径示例

之后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"
  }
}

Windows 中的绝对路径示例

请注意，驱动器号紧跟在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"
  }
}