パッケージマニフェスト

Unity は、パッケージマニフェストファイル (package.json) を使用して、特定のパッケージの特定のバージョンに関する情報を管理します。パッケージマニフェストは常にパッケージのルートにあり、登録名やバージョン番号など、パッケージに関する重要な情報が含まれています。

パッケージマニフェストは、ユーザーと通信するために以下のような有用な情報も定義します。

• UI に表示されるユーザーに分かりやすい名前。
• パッケージの簡単な説明。
• パッケージと互換性のある最も古いバージョンの Unity エディター。

パッケージマニフェストは JSON (JavaScript Object Notation) 構文を使用してパッケージに含まれる内容を記述します。ファイルの形式は npm の package.json 形式と類似していますが、一部のプロパティには異なるセマンティクスが使用されます。サンプルパッケージマニフェストファイルの例を参照してください。

Package Manager はこのマニフェストを読み取り、パッケージのコンテンツ、コンテンツの解凍方法、Package Manager ウィンドウに表示する情報を見つけます。マニフェストはこの情報を一連の必須、推奨、任意の各プロパティに格納します。

必須のプロパティ

これらのプロパティが存在しない場合は、公開されたときにレジストリがパッケージを拒否するか、Package Manager がパッケージを取得またはロードすることができません。

推奨プロパティ

Package Manager は、推奨プロパティが見つからない場合や無効な値である場合でも、プロジェクトにパッケージをインストールできます。

ただし、推奨されるベストプラクティスは、これらのプロパティに値を割り当てて、パッケージを検出可能にし、ユーザーに対してより良好な操作性を実現することです。

任意のプロパティ

これらのプロパティは任意であり、省略することができます。ただし、設定する場合は、有効な値であることが必要です。

パッケージマニフェストの例

{
  "name": "com.[company-name].[package-name]",
  "version": "1.2.3",
  "displayName": "Package Example",
  "description": "This is an example package",
  "unity": "2019.1",
  "unityRelease": "0b5",
  "documentationUrl": "https://example.com/",
  "changelogUrl": "https://example.com/changelog.html",
  "licensesUrl": "https://example.com/licensing.html",
  "dependencies": {
    "com.[company-name].some-package": "1.0.0",
    "com.[company-name].other-package": "2.0.0"
 },
 "keywords": [
    "keyword1",
    "keyword2",
    "keyword3"
  ],
  "author": {
    "name": "Unity",
    "email": "unity@example.com",
    "url": "https://www.unity3d.com"
  }
}

追加リソース

• 重要なクラス - Object