기술 자료

Unity 엔진

Unity 엔진

Unity linker 마킹 규칙 참조

Unity linker가 각 관리되는 스트리핑 레벨 적용하는 마킹 규칙을 이해하여 코드 어셈블리의 어떤 부분을 스트리핑할지 결정합니다.
읽는 시간 2분최근 업데이트: 9일 전

Unity linker는 정적 분석을 수행할 때 빌드에 필요한 것으로 표시할 CIL 바이트코드의 일부를 결정하기 위해 일련의 규칙을 따릅니다.
  • Unity linker가 빌드의 최상위 수준 어셈블리를 식별하고 보존하는 방식을 결정하는 루트 마킹 규칙입니다.
  • 종속성 마킹 규칙은 Unity linker가 루트 어셈블리가 의존하는 코드를 식별하고 보존하는 방식을 결정합니다.
설정된 관리되는 스트리핑 레벨은 Unity linker가 사용하는 규칙 집합을 변경합니다. 다음 섹션에서는 각 관리되는 스트리핑 레벨 마킹 규칙에 대해 설명합니다.

루트 마킹 규칙

다음 표는 Unity linker가 다양한 어셈블리 타입과 관리되는 스트리핑 레벨에 대한 어셈블리의 최상위 타입을 식별하는 방법을 설명합니다.

구성 유형

관리되는 스트리핑 레벨에서 루트 마킹 규칙

.NET Class & Platform SDK 및 UnityEngine 어셈블리최소 및 낮음:
  • 예방적 보존
최소, 낮음, 중간, 높음:
  • 모든
    link.xml
    파일에 정의된 보존
씬에서 참조된 타입의 어셈블리최소 및 낮음:
  • 어셈블리의 모든 타입 및 멤버
중간 및 높음:
  • [RuntimeInitializeOnLoadMethod]
    또는
    [Preserve]
    속성이 있는 모든 메서드입니다.
  • 모든
    link.xml
    파일에 정의된 보존
  • 미리 컴파일된 패키지, Unity 스크립트 또는 어셈블리 정의 어셈블리에서 MonoBehaviour 및 ScriptableObject에서 파생된 모든 타입입니다.
기타최소
  • 어셈블리의 모든 타입 및 멤버
낮음 및 중간:
  • 모든 공용 타입 및 해당 타입의 공용 멤버
중간 및 높음:
  • [RuntimeInitializeOnLoadMethod]
    또는
    [Preserve]
    속성이 있는 모든 메서드입니다.
  • 모든
    link.xml
    파일에 정의된 보존
  • 미리 컴파일된 패키지, Unity 스크립트 또는 어셈블리 정의 어셈블리에서 MonoBehaviour 및 ScriptableObject에서 파생된 모든 타입입니다.
테스트최소, 낮음, 중간, 높음:
  • [UnityTest]
    속성이 있는 모든 메서드와 NUnit.Framework에 정의된 속성으로 주석이 지정된 모든 메서드입니다.

종속성 마킹 규칙

Unity linker가 어셈블리의 루트를 식별한 후 해당 루트가 의존하는 코드를 식별해야 합니다. 다음 표는 Unity linker가 다양한 관리되는 스트리핑 레벨에서 어셈블리의 루트 타입의 종속성을 식별하는 방법을 설명합니다.

규칙 타겟

관리되는 스트리핑 수준에서 종속성 마킹 규칙

MonoBehaviour최소, 낮음, 중간, 높음:
  • Unity linker는 유형을 표시할 때 MonoBehavior 유형의 모든 멤버를 마킹합니다.
ScriptableObject최소, 낮음, 중간, 높음:
  • Unity linker는 유형을 표시할 때 ScriptableObject 타입의 모든 멤버를 마킹합니다.
속성최소 및 낮음:
  • Unity linker가 어셈블리, 타입 또는 기타 코드 구조를 마킹할 때 해당 구조의 모든 속성을 마킹합니다.
중간 및 높음:
  • Unity linker가 어셈블리, 타입 또는 기타 코드 구조를 마킹하는 경우 속성 타입도 마킹된 경우에만 해당 구조의 속성을 마킹합니다.
디버깅 속성최소 및 낮음:
  • 스크립트 디버깅을 활성화하면 해당 멤버를 사용하는 코드 경로가 없더라도 Unity linker는
    [DebuggerDisplay]
    속성이 있는 모든 멤버를 마킹합니다.
중간 및 높음:
  • Unity linker는 항상
    DebuggerDisplayAttribute
    및
    DebuggerTypeProxyAttribute
    와 같은 디버깅 속성을 제거합니다.
.NET Facade 클래스 라이브러리최소, 낮음, 중간, 높음:
  • 런타임 시 필요하지 않으므로 페사드 어셈블리를 제거합니다.

추가 리소스