---
title: 주석을 사용하여 코드 보존
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/preserving
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/preserving.md
generated_at: 2026-11-19T14:01:18.888Z
locale: ko-kr
---

# 주석을 사용하여 코드 보존

> C# 속성 또는 link.xml 파일 형식의 주석을 사용하여 Unity linker가 스트리핑하지 않아야 하는 코드 부분을 지정합니다.

주석을 사용하여 Unity linker가 코드의 특정 섹션을 스트리핑하지 못하게 할 수 있습니다. 이는 애플리케이션이 Unity가 정적 분석을 수행할 때 존재하지 않는 런타임 코드를 생성하는 경우에 유용합니다(예: [반사](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/reflection)). 주석은 Unity linker에 어떤 코드 패턴을 스트리핑하지 않아야 하는지에 대한 일반적인 지침을 제공하거나, 특정 정의된 코드 섹션을 스트리핑하지 않도록 지시합니다.

관리되는 코드 스트리핑 프로세스에서 코드를 보존하기 위해 코드를 주석으로 지정하는 데 사용할 수 있는 두 가지 방법이 있습니다.

* [루트 주석은](#root-annotations) 코드의 일부를 루트로 식별합니다. Unity linker는 루트로 표시된 코드를 제거하지 않습니다. 루트 주석은 사용하기가 덜 복잡하지만 Unity linker가 스트리핑해야 하는 일부 코드를 보존하도록 리드할 수도 있습니다.
* [종속성 주석](#dependency-annotations)은 코드 요소 간의 연결을 정의합니다. 종속성 주석은 루트 주석에 비해 불필요한 코드 보존을 줄일 수 있습니다.

이러한 각 기법은 Unity linker가 높은 스트리핑 레벨에서 스트리핑하는 코드의 양에 대한 더 많은 제어를 제공하며 중요한 코드가 스트리핑되는 기회를 줄입니다. 주석은 반사를 통해 다른 코드를 참조할 때 특히 유용합니다. Unity linker는 반사의 사용을 항상 감지할 수 없기 때문입니다.

런타임 시 반사를 사용하거나 다른 코드를 생성하는 코드를 보존하여 애플리케이션이 실행될 때 예기치 않은 동작의 가능성을 크게 줄입니다. Unity linker가 인식할 수 있는 반사 패턴의 예는 [Unity Intermediate Language Linker 반사 테스트 제품군](https://github.com/Unity-Technologies/linker/tree/unity-master/test/Mono.Linker.Tests.Cases/Reflection)을 참조하십시오.

## 루트 주석##root-annotations

루트 주석은 Unity linker가 코드 요소를 루트로 취급하도록 합니다. 코드 스트리핑 프로세스에서 제거되지 않습니다. 생성자나 어셈블리로 개별 타입을 보존해야 하는지에 따라 두 가지 타입의 루트 주석을 사용할 수 있습니다.

* [Preserve 속성](#PreserveAttribute): 개별 타입을 보존하기 위해 루트로 주석을 붙입니다.
* [Link.xml](#LinkXMLAnnotation): 어셈블리와 해당 어셈블리의 모든 타입 또는 기타 코드 Entities 보존하기 위해 루트로 주석합니다.

### Preserve 속성을 사용하여 루트에 주석을 붙입니다.##annotate-roots-using-the-preserve-attribute

[`[Preserve]`](/engine/6000.0/script-reference/unityengine/scripting/preserveattribute.md) 속성을 사용하여 Unity linker의 정적 분석에서 코드의 특정 섹션을 개별적으로 제외합니다. 이 속성을 사용하여 코드 조각에 주석을 붙이려면 보존하려는 코드의 첫 번째 부분 바로 앞에 `[Preserve]`를 추가합니다. 다음 목록에는 `[Preserve]` 속성을 사용하여 다른 코드 요소에 주석을 붙일 때 Unity linker가 보존하는 Entities가 나와 있습니다.

* **조립**: 어셈블리에 사용되고 정의된 모든 타입을 보존합니다. 어셈블리에 `[Preserve]` 속성을 할당하려면 어셈블리에 포함된 C# 파일에 속성 선언을 네임스페이스 선언 앞에 배치합니다.
* **Type**: 클래스 또는 타입과 기본 생성자를 보존합니다.
* "method": 메서드, 메서드를 선언하는 타입, 메서드가 반환하는 타입, 모든 인수의 타입을 보존합니다.
* 프로퍼티 프로퍼티, 프로퍼티를 선언하는 타입, 프로퍼티의 값 타입, 프로퍼티 값을 가져오고 설정하는 메서드를 보존합니다.
* **Field** 필드, 필드 타입, 필드를 선언하는 타입을 보존합니다.
* **이벤트**: 이벤트, 이벤트를 선언하는 유형, 유형, 이벤트가 반환하는 유형, `[add]` 액세서 및 `[remove]` 액세서를 보존합니다.
* **delegate** 델리게이트 타입과 델리게이트가 호출하는 모든 메서드를 보존합니다.

타입과 기본 생성자를 모두 보존하려면 `[Preserve]` 속성을 사용합니다. 둘 중 하나를 유지하고 싶지만 둘 다 유지하지 않으려면 `link.xml` 파일을 사용합니다.

모든 어셈블리와 네임스페이스에서 `[Preserve]` 속성을 정의할 수 있습니다. [`PreserveAttribute`](/engine/6000.0/script-reference/unityengine/scripting/preserveattribute.md) 클래스를 사용하거나 하위 클래스를 만들거나 고유 클래스를 만들 수 있습니다. 예제는 아래와 같습니다.

```lang-cs
Foo 클래스
{
    [Preserve]
    public void PreservedMethod(){}
}
```

### Link XML 파일을 사용하여 루트에 주석 작성##annotate-roots-using-a-link-xml-file

프로젝트에 `link.xml`라는 .xml 파일을 포함하여 특정 어셈블리나 어셈블리의 일부 목록을 보존할 수 있습니다. `link.xml` 파일은 프로젝트의 `Assets` 폴더 또는 `Assets` 폴더 하위 디렉토리에 있어야 하며 파일에 `<linker>` 태그를 포함해야 합니다. Unity linker는 `link.xml` 파일에 보존된 어셈블리, 유형 또는 멤버를 루트 유형으로 취급합니다.

프로젝트에서 원하는 수의 `link.xml` 파일을 사용할 수 있습니다. 따라서 각 플러그인에 대해 별도의 보존 선언을 제공할 수 있습니다. 패키지에 `link.xml` 파일을 포함할 수는 없지만 패키지가 아닌 `link.xml` 파일에서 패키지 어셈블리를 참조할 수 있습니다.

`link.xml` 파일 포맷 방법에 대한 자세한 내용은 [Link XML 포맷 레퍼런스](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting.md)를 참조하십시오.

## 종속성 주석##dependency-annotations

종속성 주석은 다양한 코드 요소 간의 종속성을 정의합니다. 이러한 주석은 반사와 같이 Unity linker가 정적으로 분석할 수 없는 코드 패턴을 보존하는 데 유용합니다. 또한 이러한 주석은 루트 요소가 사용하지 않을 때 이러한 코드 요소가 잘못 보존되지 않도록 보장합니다. Unity linker가 코드 요소를 처리하는 방식을 변경하는 데 사용할 수 있는 두 가지 방법이 있습니다.

* [주석 속성](#AnnotationAttributes): 이러한 속성은 Unity linker가 주석 타입에서 파생된 타입과 같은 특정 코드 패턴을 보존해야 함을 나타냅니다.
* [AlwaysLinkAssemblyAttribute](#AlwaysLinkAssemblyAttribute): 이 속성을 사용하여 Unity linker가 프로젝트의 다른 어셈블리에서 참조되지 않은 경우에도 어셈블리를 처리해야 함을 나타냅니다.

### 주석 속성##annotation-attributes

`[Preserve]` 속성은 API가 항상 필요할 때 유용합니다. 다른 속성은 더 일반적인 보존에 유용할 수 있습니다. 예를 들어, [`[RequireImplementorsAttribute]`](/engine/6000.0/script-reference/unityengine/scripting/requireimplementorsattribute.md)로 인터페이스에 주석을 붙여 특정 인터페이스를 구현하는 모든 타입을 보존할 수 있습니다.

특정 코딩 패턴에 주석을 붙이려면 다음 속성 중 하나 이상을 사용하십시오.

* [`RequireImplementorsAttribute`](/engine/6000.0/script-reference/unityengine/scripting/requireimplementorsattribute.md): 이 인터페이스를 구현하는 모든 타입을 종속성으로 표시합니다.
* [`RequireDerivedAttribute`](/engine/6000.0/script-reference/unityengine/scripting/requirederivedattribute.md): 이 타입에서 파생되는 모든 타입을 종속성으로 표시합니다.
* [`RequiredInterfaceAttribute`](/engine/6000.0/script-reference/unityengine/scripting/requiredinterfaceattribute.md): 타입의 인터페이스 구현을 종속성으로 표시합니다.
* [`RequiredMemberAttribute`](/engine/6000.0/script-reference/unityengine/scripting/requiredmemberattribute.md): 타입의 모든 멤버를 종속성으로 표시합니다.
* [`RequireAttributeUsagesAttribute`](/engine/6000.0/script-reference/unityengine/scripting/requireattributeusagesattribute.md): 커스텀 속성을 종속성으로 표시합니다.

이러한 속성을 여러 가지 방법으로 결합하여 Unity linker가 코드를 어떻게 보존하는지 더 정확하게 제어할 수 있습니다.

### AlwaysLinkAssembly 속성##alwayslinkassembly-attribute

[`[AlwaysLinkAssembly]`](/engine/6000.0/script-reference/unityengine/scripting/alwayslinkassemblyattribute.md) 속성은 빌드에 포함된 다른 어셈블리가 어셈블리를 참조하는지 여부와 관계없이 Unity linker가 어셈블리를 검색하도록 합니다. 어셈블리에만 속성을 적용할 수 있습니다.

속성은 어셈블리 내에서 코드를 직접 보존하지 않습니다. 대신 이 속성은 Unity linker에 어셈블리에 [루트 마킹 규칙](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md#root-marking-rules)을 적용하도록 명령합니다. 어셈블리의 루트 마킹 규칙과 일치하는 코드 요소가 없으면 Unity linker는 빌드에서 어셈블리를 제거합니다.

이 속성을 `[RuntimeInitializeOnLoadMethod]` 속성이 있는 하나 이상의 메서드를 포함하는 사전 컴파일된 어셈블리나 패키지 어셈블리에 사용하지만, 프로젝트의 어떤 씬에서 직접 또는 간접적으로 사용되는 타입을 포함하지 않을 수 있습니다.

어셈블리가 `[assembly: AlwaysLinkAssembly]`를 정의하고 빌드에 포함된 다른 어셈블리에서도 참조되는 경우 속성은 출력에 영향을 미치지 않습니다.

## 추가 리소스##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)
* [Link XML 형식 참조](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting.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)
