ローカルフォルダまたは .tgz ファイルのパス

依存関係は、 パッケージを含む任意のローカルフォルダーか .tgz ファイルで指定できます。この機能は、 ローカルでのオフライン開発とテストに役立ちます。

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 ウィンドウを使用する場合は、以下のページに従ってください。

• ローカルフォルダーからのパッケージのインストール
• ローカルの .tgz ファイルからのパッケージのインストール

パス参照は常に 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 フォルダー (プロジェクトマニフェストのルートフォルダー) からの相対パスを使用できます。つまり、2 つのドット (..) が前に付いたパスは、プロジェクトパスのルートを示します。例えば、../another_folder は Packages フォルダーの兄弟です。

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