埋め込みの依存関係

Any package that appears under your project’s Packages folder is embedded in that project. You can create an embedded package in several ways:

• 新しいパッケージ を、プロジェクトの Packages フォルダーに直接作成します。
• Manually copy a Unity package from the project’s package cache into your project’s Packages folder.
• C#スクリプトを使用 して、すでにインストールされているパッケージのバージョンを埋め込むことができます。

Embedded packages don’t need to appear in the project manifest as a dependency. However, if you embedded a version of an installed package, your project manifest still lists the dependency on the original installed version. In that case, the package on disk takes priority over the version of the package listed as a dependency, so it doesn’t need to be removed from the project manifest. For example, if the project manifest specifies a dependency on version 1.3.1 of the com.unity.example package but the project also has an embedded package with that name, the Package Manager uses the embedded package, regardless of its apparent version, instead of downloading version 1.3.1 from the registry.

埋め込まれたパッケージのコンテンツとそれに加えた変更を追跡することを忘れないでください。Unity プロジェクトがソース管理下にある場合は、そのプロジェクトに埋め込まれたパッケージも同じソース管理下に加える必要があります。

新しいカスタムパッケージの作成

新しいパッケージを埋め込むには、Packages フォルダーの下の フォルダー内に新しいパッケージコンテンツを作成します。詳しくは、独自のカスタムパッケージを作成する方法 を参照してください。

通常、新しいパッケージは、他のユーザーと共有したり、他のプロジェクトでテストする準備ができるまで、プロジェクトに組み込まれたままになっています。その後、スコープ付きのパッケージレジストリ に公開できます。

Unity のパッケージをキャッシュからコピーする

A package installed from a registry is immutable, which means you can’t edit it. If you want to edit a package, you can make it mutable by copying it to your Projects folder. This package type is called an embedded package, and it overrides what’s in your package cache. Later, you can delete that embedded package’s folder from the Project folder, and the Package Manager will automatically change to the immutable, cached package.

キャッシュ内のパッケージのフォルダーを見つける最も確実な方法は、インストールされたバージョンをUnity エディターで直接見つけることです。

1. Open the Project window by opening the Window menu and selecting General > Project.

2. From the Project window, find the installed package you want to embed.

3. Right-click the folder of the selected package and select Show in Explorer (Windows) or Reveal in Finder (macOS). That package’s folder opens directly in a file browser and uses the <package-name>@<package-version> naming convention.

   Note: If the package you want to embed isn’t in your project, you can get it directly from your project’s package cache (<project>/Library/PackageCache) by using your file browser or command line and navigating to the correct folder. However, it’s more reliable to let the Editor find it for you, because in addition to locating packages in the project cache, it also locates packages that are installed from a local folder or tarball, and packages that are already embedded.

   

4. Copy the package folder and paste it directly into your project’s Packages folder. Don’t put it inside the Assets folder, because the Package Manager doesn’t scan that folder for packages.

5. Remove the @<package-version> part of the folder name.

6. Add the newly embedded package to source control if your project is already under source control.

Note: You can also find package folders under the global cache, but the global cache contains packages from all versions of the Unity Editor that have ever been installed on your system, so be careful to pick a version that’s compatible with your project’s Editor version.

If you want to delete the embedded package, use your file browser or command line to locate that package in your Packages folder. Consider backing up the folder for the embedded package, otherwise you’ll lose any changes you made to the package. Then, delete the folder for that package from your Packages folder. The Package Manager will automatically revert to the immutable, cached package.

その他の参考資料

• Use a script to embed a package in your project