---
title: Link XML 포맷 레퍼런스
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting.md
generated_at: 2026-11-19T14:01:17.077Z
locale: ko-kr
---

# Link XML 포맷 레퍼런스

> 지원되는 XML 요소 및 속성 및 사용 사례를 비롯하여 link.xml 파일 포맷 방법을 이해합니다.

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

## 지원되는 XML 요소##supported-xml-elements

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

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

이러한 모든 요소의 사용 예시는 [사용 예시](#usage-examples)를 참조하십시오.

## 지원되는 XML 속성##supported-xml-attributes

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

이러한 모든 속성의 사용 예시는 [사용 예시](#usage-examples)를 참조하십시오.

## 사용 예시##usage-examples

다음 예시는 지원되는 XML 요소 및 속성의 유효한 사용을 보여줍니다.

### 어셈블리의 루트 타입을 선언하는 다양한 방법##different-ways-to-declare-the-root-types-of-an-assembly

다음 예제는 `link.xml` 파일을 사용하여 프로젝트 어셈블리의 루트 타입을 선언하는 다양한 방법을 나타냅니다.

```lang-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>
```

### 전체 어셈블리를 루트로 선언##declare-entire-assemblies-as-roots

다음 예시는 전체 어셈블리를 선언하는 방법을 보여 줍니다.

```lang-xml
<!--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"/>
```

### 중첩형 또는 제네릭 타입 보존##preserve-nested-or-generic-types

다음 예시는 중첩된 타입이나 일반 타입을 보존하는 방법을 보여 줍니다.

```lang-xml
<!--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"/>
```

### 누락된 어셈블리 무시##ignore-a-missing-assembly

모든 플레이어 빌드 중에 존재하지 않는 어셈블리에 대한 보존을 선언해야 하는 경우 `<assembly>` 요소의 `ignoreIfMissing` 속성을 사용합니다.

```lang-xml
<linker>
  <assembly fullname="Foo" ignoreIfMissing="1">
    <type name="TypeName"/>
  </assembly>
</linker>
```

### 참조되지 않은 어셈블리 무시##ignore-an-unreferenced-assembly

`<assembly>` 요소의 `ignoreIfUnreferenced` 속성을 사용하여 다른 어셈블리에서 하나 이상의 타입이 참조된 경우에만 어셈블리의 Entities를 보존합니다.

```lang-xml
<linker>
  <assembly fullname="Bar" ignoreIfUnreferenced="1">
    <type name="TypeName"/>
  </assembly>
</linker>
```

### Windows 런타임 메타데이터 어셈블리##windows-runtime-metadata-assembly

Windows 런타임 메타데이터(.winmd) 어셈블리에 대한 보존을 정의할 때마다 `<assembly>` 요소의 `windowsruntime` 속성을 사용해야 합니다.

```lang-xml
<linker>
  <assembly fullname="Windows" windowsruntime="true">
    <type name="TypeName"/>
 </assembly>
</linker>
```

### 기능 제외##feature-exclusions

`mscorlib.dll`에 내장된 `mscorlib.xml` 파일은 이 속성을 사용하지만, 필요한 경우 모든 `link.xml` 파일에서 사용할 수 있습니다.

**High** [스트리핑 레벨](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)에서 Unity linker는 현재 빌드 설정에 따라 지원되지 않는 기능에 대한 보존을 제외합니다.

1. `remoting` — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
2. `sre` — IL2CPP 스크립팅 백엔드를 타겟팅할 때 제외됩니다.
3. `com` — COM을 지원하지 않는 플랫폼을 타게팅하는 경우 제외됩니다.

예를 들어 다음 `link.xml` 파일은 COM을 지원하는 플랫폼에서 타입의 하나의 메서드와 모든 플랫폼에서 하나의 메서드를 보존합니다.

```lang-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>
```

## 추가 리소스##additional-resources

* [관리되는 코드 스트리핑 및 Unity linker](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/unity-linker.md)
* [관리되는 코드 스트리핑 구성](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)
* [주석을 사용하여 코드 보존](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/preserving.md)
* [Unity linker 마킹 규칙 참조](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md)
* [IUnityLinkerProcessor.GenerateAdditionalLinkXmlFile](/engine/6000.0/script-reference/unityeditor/build/iunitylinkerprocessor/generateadditionallinkxmlfile.md)
