Version: 2023.1
Git 依赖关系
故障排除

本地文件夹或 tarball 路径

您可以将某个依赖项指定为包含某个包的任何本地文件夹或 tarball 文件。此功能对本地脱机开发和测试很有帮助。

Note: If you want to reference a package on the local file system as a Git dependency, use the file://<url> format instead. Unity doesn’t support directly referencing a locally accessible Git repository with a file path. For more information on the file://<url> format, refer to Git dependencies.

本节介绍如何使用项目清单来设置本地依赖项。如果想改用 Package Manager 窗口,请按照以下页面上的说明进行操作:

路径引用始终以 file: 前缀开头,并且使用正斜杠 (/) 作为路径分隔符。

Note: On Windows, you can also use backslashes (\), but only if you escape each one (for example, "file:..\\github\\my_package_folder" or "file:C:\\Users\\my_username\\github\\my_package_folder"). These paths aren’t as easy to read as the forward slashes, they’re prone to typing errors, and you can’t use them anywhere but on a Windows machine. For these reasons, using forward slashes is preferable.

您可以使用绝对路径,也可以使用相对于项目的 Packages 文件夹(即项目清单的根文件夹)的路径。换句话说,以两个点 (..) 开头的路径是指项目路径的根目录,如 ../another_folderPackages 文件夹的同级文件夹。

Tip: Relative paths with forward-slashes offer better portability across different machines and operating systems when tracking a project and packages in the same repository.

For Windows absolute paths, the drive letter and its colon (usually C:) follows the file: prefix but is otherwise the same as Linux or macOS paths.

相对路径示例

After the file: prefix, the path is a standard relative path. In the following example:

  • The project’s Packages folder is C:\Users\my_username\Projects\my_project\Packages.
  • The Projects, github, and Downloads folders are peer folders.
  • my_package_c is an embedded package (a package whose folder was copied into the Packages folder, to make it mutable).
{
  "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 中的绝对路径示例

After the file: prefix, the path is a standard Portable Operating System Interface (POSIX) path, starting with a forward slash /:

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


Git 依赖关系
故障排除