埋め込みの依存関係

プロジェクトの Packages フォルダーの下に表示されるパッケージはすべて、そのプロジェクトに埋め込まれます。パッケージを埋め込むにはいくつかの方法があります。

• 新しいパッケージ を、プロジェクトの Packages フォルダーに直接作成します。
• プロジェクトのパッケージキャッシュから Packages フォルダーに Unity パッケージを手動でコピー します。
• C#スクリプトを使用 して、すでにインストールされているパッケージのバージョンを埋め込むことができます。

埋め込みパッケージは、プロジェクトマニフェストに依存関係として表示される必要はありません。ただし、インストールしたパッケージのバージョンを埋め込んだ場合は、プロジェクトマニフェストに元のインストールしたバージョンの依存関係が表示されます。その場合、ディスク上のパッケージが、依存関係としてリストされているパッケージのバージョンよりも優先されます。そのため、プロジェクトマニフェストから削除する必要はありません。例えば、プロジェクトマニフェストが com.unity.example パッケージのバージョン 1.3.1 の依存関係を指定している場合に、プロジェクトにもその名前の埋め込みパッケージがあると、Package Manager は見かけのバージョンに関係なく、レジストリからバージョン 1.3.1 をダウンロードする代わりに、埋め込まれたパッケージを使います。

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

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

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

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

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

キャッシュ内のパッケージのフォルダーを見つける最も確実な方法は、インストールされたバージョンを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. パッケージフォルダーをコピーして、プロジェクトの Packages フォルダーに直接貼り付けてください。Package Manager は Assets フォルダー内を探さないので、Assets フォルダーの中にはパッケージフォルダーを入れないでください。

5. フォルダー名の @<package-version> 部分を削除します。

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

ノート: グローバルキャッシュ の下にもパッケージフォルダーがありますが、グローバルキャッシュには、これまでにシステムにインストールされた Unity エディターのすべてのバージョンのパッケージが含まれています。ですから、プロジェクトのエディターバージョンと互換性のあるバージョンを選択するよう注意してください。