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

• Unity が素早く簡単に新しい機能を配布し、既存の機能を更新できるようにします。
• ユーザーが再利用可能なコンポーネントを見つけて共有するためのプラットフォームを提供します。
• 拡張可能なオープンプラットフォームとして Unity の機能を増進します。

概要

• C# スクリプト
• アセンブリ
• ネイティブプラグイン
• モデル、テクスチャ、アニメーション、オーディオクリップ、その他のアセット

手順

1. 以下のいずれかの方法で、パッケージの空のシェルを作成します。
   • 埋め込みパッケージの設定。
   • ローカルパッケージの設定。
2. フォルダー構造のレイアウトが、Unity パッケージの パッケージレイアウト規則 に準じていることを確認します。例えば、エディターとランタイムのライブラリがある場合は、エディターライブラリは

   Editor

   フォルダー、ランタイムライブラリは

   Runtime

   フォルダーに格納されていることを確認します。
3. パッケージにコードが含まれている場合は、作成したパッケージレイアウトに必要なアセンブリ定義ファイルがあることを確認します。アセンブリ定義ファイルの作成と定義については、アセンブリ定義とパッケージ を参照してください。詳細については、アセンブリ定義 を参照してください。
   ノート: アセンブリ定義ファイルの追加後にコンソールウィンドウに警告が表示された場合は、プロジェクトを保存して閉じてから再度開きます。
4. パッケージに必要なツール、ライブラリ、アセットを加えます。
5. パッケージに テスト を加えます。テストは、パッケージがさまざまなシナリオで期待通りに機能するために不可欠です。
   • すべてのエディターテストを

     Tests/Editor

     に書き込みます。
   • すべての再生モードテストを

     Tests/Runtime

     に書き込みます。
6. パッケージのサンプルがある場合は、サンプルを 適切な samples サブフォルダ に追加します。
   ノート: パッケージにはサンプルのみを加えることができますが、同じレイアウトと JSON 構造を使用して、ツールやテンプレートのパッケージの一部としてサンプルを加えることもできます。
7. 新しいバージョンを公開するたびに

   CHANGELOG.md

   ファイルを更新できます。すべての新機能やバグ修正は、このファイルに記録されます。選択した changelog 形式の詳細については、Keep a Changelog のドキュメントを参照してください。
   このステップは、共有しないパッケージの場合には任意ですが、ユーザーが自分のニーズに最適なバージョンを判断できるようにするために、共有するパッケージの場合には強く推奨されています。
   ヒント: このパッケージの変更ログをホストする外部ウェブページへのリンクを提供するには、パッケージの

   package.json

   マニフェストファイルで changelogUrl プロパティを設定します。

8. LICENSE.md

   ファイルと

   THIRD PARTY NOTICES.md

   ファイルに ライセンスとサードパーティ の通知を加えることができます。
   このステップは、共有しないパッケージの場合には任意ですが、ユーザーによるパッケージの誤用やサードパーティライセンスの違反ことを防ぐために、共有するパッケージの場合には強く推奨されています。
   ヒント: このパッケージのライセンスとサードパーティに関する通知をホストする外部ウェブページへのリンクを提供するには、パッケージの

   package.json

   マニフェストファイルで licensesUrl プロパティを設定します。
9. パッケージの ドキュメントを作成 します。
   ヒント: このパッケージのドキュメントをホストする外部ウェブページへのリンクを提供するには、パッケージの

   package.json

   マニフェストファイルで documentationUrl プロパティを設定します。
10. パッケージを 共有 します。

新しい埋め込みパッケージの作成

1. Unity Hub を開き、コンピューターに 空のプロジェクトを作成 します。
   コンピューターで既存のプロジェクトを使用して、パッケージをプロジェクトに埋め込む か、ローカルフォルダーからパッケージをインストールする こともできます。ただし、新しいプロジェクトとして開始するほうが、パッケージコンテンツのエラーが発生しにくくなります。
2. コンピューターのファイルマネージャー (Windows のエクスプローラーや macOS の Finder など) を使用して、プロジェクトフォルダーに移動して、

   Packages

   サブフォルダーを見つけます。
3. 命名規則 に従い、パッケージ名 と一致する名前で、パッケージ用の新しいサブディレクトリを

   Packages

   フォルダーの中に作成します。例えば、パッケージ名が

   com.example.mypackage

   の場合、

   com.example.mypackage

   というサブディレクトリを作成します。
   ノート: これは、パッケージにアセットが含まれている場合に特に重要です。なぜなら、AssetDatabase は実際のフォルダー名に関係なく

   Packages/<your-package-name>/Assets

   に一致するアセットパスを検索するからです。
4. 任意のテキストエディターを開いて、パッケージフォルダーのルートに

   package.json

   という JSON ファイルを作成します。

5. package.json

   ファイルのすべての 必須フィールドと推奨フィールド に入力します。パッケージマニフェスト例 をリファレンスとして使用できます。

package.json

新しいローカルパッケージの作成

1. コンピューターのファイルマネージャー (Windows のエクスプローラーや macOS の Finder など) を使用して、パッケージ用のフォルダーを作成します。
   パッケージのコンテンツをすでに作成している場合は、既存の場所を使用することもできます。
2. 任意のテキストエディターを開いて、パッケージフォルダーのルートに

   package.json

   という JSON ファイルを作成します。

3. package.json

   ファイルのすべての 必須フィールドと推奨フィールド に入力し、

   name

   プロパティが 命名規則 に従っていることを確認します。パッケージマニフェスト例 をリファレンスとして使用できます。
4. Unity で新しいプロジェクトを作成するか、既存のプロジェクトを開きます。
5. Package Manager ウィンドウ を開きます。先ほど作成した

   package.json

   ファイルを使用して、ローカルパッケージをインストールする 手順に従います。このステップは、必要な

   .meta

   ファイルを確実に作成するために不可欠です。

package.json