---
title: Unity linker 마킹 규칙 참조
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/marking-rules
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md
generated_at: 2026-11-19T14:01:18.266Z
locale: ko-kr
---

# Unity linker 마킹 규칙 참조

> Unity linker가 각 관리되는 스트리핑 레벨 적용하는 마킹 규칙을 이해하여 코드 어셈블리의 어떤 부분을 스트리핑할지 결정합니다.

Unity linker는 정적 분석을 수행할 때 빌드에 필요한 것으로 표시할 CIL 바이트코드의 일부를 결정하기 위해 일련의 규칙을 따릅니다.

* Unity linker가 빌드의 최상위 수준 어셈블리를 식별하고 보존하는 방식을 결정하는 [루트 마킹 규칙](#root-marking-rules)입니다.
* [종속성 마킹 규칙](#dependency-marking-rules)은 Unity linker가 루트 어셈블리가 의존하는 코드를 식별하고 보존하는 방식을 결정합니다.

[설정된 관리되는 스트리핑 레벨](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)은 Unity linker가 사용하는 규칙 집합을 변경합니다. 다음 섹션에서는 각 관리되는 스트리핑 레벨 마킹 규칙에 대해 설명합니다.

## 루트 마킹 규칙##root-marking-rules

다음 표는 Unity linker가 다양한 어셈블리 타입과 관리되는 스트리핑 레벨에 대한 어셈블리의 최상위 타입을 식별하는 방법을 설명합니다.

| **구성 유형**                                        | **관리되는 스트리핑 레벨에서 루트 마킹 규칙**                                                                                                                                                                                                                                        |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **.NET Class & Platform SDK 및 UnityEngine 어셈블리** | **최소** 및 **낮음**:예방적 보존**최소**, **낮음**, **중간**, **높음**:모든 `link.xml` 파일에 정의된 보존                                                                                                                                                                                      |
| **씬에서 참조된 타입의 어셈블리**                             | **최소** 및 **낮음**:어셈블리의 모든 타입 및 멤버**중간** 및 **높음**:`[RuntimeInitializeOnLoadMethod]` 또는 `[Preserve]` 속성이 있는 모든 메서드입니다.모든 `link.xml` 파일에 정의된 보존미리 컴파일된 패키지, Unity 스크립트 또는 어셈블리 정의 어셈블리에서 MonoBehaviour 및 ScriptableObject에서 파생된 모든 타입입니다.                              |
| **기타**                                           | **최소**어셈블리의 모든 타입 및 멤버**낮음** 및 **중간**:모든 공용 타입 및 해당 타입의 공용 멤버**중간** 및 **높음**:`[RuntimeInitializeOnLoadMethod]` 또는 `[Preserve]` 속성이 있는 모든 메서드입니다.모든 `link.xml` 파일에 정의된 보존미리 컴파일된 패키지, Unity 스크립트 또는 어셈블리 정의 어셈블리에서 MonoBehaviour 및 ScriptableObject에서 파생된 모든 타입입니다. |
| **테스트**                                          | **최소**, **낮음**, **중간**, **높음**:`[UnityTest]` 속성이 있는 모든 메서드와 NUnit.Framework에 정의된 속성으로 주석이 지정된 모든 메서드입니다.                                                                                                                                                           |

## 종속성 마킹 규칙##dependency-marking-rules

Unity linker가 어셈블리의 루트를 식별한 후 해당 루트가 의존하는 코드를 식별해야 합니다. 다음 표는 Unity linker가 다양한 관리되는 스트리핑 레벨에서 어셈블리의 루트 타입의 종속성을 식별하는 방법을 설명합니다.

| **규칙 타겟**                 | **관리되는 스트리핑 수준에서 종속성 마킹 규칙**                                                                                                                                                                                                |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **MonoBehaviour**         | **최소**, **낮음**, **중간**, **높음**:Unity linker는 유형을 표시할 때 MonoBehavior 유형의 모든 멤버를 마킹합니다.                                                                                                                                       |
| **ScriptableObject**      | **최소**, **낮음**, **중간**, **높음**:Unity linker는 유형을 표시할 때 ScriptableObject 타입의 모든 멤버를 마킹합니다.                                                                                                                                   |
| **속성**                    | **최소** 및 **낮음**:Unity linker가 어셈블리, 타입 또는 기타 코드 구조를 마킹할 때 해당 구조의 모든 속성을 마킹합니다.**중간** 및 **높음**:Unity linker가 어셈블리, 타입 또는 기타 코드 구조를 마킹하는 경우 속성 타입도 마킹된 경우에만 해당 구조의 속성을 마킹합니다.                                                 |
| **디버깅 속성**                | **최소** 및 **낮음**:스크립트 디버깅을 활성화하면 해당 멤버를 사용하는 코드 경로가 없더라도 Unity linker는 `[DebuggerDisplay]` 속성이 있는 모든 멤버를 마킹합니다.**중간** 및 **높음**:Unity linker는 항상 `DebuggerDisplayAttribute` 및 `DebuggerTypeProxyAttribute`와 같은 디버깅 속성을 제거합니다. |
| **.NET Facade 클래스 라이브러리** | **최소**, **낮음**, **중간**, **높음**:런타임 시 필요하지 않으므로 페사드 어셈블리를 제거합니다.                                                                                                                                                             |

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