埋め込みの依存関係

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 フォルダーに直接作成します。
• プロジェクトのパッケージキャッシュから Packages フォルダーに Unity パッケージを手動でコピー します。
• 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. Windowメニューを開き、General > Project を選択して Project ウィンドウを開きます。

2. Project ウィンドウから、埋め込みたいインストール済みパッケージを探します。

3. 選択したパッケージのフォルダーを右クリックし、Show in Explorer (Windows) または Reveal in Finder (macOS) を選択します。そのパッケージのフォルダーはファイルブラウザーで直接開き、<package-name>@<package-version> の命名規則を使用します。

   ノート: もし埋め込みたいパッケージがプロジェクトにない場合、ファイルブラウザーやコマンドラインを使ってプロジェクトのパッケージキャッシュ (<project>/Library/PackageCache) から直接取得し、正しいフォルダーに移動することができます。ただし、プロジェクトキャッシュ内のパッケージを検索するだけでなく、ローカルフォルダー、tarball からインストールされたパッケージ、すでに埋め込まれているパッケージも検索するため、エディターに検索させるほうがより確実です。

   

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. プロジェクトがすでにソース管理下にある場合は、新しく埋め込んだパッケージをソース管理下に加えます。

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