ドキュメント

Unity Engine

Unity Engine

アセンブリ定義ファイル形式リファレンス

アセンブリ定義ファイル形式リファレンス。
読み終わるまでの所要時間 9 分最終更新 6日前

アセンブリ定義およびアセンブリ定義リファレンスアセットは JSON ファイルです。Unity エディター内のアセットファイルは、
Inspector

?

ウィンドウを使用して編集できますが、外部ツールを使用して JSON コンテンツを直接変更することもできます。

アセンブリ定義 JSON

アセンブリ定義は、以下のフィールドを持つ JSON オブジェクトです。

キー /Key

Type (タイプ)

必須

説明

allowUnsafeCode
bool任意デフォルトでは false。このオプションの意味の詳細は、『 General Options で Allow `unsafe` コード 』を参照してください。
autoReferenced
bool任意デフォルトでは true。このオプションの意味の詳細は、一般オプションの自動参照 を参照してください。
defineConstraints
string[]任意空にすることができます。詳細は、制約の定義 を参照してください。
excludePlatforms
string[]任意除外するプラットフォーム名の文字列または空の配列。
includePlatforms
に値が含まれている場合、
excludePlatforms
配列は空である必要があります。有効なプラットフォーム名の文字列は、
CompilationPipeline.GetAssemblyDefinitionPlatforms
によって返される
AssemblyDefinitionPlatform
オブジェクトの配列の
AssemblyDefinitionPlatform.Name
プロパティです。現在のエディタにビルドサポートがインストールされているプラットフォームのみ有効です。詳細は、『 プラットフォーム 』を参照してください。
includePlatforms
string[]任意含めるプラットフォーム名の文字列または空の配列。
excludePlatforms
に値が含まれている場合、
includePlatforms
配列は空である必要があります。有効なプラットフォーム名の文字列は、
CompilationPipeline.GetAssemblyDefinitionPlatforms
によって返される
AssemblyDefinitionPlatform
オブジェクトの配列の
AssemblyDefinitionPlatform.Name
プロパティです。現在のエディタにビルドサポートがインストールされているプラットフォームのみ有効です。詳細は、『 プラットフォーム 』を参照してください。
name
string必須詳細については、「 名前 」を参照してください。
noEngineReferences
bool任意デフォルトでは false。このオプションの意味の詳細は、「 一般オプションのエンジン参照なし 」を参照してください。
overrideReferences
bool任意デフォルトでは false。
precompiledReferences
に値が含まれている場合は true に設定します。このオプションの意味の詳細は、「 一般オプションのオーバーライド参照 」を参照してください。
precompiledReferences
string[]任意拡張子を含む参照 DLL ライブラリのファイル名。他のパス要素は含みません。空にすることができます。この配列は、
overrideReferences
を true に設定しない限り無視されます。詳細については、アセンブリの参照 を参照してください。
references
string[]任意アセンブリ定義アセットで作成された他のアセンブリへの参照。アセンブリ定義アセットファイルの GUID か、アセンブリ定義の
name
フィールドで定義されたアセンブリ名のいずれかを使用できます。リスト内のすべての参照に同じフォームを使用する必要があります。空にすることができます。

AssetDatabase.AssetPathToGUID
機能を使用して、アセットの GUID を取得できます。GUID は、各アセットに紐づけられたメタデータの一部でもあります。

Assembly Definition Inspector に Use GUIDs オプションが表示されます。このオプションは、関連する JSON ファイルにシリアライズされません。代わりに、ファイル内のリファレンス形式から選択内容が推測されます。詳細については、アセンブリの参照 を参照してください。
versionDefines
object[]任意各バージョン定義の オブジェクトが含まれます。このオブジェクトには 3 つのフィールドがあります。
  • name
    :文字列 -- リソースの名前。
  • expression
    :文字列 -- リソースのバージョンまたはバージョン範囲を定義する式。
  • define
    :文字列 -- 定義するシンボル。
詳細は、バージョン定義 を参照してください。

アセンブリ名と含まれるプラットフォームの例

以下のアセンブリ定義 JSON の例では、他のアセンブリ定義への参照にアセンブリ名と
includePlatforms
キーを使用して、含まれるプラットフォームの配列を指定します。
{ "name": "BeeAssembly" "references": [ "Unity.CollabProxy.Editor", "AssemblyB", "UnityEngine.UI", "UnityEngine.TestRunner", "UnityEditor.TestRunner" ], "includePlatforms": [ "Android", "LinuxStandalone64", "WebGL" ], "excludePlatforms": [], "overrideReferences": true, "precompiledReferences": [ "Newtonsoft.Json.dll", "nunit.framework.dll" ], "autoReferenced": false, "defineConstraints": [ UNITY "UNITY_INCLUDE_TESTS" ], "versionDefines": [ { "name": "com.unity.ide.vscode", "expression": "[1.7,2.4.1]", "define":"MY_SYMBOL" { "name": "com.unity.test-framework", "expression": "[2.7.2-preview.8]", "define":TESTS (テスト) } ], "noEngineReferences": false}

GUID と除外プラットフォームの例

以下のアセンブリ定義 JSON の例では、他のアセンブリ定義への参照にアセンブリ GUID を使用し、
excludePlatforms
キーを使用して除外するプラットフォームの配列を指定します。
{ "name": "BeeAssembly" "references": [ "GUID:17b36165d09634a48bf5a0e4bb27f4bd", "GUID:b470eee7144904e59a1064b70fa1b086", "GUID:2bafac87e7f4b9b418d9448d219b01ab", "GUID:27619889b8ba8c24980f49ee34dbb44a", "GUID:0acc523941302664db1f4e527237feb3" ], "includePlatforms": [], "excludePlatforms": [ "iOS", "macOSStandalone", "tvOS" ], "allowUnsafeCode": false, "overrideReferences": true, "precompiledReferences": [ "Newtonsoft.Json.dll", "nunit.framework.dll" ], "autoReferenced": false, "defineConstraints": [ UNITY "UNITY_INCLUDE_TESTS" ], "versionDefines": [ { "name": "com.unity.ide.vscode", "expression": "[1.7,2.4.1]", "define":"MY_SYMBOL" { "name": "com.unity.test-framework", "expression": "[2.7.2-preview.8]", "define":TESTS (テスト) } ], "noEngineReferences": false}

アセンブリ定義リファレンス JSON

アセンブリ定義リファレンスは、1 つの必須フィールド
reference
という文字列だけを持つ JSON オブジェクトです。アセンブリ名または アセンブリ 定義 アセット GUID のいずれかで、リファレンスするアセンブリを指定します。
AssetDatabase.AssetPathToGUID
機能を使用して、アセットの GUID を取得できます。GUID は、各アセットに紐づけられたメタデータの一部でもあります。
以下のアセンブリ定義リファレンス例では、別のアセットを名前で参照しています。
{ "reference":AssemblyA}
以下のアセンブリ定義リファレンス例では、アセット GUID で別のアセットを参照しています。
{ "reference":"GUID:f4de40948f4904ecb94b59dd38aab8a1"}

追加リソース