주석을 사용하여 코드 보존
C# 속성 또는 link.xml 파일 형식의 주석을 사용하여 Unity linker가 스트리핑하지 않아야 하는 코드 부분을 지정합니다.
읽는 시간 4분최근 업데이트: 9일 전
주석을 사용하여 Unity linker가 코드의 특정 섹션을 스트리핑하지 못하게 할 수 있습니다. 이는 애플리케이션이 Unity가 정적 분석을 수행할 때 존재하지 않는 런타임 코드를 생성하는 경우에 유용합니다(예: 반사). 주석은 Unity linker에 어떤 코드 패턴을 스트리핑하지 않아야 하는지에 대한 일반적인 지침을 제공하거나, 특정 정의된 코드 섹션을 스트리핑하지 않도록 지시합니다.
관리되는 코드 스트리핑 프로세스에서 코드를 보존하기 위해 코드를 주석으로 지정하는 데 사용할 수 있는 두 가지 방법이 있습니다.
- 루트 주석은 코드의 일부를 루트로 식별합니다. Unity linker는 루트로 표시된 코드를 제거하지 않습니다. 루트 주석은 사용하기가 덜 복잡하지만 Unity linker가 스트리핑해야 하는 일부 코드를 보존하도록 리드할 수도 있습니다.
- 종속성 주석은 코드 요소 간의 연결을 정의합니다. 종속성 주석은 루트 주석에 비해 불필요한 코드 보존을 줄일 수 있습니다.
이러한 각 기법은 Unity linker가 높은 스트리핑 레벨에서 스트리핑하는 코드의 양에 대한 더 많은 제어를 제공하며 중요한 코드가 스트리핑되는 기회를 줄입니다. 주석은 반사를 통해 다른 코드를 참조할 때 특히 유용합니다. Unity linker는 반사의 사용을 항상 감지할 수 없기 때문입니다.
런타임 시 반사를 사용하거나 다른 코드를 생성하는 코드를 보존하여 애플리케이션이 실행될 때 예기치 않은 동작의 가능성을 크게 줄입니다. Unity linker가 인식할 수 있는 반사 패턴의 예는 Unity Intermediate Language Linker 반사 테스트 제품군을 참조하십시오.
루트 주석
루트 주석은 Unity linker가 코드 요소를 루트로 취급하도록 합니다. 코드 스트리핑 프로세스에서 제거되지 않습니다. 생성자나 어셈블리로 개별 타입을 보존해야 하는지에 따라 두 가지 타입의 루트 주석을 사용할 수 있습니다.
- Preserve 속성: 개별 타입을 보존하기 위해 루트로 주석을 붙입니다.
- Link.xml: 어셈블리와 해당 어셈블리의 모든 타입 또는 기타 코드 Entities 보존하기 위해 루트로 주석합니다.
Preserve 속성을 사용하여 루트에 주석을 붙입니다.
[Preserve][Preserve][Preserve]- 조립: 어셈블리에 사용되고 정의된 모든 타입을 보존합니다. 어셈블리에 속성을 할당하려면 어셈블리에 포함된 C# 파일에 속성 선언을 네임스페이스 선언 앞에 배치합니다.
[Preserve] - Type: 클래스 또는 타입과 기본 생성자를 보존합니다.
- "method": 메서드, 메서드를 선언하는 타입, 메서드가 반환하는 타입, 모든 인수의 타입을 보존합니다.
- 프로퍼티 프로퍼티, 프로퍼티를 선언하는 타입, 프로퍼티의 값 타입, 프로퍼티 값을 가져오고 설정하는 메서드를 보존합니다.
- Field 필드, 필드 타입, 필드를 선언하는 타입을 보존합니다.
- 이벤트: 이벤트, 이벤트를 선언하는 유형, 유형, 이벤트가 반환하는 유형, 액세서 및
[add]액세서를 보존합니다.[remove] - delegate 델리게이트 타입과 델리게이트가 호출하는 모든 메서드를 보존합니다.
타입과 기본 생성자를 모두 보존하려면 속성을 사용합니다. 둘 중 하나를 유지하고 싶지만 둘 다 유지하지 않으려면 파일을 사용합니다.
[Preserve]link.xml모든 어셈블리와 네임스페이스에서 속성을 정의할 수 있습니다. 클래스를 사용하거나 하위 클래스를 만들거나 고유 클래스를 만들 수 있습니다. 예제는 아래와 같습니다.
[Preserve]PreserveAttributeFoo 클래스{ [Preserve] public void PreservedMethod(){}}
Link XML 파일을 사용하여 루트에 주석 작성
프로젝트에 라는 .xml 파일을 포함하여 특정 어셈블리나 어셈블리의 일부 목록을 보존할 수 있습니다. 파일은 프로젝트의 폴더 또는 폴더 하위 디렉토리에 있어야 하며 파일에 태그를 포함해야 합니다. Unity linker는 파일에 보존된 어셈블리, 유형 또는 멤버를 루트 유형으로 취급합니다.
link.xmllink.xmlAssetsAssets<linker>link.xml프로젝트에서 원하는 수의 파일을 사용할 수 있습니다. 따라서 각 플러그인에 대해 별도의 보존 선언을 제공할 수 있습니다. 패키지에 파일을 포함할 수는 없지만 패키지가 아닌 파일에서 패키지 어셈블리를 참조할 수 있습니다.
link.xmllink.xmllink.xmllink.xml종속성 주석
종속성 주석은 다양한 코드 요소 간의 종속성을 정의합니다. 이러한 주석은 반사와 같이 Unity linker가 정적으로 분석할 수 없는 코드 패턴을 보존하는 데 유용합니다. 또한 이러한 주석은 루트 요소가 사용하지 않을 때 이러한 코드 요소가 잘못 보존되지 않도록 보장합니다. Unity linker가 코드 요소를 처리하는 방식을 변경하는 데 사용할 수 있는 두 가지 방법이 있습니다.
- 주석 속성: 이러한 속성은 Unity linker가 주석 타입에서 파생된 타입과 같은 특정 코드 패턴을 보존해야 함을 나타냅니다.
- AlwaysLinkAssemblyAttribute: 이 속성을 사용하여 Unity linker가 프로젝트의 다른 어셈블리에서 참조되지 않은 경우에도 어셈블리를 처리해야 함을 나타냅니다.
주석 속성
[Preserve][RequireImplementorsAttribute]특정 코딩 패턴에 주석을 붙이려면 다음 속성 중 하나 이상을 사용하십시오.
- : 이 인터페이스를 구현하는 모든 타입을 종속성으로 표시합니다.
RequireImplementorsAttribute - : 이 타입에서 파생되는 모든 타입을 종속성으로 표시합니다.
RequireDerivedAttribute - : 타입의 인터페이스 구현을 종속성으로 표시합니다.
RequiredInterfaceAttribute - : 타입의 모든 멤버를 종속성으로 표시합니다.
RequiredMemberAttribute - : 커스텀 속성을 종속성으로 표시합니다.
RequireAttributeUsagesAttribute
이러한 속성을 여러 가지 방법으로 결합하여 Unity linker가 코드를 어떻게 보존하는지 더 정확하게 제어할 수 있습니다.
AlwaysLinkAssembly 속성
[AlwaysLinkAssembly]속성은 어셈블리 내에서 코드를 직접 보존하지 않습니다. 대신 이 속성은 Unity linker에 어셈블리에 루트 마킹 규칙을 적용하도록 명령합니다. 어셈블리의 루트 마킹 규칙과 일치하는 코드 요소가 없으면 Unity linker는 빌드에서 어셈블리를 제거합니다.
이 속성을 속성이 있는 하나 이상의 메서드를 포함하는 사전 컴파일된 어셈블리나 패키지 어셈블리에 사용하지만, 프로젝트의 어떤 씬에서 직접 또는 간접적으로 사용되는 타입을 포함하지 않을 수 있습니다.
[RuntimeInitializeOnLoadMethod]어셈블리가 를 정의하고 빌드에 포함된 다른 어셈블리에서도 참조되는 경우 속성은 출력에 영향을 미치지 않습니다.
[assembly: AlwaysLinkAssembly]