기술 자료

Unity 엔진

Unity 엔진

어셈블리 정의 파일 형식 참조

어셈블리 정의 파일 형식 참조.
읽는 시간 3분최근 업데이트: 9일 전

어셈블리 정의 에셋과 어셈블리 정의 레퍼런스 에셋은 JSON 파일입니다.
인스펙터

?

창을 사용하여 Unity 에디터 내에서 에셋 파일을 편집할 수 있지만 외부 툴을 사용하여 JSON 콘텐츠를 직접 수정할 수도 있습니다.

어셈블리 정의 JSON

어셈블리 정의는 다음 필드가 있는 JSON 객체.

Key

Type

필수 여부

설명

allowUnsafeCode
bool선택 사항기본값은 거짓입니다. 이 옵션의 의미에 대한 자세한 내용은 일반 옵션에서 ' 안전하지 않은' 코드 허용을 참고하 십시오.
autoReferenced
bool선택 사항기본적으로 true입니다. 이 옵션의 의미에 대한 자세한 내용은 일반 옵션에서 자동 참조를 참조하십시오.
defineConstraints
string[]선택 사항비어 있을 수 있습니다. 자세한 내용은 제약 정의를 참고하십시오.
excludePlatforms
string[]선택 사항제외할 플랫폼 이름 문자열 또는 빈 배열입니다.
includePlatforms
에 값이 있는 경우
excludePlatforms
배열이 비어 있어야 합니다. 유효한 플랫폼 이름 문자열은
CompilationPipeline.GetAssemblyDefinitionPlatforms
에서 반환하는
AssemblyDefinitionPlatform
객체 배열의
AssemblyDefinitionPlatform.Name
속성입니다. 현재 에디터에 대해 빌드가 지원되는 플랫폼만 유효합니다. 자세한 내용은 플랫폼을 참조하십시오.
includePlatforms
string[]선택 사항포함할 플랫폼 이름 문자열 또는 빈 배열입니다.
excludePlatforms
에 값이 있는 경우
includePlatforms
배열이 비어 있어야 합니다. 유효한 플랫폼 이름 문자열은
CompilationPipeline.GetAssemblyDefinitionPlatforms
에서 반환하는
AssemblyDefinitionPlatform
객체 배열의
AssemblyDefinitionPlatform.Name
속성입니다. 현재 에디터에 대해 빌드가 지원되는 플랫폼만 유효합니다. 자세한 내용은 플랫폼을 참조하십시오.
name
문자열필수 여부자세한 내용은 이름을 참조하십시오.
noEngineReferences
bool선택 사항기본값은 거짓입니다. 이 옵션의 의미에 대한 자세한 내용은 일반 옵션의 엔진 참조 없음을 참조하십시오.
overrideReferences
bool선택 사항기본값은 거짓입니다.
precompiledReferences
에 값이 있는 경우 true로 설정합니다. 이 옵션의 의미에 대한 자세한 내용은 일반 옵션의 레퍼런스 오버라이드를 참조하십시오.
precompiledReferences
string[]선택 사항확장자를 포함한 참조된 DLL 라이브러리의 파일 이름으로, 다른 경로 요소는 포함되지 않습니다. 비어 있을 수 있습니다.
overrideReferences
를 true로 설정하지 않으면 이 배열은 무시됩니다. 자세한 내용은 레퍼런싱 어셈블리를 참조하십시오.
references
string[]선택 사항어셈블리 정의 에셋으로 생성된 다른 어셈블리에 대한 레퍼런스입니다. 어셈블리 정의 에셋 파일의 GUID 또는 어셈블리 정의의
name
필드에 정의된 어셈블리 이름을 사용할 수 있습니다. 목록의 모든 레퍼런스에 동일한 양식을 사용해야 합니다. 비어 있을 수 있습니다.

AssetDatabase.AssetPathToGUID
함수를 사용하여 에셋의 GUID를 가져올 수 있습니다. GUID는 모든 에셋과 연결된 메타데이터의 일부이기도 합니다.

에디터는 어셈블리 정의 인스펙터에 GUID 사용 옵션을 표시합니다. 이 옵션은 연결된 JSON 파일에서 직렬화되지 않습니다. 대신 선택은 파일에 있는 레퍼런스 형식으로부터 추론됩니다. 자세한 내용은 레퍼런싱 어셈블리를 참조하십시오.
versionDefines
object[]선택 사항각 버전 정의에 대한 오브젝트를 포함합니다. 이 오브젝트에는 세 가지 필드가 있습니다.
  • name
    :string -- 자원의 이름입니다.
  • expression
    :string -- 자원의 버전 또는 버전 범위를 정의하는 표현식입니다.
  • define
    :string -- 정의할 심볼입니다.
자세한 내용은 버전 정의를 참조하십시오.

어셈블리 이름 및 포함된 플랫폼이 포함된 예시

다음 예제 어셈블리 정의 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_2019", "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_2019", "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

어셈블리 정의 레퍼런스는 필수 필드가 하나만 있는 JSON 객체입니다.
reference
라는 문자열입니다. 어셈블리 이름 또는 어셈블리 정의 에셋 GUID로 레퍼런스할 어셈블리를 지정합니다.
AssetDatabase.AssetPathToGUID
함수를 사용하여 에셋의 GUID를 가져올 수 있습니다. GUID는 모든 에셋과 연결된 메타데이터의 일부이기도 합니다.
다음 어셈블리 정의 레퍼런스 예시는 이름으로 다른 에셋을 참조합니다.
{ 레퍼런스 "AssemblyA"}
다음 어셈블리 정의 레퍼런스 예시는 에셋 GUID를 기준으로 다른 에셋을 참조합니다.
{ 레퍼런스 "GUID:f4de40948f4904ecb94b59dd38aab8a1"}

추가 리소스