---
title: IL2CPP 런타임 코드 확인
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/backends/il2cpp/il2cpp-runtime-checks
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-runtime-checks.md
generated_at: 2026-11-19T13:51:51.154Z
locale: ko-kr
---

# IL2CPP 런타임 코드 확인

> null 레퍼런스 및 바운드 외 검사와 같은 런타임 안전 기능을 포함하거나 비활성화하도록 IL2CPP의 C++ 생성을 구성합니다.

`[Il2CppSetOption]` C# 속성과 해당 `Option` 파라미터를 사용하여 IL2CPP 컴파일러가 생성하는 C++ 코드에 포함하는 안전 검사를 제어할 수 있습니다.

`[Il2CppSetOption]` 속성은 표준 Unity 에디터 및 엔진 공용 API의 일부가 아니지만 Unity 설치의 일부로 소스가 별도로 제공됩니다. `[Il2CppSetOption]` 속성을 사용하려면 다음과 같이 하십시오.

1. Unity 버전이 설치된 디렉토리에서 Windows의 경우 `Data\il2cpp` 디렉토리 또는 macOS의 경우 `Contents/Frameworks/il2cpp` 디렉토리로 이동합니다.
2. `Il2CppSetOptionAttribute.cs` 소스 파일을 찾습니다.
3. 소스 파일을 프로젝트의 `Assets` 폴더에 복사합니다.

속성에 대해 지원되는 옵션은 다음과 같습니다.

| **프로퍼티**       | **설명**                                                                                                                                                                                                                                                                                                              | **Default** |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| **Null 체크**    | 이 옵션을 활성화한 상태로 유지하는 것이 좋습니다. 비활성화하면 IL2CPP는 null 확인 없이 C++를 생성하며 관리되는 `NullReferenceException` 예외는 발생하지 않습니다. 이렇게 하면 런타임 성능을 개선할 수 있지만, null 값에 액세스하려는 시도는 차단되지 않으므로 크래시를 비롯한 의도치 않은 동작이 리드 수 있습니다.                                                                                                                 | 활성화됨        |
| **어레이 경계 확인**  | 이 옵션을 활성화한 상태로 유지하는 것이 좋습니다. 비활성화하면 IL2CPP는 배열 바운드 확인 없이 C++를 생성하며 관리되는 `IndexOutOfRangeException` 예외는 발생하지 않습니다. 이렇게 하면 런타임 성능이 향상될 수 있지만, 잘못된 인덱스가 포함된 배열에 코드가 액세스할 수 있으므로 임의의 메모리 위치에서 읽거나 쓰기 등 잘못된 동작이 리드 수 있습니다. 대부분의 경우 이러한 메모리 액세스는 즉각적인 부작용 없이 발생하며, 명확한 경고 표시 없이 애플리케이션 상태가 손상되어 오류를 디버깅하기가 매우 어려울 수 있습니다. | 활성화됨        |
| **검사 0으로 나누기** | 0 체크표로 나누기를 실행해야 하는 경우를 제외하고 이 옵션을 비활성화 상태로 유지합니다. 활성화하면 IL2CPP는 정수 분할에 대해 0으로 나누기 확인이 포함된 C++를 생성하고 필요한 경우 관리되는 `DivideByZeroException` 예외를 발생시킵니다. 이 옵션을 비활성화하면 IL2CPP가 생성된 C++ 코드에 정수 분할을 0으로 확인하여 분할하지 않습니다.이러한 확인은 런타임 시 성능에 영향을 미칩니다.                                                                         | Disabled    |

다음 예시는 `[Il2CppSetOption]` 속성을 사용하는 방법을 보여 줍니다.

```lang-cs
[Il2CppSetOption(Option.NullChecks, false)]
public static string MethodWithNullChecksDisabled()
{
    var tmp = new object();
    return tmp.ToString();
}
```

어셈블리, 타입, 메서드 및 프로퍼티에 `[Il2CppSetOption]`를 적용할 수 있습니다. Unity 가장 로컬 범위의 속성을 사용합니다.

```lang-cs
[Il2CppSetOption(Option.NullChecks, false)]
public class TypeWithNullChecksDisabled
{
    public static string AnyMethod()
    {
        // Unity doesn’t perform null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }

    [Il2CppSetOption(Option.NullChecks, true)]
    public static string MethodWithNullChecksEnabled()
    {
        // Unity performs null checks in this method.
        var tmp = new object();
        return tmp.ToString();
    }
}

public class SomeType
{
    [Il2CppSetOption(Option.NullChecks, false)]
    public string PropertyWithNullChecksDisabled
    {
        "GET",
        {
            // Unity doesn't perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        세트
        {
            // Unity doesn't perform null checks here.
            value.ToString();
        }
    }

    public string PropertyWithNullChecksDisabledOnGetterOnly
    {
        [Il2CppSetOption(Option.NullChecks, false)]
        "GET",
        {
            // Unity doesn’t perform null checks here.
            var tmp = new object();
            return tmp.ToString();
        }
        세트
        {
            // Unity performs null checks here.
            value.ToString();
        }
    }
}
```

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

* [IL2CPP 관리 스택 추적 참조](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-managed-stack-traces.md)
* [IL2CPP 추가 인자 참조](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/handling-il2cpp-additional-args.md)
