Link XML 포맷 레퍼런스
지원되는 XML 요소 및 속성 및 사용 사례를 비롯하여 link.xml 파일 포맷 방법을 이해합니다.
읽는 시간 6분최근 업데이트: 9일 전
이 참조는 유효한 XML 요소 및 속성 및 사용 예시를 비롯하여 파일의 올바른 포맷에 대한 정보를 제공합니다.
link.xml지원되는 XML 요소
link.xml 파일에서 다음 XML 요소가 지원됩니다.
요소 | 설명 |
|---|---|
| 모든 |
| 어셈블리에 대한 코드 보존 주석을 선언합니다. |
| 타입별로 코드 보존 주석을 선언합니다. |
| 필드에 대한 코드 보존 주석을 선언합니다. |
| 메서드에 대한 코드 보존 주석을 선언합니다. |
| 프로퍼티에 대한 코드 보존 주석 선언 |
| 이벤트에 대한 코드 보존 주석 선언 |
이러한 모든 요소의 사용 예시는 사용 예시를 참조하십시오.
지원되는 XML 속성
속성 | 설명 |
|---|---|
| |
| 현재 빌드 설정에 따라 지원되지 않는 기능의 보존을 제외합니다. 자세한 내용과 사용 예시는 기능 제외를 참고하십시오. |
| 부모 어셈블리 이름을 접두사로 포함하여 이름으로 코드 요소를 식별합니다. |
| 모든 플레이어 빌드 중에 존재하지 않는 어셈블리에 대한 보존을 선언하려면 |
| 해당 멤버 중 하나 이상이 다른 어셈블리에서 참조된 경우에만 어셈블리의 Entities를 보존하도록 |
| 부모 어셈블리를 접두사로 사용하지 않고 이름으로만 코드 요소를 식별합니다. 부모 XML 요소에서 어셈블리 이름이 이미 |
| 스트리핑으로부터 보존할 코드 요소의 레벨을 지정합니다. |
| 서명으로 코드 요소를 식별합니다. 메서드 서명은 반환 타입, 이름, 파라미터로 구성됩니다. 필드, 프로퍼티 또는 이벤트 서명은 타입과 이름으로 구성됩니다. 사용 예시는 사용 예시를 참조하십시오. |
| Windows 런타임 메타데이터(.winmd) 어셈블리에 대한 보존을 정의할 때마다 |
이러한 모든 속성의 사용 예시는 사용 예시를 참조하십시오.
사용 예시
다음 예시는 지원되는 XML 요소 및 속성의 유효한 사용을 보여줍니다.
어셈블리의 루트 타입을 선언하는 다양한 방법
다음 예제는 파일을 사용하여 프로젝트 어셈블리의 루트 타입을 선언하는 다양한 방법을 나타냅니다.
link.xml<linker> <!--Preserve types and members in an assembly--> <assembly fullname="AssemblyName"> <!--Preserve an entire type--> <type fullname="AssemblyName.TypeName" preserve="all"/> <!--No "preserve" attribute and no members specified means preserve all members--> <type fullname="AssemblyName.TypeName"/> <!--Preserve all fields on a type--> <type fullname="AssemblyName.TypeName" preserve="fields"/> <!--Preserve all methods on a type--> <type fullname="AssemblyName.TypeName" preserve="methods"/> <!--Preserve the type only--> <type fullname="AssemblyName.TypeName" preserve="nothing"/> <!--Preserving only specific members of a type--> <type fullname="AssemblyName.TypeName"> <!--Fields--> <field signature="System.Int32 FieldName" /> <!--Preserve a field by name rather than signature--> <field name="FieldName" /> <!--Methods--> <method signature="System.Void MethodName()" /> <!--Preserve a method with parameters--> <method signature="System.Void MethodName(System.Int32,System.String)" /> <!--Preserve a method by name rather than signature--> <method name="MethodName" /> <!--Properties--> <!--프로퍼티, 해당 백ing 필드(존재하는 경우)를 보존합니다. 게터 및 세터 메서드--> <property signature="System.Int32 PropertyName" /> <property signature="System.Int32 PropertyName" accessors="all" /> <!--Preserve a property, its backing field (if present), and getter method--> <property signature="System.Int32 PropertyName" accessors="get" /> <!--Preserve a property, its backing field (if present), and setter method--> <property signature="System.Int32 PropertyName" accessors="set" /> <!--Preserve a property by name rather than signature--> <property name="PropertyName" /> <!--Events--> <!--Preserve an event, its backing field (if present), add, and remove methods--> <event signature="System.EventHandler EventName" /> <!--Preserve an event by name rather than signature--> <event name="EventName" /> </type> </assembly></linker>
전체 어셈블리를 루트로 선언
다음 예시는 전체 어셈블리를 선언하는 방법을 보여 줍니다.
<!--Preserve an entire assembly--> <assembly fullname="AssemblyName" preserve="all"/> <!--No "preserve" attribute and no types specified means preserve all--> <assembly fullname="AssemblyName"/> <!--Fully qualified assembly name--> <assembly fullname="AssemblyName, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"> <type fullname="AssemblyName.Foo" preserve="all"/> </assembly> <!--어셈블리를 강제로 루트에 대해 처리하지만 구체적으로 아무것도 보존하지 않습니다. 어셈블리가 참조되지 않은 경우 유용합니다.--> <assembly fullname="AssemblyName" preserve="nothing"/>
중첩형 또는 제네릭 타입 보존
다음 예시는 중첩된 타입이나 일반 타입을 보존하는 방법을 보여 줍니다.
<!--Examples with generics--> <type fullname="AssemblyName.G`1"> <!--Preserve a field with generics in the signature--> <field signature="System.Collections.Generic.List`1<System.Int32> FieldName" /> <field signature="System.Collections.Generic.List`1<T> FieldName" /> <!--Preserve a method with generics in the signature--> <method signature="System.Void MethodName(System.Collections.Generic.List`1<System.Int32>)" /> <!--Preserve an event with generics in the signature--> eventName </type> <!--Preserve a nested type--> <type fullname="AssemblyName.H/Nested" preserve="all"/> <!--타입이 사용되는 경우 타입의 모든 필드를 보존합니다. 유형이 사용되지 않으면 제거됩니다--> <type fullname="AssemblyName.I" preserve="fields" required="0"/> <!--타입이 사용되는 경우 타입의 모든 메서드를 보존합니다. 유형이 사용되지 않으면 제거됩니다--> <type fullname="AssemblyName.J" preserve="methods" required="0"/> <!--Preserve all types in a namespace--> <type fullname="AssemblyName.SomeNamespace*" preserve="all"/> <!--Preserve all types with a common prefix in their name--> <type fullname="Prefix*" preserve="all"/>
누락된 어셈블리 무시
모든 플레이어 빌드 중에 존재하지 않는 어셈블리에 대한 보존을 선언해야 하는 경우 요소의 속성을 사용합니다.
<assembly>ignoreIfMissing<linker> <assembly fullname="Foo" ignoreIfMissing="1"> <type name="TypeName"/> </assembly></linker>
참조되지 않은 어셈블리 무시
<assembly>ignoreIfUnreferenced<linker> <assembly fullname="Bar" ignoreIfUnreferenced="1"> <type name="TypeName"/> </assembly></linker>
Windows 런타임 메타데이터 어셈블리
Windows 런타임 메타데이터(.winmd) 어셈블리에 대한 보존을 정의할 때마다 요소의 속성을 사용해야 합니다.
<assembly>windowsruntime<linker> <assembly fullname="Windows" windowsruntime="true"> <type name="TypeName"/> </assembly></linker>
기능 제외
mscorlib.dllmscorlib.xmllink.xmlHigh 스트리핑 레벨에서 Unity linker는 현재 빌드 설정에 따라 지원되지 않는 기능에 대한 보존을 제외합니다.
- — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
remoting - — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
sre - — COM을 지원하지 않는 플랫폼을 타게팅하는 경우 제외됩니다.
com
예를 들어 다음 파일은 COM을 지원하는 플랫폼에서 타입의 하나의 메서드와 모든 플랫폼에서 하나의 메서드를 보존합니다.
link.xml<linker> <assembly fullname="Foo"> <type fullname="Type1"> <!--Preserve FeatureOne on platforms that support COM--> <method signature="System.Void FeatureOne()" feature="com"/> <!--Preserve FeatureTwo on all platforms--> <method signature="System.Void FeatureTwo()"/> </type> </assembly></linker>