기술 자료

Unity 엔진

Unity 엔진

Link XML 포맷 레퍼런스

지원되는 XML 요소 및 속성 및 사용 사례를 비롯하여 link.xml 파일 포맷 방법을 이해합니다.
읽는 시간 6분최근 업데이트: 9일 전

이 참조는 유효한 XML 요소 및 속성 및 사용 예시를 비롯하여
link.xml
파일의 올바른 포맷에 대한 정보를 제공합니다.

지원되는 XML 요소

link.xml 파일에서 다음 XML 요소가 지원됩니다.

요소

설명

<linker></linker>
모든
link.xml
파일에서 다른 모든 요소를 둘러싸는 가장 외부 요소로 사용해야 합니다.
<assembly></assembly>
어셈블리에 대한 코드 보존 주석을 선언합니다.
<type></type>
타입별로 코드 보존 주석을 선언합니다.
<field></field>
필드에 대한 코드 보존 주석을 선언합니다.
<method></method>
메서드에 대한 코드 보존 주석을 선언합니다.
<property></property>
프로퍼티에 대한 코드 보존 주석 선언
<event></event>
이벤트에 대한 코드 보존 주석 선언
이러한 모든 요소의 사용 예시는 사용 예시를 참조하십시오.

지원되는 XML 속성

속성

설명

accessors
<property>
요소에 적용하여 보호할 프로퍼티의 액세서 메서드를 지정합니다.
feature
현재 빌드 설정에 따라 지원되지 않는 기능의 보존을 제외합니다. 자세한 내용과 사용 예시는 기능 제외를 참고하십시오.
fullname
부모 어셈블리 이름을 접두사로 포함하여 이름으로 코드 요소를 식별합니다.
name
만 불확실할 때마다
fullname
를 사용하십시오.
ignoreIfMissing
모든 플레이어 빌드 중에 존재하지 않는 어셈블리에 대한 보존을 선언하려면
<assembly>
요소에 적용합니다. 사용 예제는 누락된 어셈블리 무시를 참조하십시오.
ignoreIfUnreferenced
해당 멤버 중 하나 이상이 다른 어셈블리에서 참조된 경우에만 어셈블리의 Entities를 보존하도록
<assembly>
요소에 적용합니다. 사용 예제는 참조 레퍼런스되지 않은 어셈블리 무시를 참조하십시오.
name
부모 어셈블리를 접두사로 사용하지 않고 이름으로만 코드 요소를 식별합니다. 부모 XML 요소에서 어셈블리 이름이 이미
fullname
로 지정된 경우 자식 XML 요소는
name
만으로 코드 요소를 식별할 수 있습니다.
preserve
스트리핑으로부터 보존할 코드 요소의 레벨을 지정합니다.
signature
서명으로 코드 요소를 식별합니다. 메서드 서명은 반환 타입, 이름, 파라미터로 구성됩니다. 필드, 프로퍼티 또는 이벤트 서명은 타입과 이름으로 구성됩니다. 사용 예시는 사용 예시를 참조하십시오.
windowsruntime
Windows 런타임 메타데이터(.winmd) 어셈블리에 대한 보존을 정의할 때마다
link.xml
파일의
<assembly>
요소에 추가해야 합니다. 사용 예제는 Windows 런타임 메타데이터 어셈블리를 참조하십시오.
이러한 모든 속성의 사용 예시는 사용 예시를 참조하십시오.

사용 예시

다음 예시는 지원되는 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
속성을 사용하여 다른 어셈블리에서 하나 이상의 타입이 참조된 경우에만 어셈블리의 Entities를 보존합니다.
<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.dll
에 내장된
mscorlib.xml
파일은 이 속성을 사용하지만, 필요한 경우 모든
link.xml
파일에서 사용할 수 있습니다.
High 스트리핑 레벨에서 Unity linker는 현재 빌드 설정에 따라 지원되지 않는 기능에 대한 보존을 제외합니다.
  1. remoting
    — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
  2. sre
    — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
  3. com
    — COM을 지원하지 않는 플랫폼을 타게팅하는 경우 제외됩니다.
예를 들어 다음
link.xml
파일은 COM을 지원하는 플랫폼에서 타입의 하나의 메서드와 모든 플랫폼에서 하나의 메서드를 보존합니다.
<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>

추가 리소스