Unity Package Manager は Unity 公式のパッケージ管理システムであり、以下の特長があります。
Package Manager を使用して、プロジェクト依存関係の定義、パッケージ依存関係の解決、パッケージのダウンロードと追加、プロジェクトのコンテンツ統合を行うことができます。
パッケージの概念や、Unity Package Manager のしくみに関する一般的な情報は、Unity Package Manager のドキュメントを参照してください。
パッケージは以下を含むことができます。
ノート: Package Manager はパッケージのストリーミングアセットをサポートしていません。Addressables パッケージを代わりに使用してください。
パッケージの名前、バージョン、依存関係リスト、リポジトリへの URL などの情報を含む パッケージマニフェスト ファイルも各パッケージに含まれています。
新しいパッケージを作成する手順は以下の通りです。
以下のいずれかの方法で、パッケージの空のシェルを作成します。
フォルダー構造のレイアウトが、Unity パッケージの パッケージレイアウト規則 に準じていることを確認します。例えば、エディターとランタイムのライブラリがある場合は、エディターライブラリは Editor フォルダー、ランタイムライブラリは Runtime フォルダーに格納されていることを確認します。
パッケージにコードが含まれている場合は、作成したパッケージレイアウトに必要なアセンブリ定義ファイルがあることを確認します。アセンブリ定義ファイルの作成と定義については、アセンブリ定義とパッケージ を参照してください。詳細については、アセンブリ定義 を参照してください。
ノート: アセンブリ定義ファイルの追加後にコンソールウィンドウに警告が表示された場合は、プロジェクトを保存して閉じてから再度開きます。
パッケージに必要なツール、ライブラリ、アセットを加えます。
パッケージに テスト を加えます。テストは、パッケージがさまざまなシナリオで期待通りに機能するために不可欠です。
Tests/Editor に書き込みます。Tests/Runtime に書き込みます。パッケージのサンプルがある場合は、サンプルを 適切な samples サブフォルダ に追加します。
ノート: パッケージにはサンプルのみを加えることができますが、同じレイアウトと JSON 構造を使用して、ツールやテンプレートのパッケージの一部としてサンプルを加えることもできます。
新しいバージョンを公開するたびに CHANGELOG.md ファイルを更新できます。すべての新機能やバグ修正は、このファイルに記録されます。選択した changelog 形式の詳細については、Keep a Changelog のドキュメントを参照してください。
このステップは、共有しないパッケージの場合には任意ですが、ユーザーが自分のニーズに最適なバージョンを判断できるようにするために、共有するパッケージの場合には強く推奨されています。
ヒント: このパッケージの変更ログをホストする外部ウェブページへのリンクを提供するには、パッケージの package.json マニフェストファイルで changelogUrl プロパティを設定します。
LICENSE.md ファイルと THIRD PARTY NOTICES.md ファイルに ライセンスとサードパーティ の通知を加えることができます。
このステップは、共有しないパッケージの場合には任意ですが、ユーザーによるパッケージの誤用やサードパーティライセンスの違反ことを防ぐために、共有するパッケージの場合には強く推奨されています。
ヒント: このパッケージのライセンスとサードパーティに関する通知をホストする外部ウェブページへのリンクを提供するには、パッケージの package.json マニフェストファイルで licensesUrl プロパティを設定します。
パッケージの ドキュメントを作成 します。
ヒント: このパッケージのドキュメントをホストする外部ウェブページへのリンクを提供するには、パッケージの package.json マニフェストファイルで documentationUrl プロパティを設定します。
パッケージを 共有 します。
Project フォルダー内 にカスタムパッケージを作成する手順は以下のとおりです。
ノート: この手順は、カスタムパッケージを作成 するための広範な手順の一部です。
Unity Hub を開き、コンピューターに 空のプロジェクトを作成 します。
コンピューターで既存のプロジェクトを使用して、パッケージをプロジェクトに埋め込む か、ローカルフォルダーからパッケージをインストールする こともできます。ただし、新しいプロジェクトとして開始するほうが、パッケージコンテンツのエラーが発生しにくくなります。
コンピューターのファイルマネージャー (Windows のエクスプローラーや macOS の Finder など) を使用して、プロジェクトフォルダーに移動して、Packages サブフォルダーを見つけます。
命名規則 に従い、パッケージ名 と一致する名前で、パッケージ用の新しいサブディレクトリを Packages フォルダーの中に作成します。例えば、パッケージ名が com.example.mypackage の場合、com.example.mypackage というサブディレクトリを作成します。
ノート: これは、パッケージにアセットが含まれている場合に特に重要です。なぜなら、AssetDatabase は実際のフォルダー名に関係なく Packages/<your-package-name>/Assets に一致するアセットパスを検索するからです。
任意のテキストエディターを開いて、パッケージフォルダーのルートに package.json という JSON ファイルを作成します。
package.json ファイルのすべての 必須フィールドと推奨フィールド に入力します。パッケージマニフェスト例 をリファレンスとして使用できます。
Unity を再度開くと、新しいパッケージが Package Manager ウィンドウ と Project ウィンドウに表示されますので、そこでパッケージのコンテンツの表示や変更を行うことができます。Project ウィンドウで package.json ファイルを選択した場合は、Inspector ウィンドウでその JSON の値を直接変更することもできます。
メイン手順 に戻り、パッケージの作成を完了します。
Project フォルダーの外にカスタムパッケージを作成する手順は以下のとおりです。
ノート: この手順は、カスタムパッケージを作成 するための広範な手順の一部です。
コンピューターのファイルマネージャー (Windows のエクスプローラーや macOS の Finder など) を使用して、パッケージ用のフォルダーを作成します。
パッケージのコンテンツをすでに作成している場合は、既存の場所を使用することもできます。
任意のテキストエディターを開いて、パッケージフォルダーのルートに package.json という JSON ファイルを作成します。
package.json ファイルのすべての 必須フィールドと推奨フィールド に入力し、name プロパティが 命名規則 に従っていることを確認します。パッケージマニフェスト例 をリファレンスとして使用できます。
Unity で新しいプロジェクトを作成するか、既存のプロジェクトを開きます。
Package Manager ウィンドウ を開きます。先ほど作成した package.json ファイルを使用して、ローカルパッケージをインストールする 手順に従います。このステップは、必要な .meta ファイルを確実に作成するために不可欠です。
新しいパッケージが Package Manager ウィンドウと Project ウィンドウに表示されますので、そこでパッケージのコンテンツの表示や変更を行うことができます。Project ウィンドウで package.json ファイルを選択した場合は、Inspector ウィンドウでその JSON の値を直接変更することもできます。
メイン手順 に戻り、パッケージの作成を完了します。