---
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/restrictions
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/restrictions.md
generated_at: 2026-11-19T13:51:58.529Z
locale: ko-kr
---

# IL2CPP 제한 사항

> IL2CPP를 스크립팅 백엔드로 사용할 때 일부 AOT 플랫폼에 적용되는 제한 사항을 이해합니다.

IL2CPP 백엔드에는 AOT(Ahead-of-Time) 컴파일의 고유한 특성과 플랫폼별 제한으로 DUE 몇 가지 중요한 제한 사항이 있습니다.

## 스레드##threads

관리되는 스레드는 웹 플랫폼에서 지원되지 않습니다. [`System.Threading`](https://learn.microsoft.com/en-us/dotnet/api/system.threading?view=net-9.0) 네임스페이스의 대부분의 API는 효과 없이 실행되거나 작동하지 않습니다. 또한 .NET 클래스 라이브러리의 일부는 암시적으로 스레드에 의존합니다. 일반적인 예는 스레드 지원에 의존하는 [`System.Timers.Timer`](https://learn.microsoft.com/en-us/dotnet/api/system.timers.timer?view=net-9.0) 클래스입니다. 자세한 내용은 웹 플랫폼의 [.NET API 지원](/engine/6000.0/manual/platform-specific/webgl/develop/web-dotnet-api-support.md)을 참고하십시오.

## 반사##reflection

Unity AOT 플랫폼에서 반사를 지원합니다. 하지만 컴파일러가 반사를 통해 코드가 사용되었음을 추론할 수 없는 경우 런타임 시 코드가 존재하지 않을 수 있습니다. 자세한 내용은 [관리되는 코드 스트리핑](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping.md)을 참조하십시오.

AOT 플랫폼은 [`System.Reflection.Emit`](https://learn.microsoft.com/en-us/dotnet/api/system.reflection.emit?view=net-9.0) 네임스페이스에 있는 메서드를 구현할 수 없습니다.

## 예외 필터##exception-filters

IL2CPP는 예외 필터를 지원합니다. 그러나 IL2CPP는 C++ 예외를 사용하여 관리된 예외를 구현하기 때문에 필터 문과 `catch` 블록의 실행 순서는 다릅니다. 필드에 필터 블록이 쓰지 않는 한 눈에 띄지 않습니다.

Mono에서 필드 쓰기는 필터 평가 시점, `catch` 블록에 들어가기 전에 다른 필터에 대한 정의된 순서로 수행됩니다. IL2CPP에서는 필드 쓰기가 시뮬레이션되기 때문에 다른 시간에 발생할 수 있습니다. 이는 다음과 같은 눈에 띄는 차이를 리드 수 있습니다.

* `catch` 또는 `finally` 블록에 대한 예상보다 빨리 또는 늦게 업데이트되는 필드입니다.
* 여러 필터가 있는 경우 서로 다른 인터리빙이 가능하며, 어떤 업데이트가 먼저 표시되는지 변경할 수 있습니다.
* `catch` 또는 `finally`의 게이트 동작에 대한 필터 부작용에 의존하는 코드가 오래되거나 순서가 다른 값을 볼 경우가 드물습니다.

IL2CPP 및 Mono 전반에서 일관된 동작을 보장하기 위해 상태 변경 사항을 `catch` 블록(또는 `catch`에서 호출된 헬퍼 함수)으로 이동하여 필터의 부작용을 방지하는 것이 가장 좋습니다.

## Serialization##serialization

AOT 플랫폼은 반사 사용으로 인해 Serialization 및 역직렬화에 문제가 발생할 수 있습니다. 타입 또는 메서드가 Serialization 또는 역직렬화의 일환으로 반사를 통해서만 사용되는 경우 AOT 컴파일러는 타입 또는 메서드에 필요한 코드를 생성해야 한다는 것을 감지할 수 없습니다.

## 일반 타입 및 메서드##generic-types-and-methods

일반 타입 및 메서드의 경우, 다른 일반 인스턴스에 다른 코드가 필요할 수 있으므로 컴파일러는 어떤 일반 인스턴스를 사용할지 결정해야 합니다. 예를 들어, `List<int>`의 코드는 `List<double>`의 코드와 다릅니다. 그러나 IL2CPP는 레퍼런스 유형의 사용을 위한 코드를 공유하므로 `List<object>` 및 `List<string>`에 동일한 코드가 사용됩니다.

다음과 같은 경우 IL2CPP가 컴파일 시점에 찾지 못한 일반 타입 및 메서드를 참조할 수 있습니다.

1. 런타임 시 새 일반 인스턴스 생성: `Activator.CreateInstance(typeof(SomeGenericType<>).MakeGenericType(someType));`
2. 일반 인스턴스에서 정적 메서드 호출: `typeof(SomeGenericType<>).MakeGenericType(someType).GetMethod("AMethod").Invoke(null, null);`
3. 정적 제네릭 메서드 호출: `typeof(SomeType).GetMethod("GenericMethod").MakeGenericMethod(someType).Invoke(null, null);`
4. 컴파일 시점에 추론할 수 없는 일반 가상 함수를 호출하는 경우가 있습니다.
5. 깊게 중첩된 일반 값 타입(예: `Struct<Struct<Struct<...<Struct<int>>>>`)이 있는 호출.

이러한 경우를 지원하기 위해 IL2CPP는 모든 타입의 파라미터와 함께 작동하는 일반 코드를 생성합니다. 그러나 이 코드는 타입의 크기 또는 레퍼런스 또는 값 타입인지 결정할 수 없으므로 속도가 느려집니다. 더 빠른 일반 메서드가 생성되도록 하려면 다음을 수행하십시오.

* 일반 인수가 항상 레퍼런스 유형인 경우, `where: class` 제약을 추가합니다. 그런 다음 IL2CPP는 레퍼런스 타입 공유를 사용하여 폴백 메서드를 생성하여 성능 저하를 일으키지 않습니다.
* 일반 인수가 항상 값 유형인 경우, `where: struct` 제약을 추가합니다. 이를 통해 최적화를 일부 수행할 수 있지만, 값 유형이 서로 다른 크기일 수 있으므로 코드 속도가 더 느려집니다.
* `UsedOnlyForAOTCodeGeneration`라는 메서드를 생성하고 IL2CPP가 생성할 일반 타입 및 메서드에 대한 레퍼런스를 추가합니다. 이 메서드를 호출할 필요는 없습니다. 다음 예시에서는 `GenericType<MyStruct>` 전문화를 생성합니다.

```lang-cs
public void UsedOnlyForAOTCodeGeneration()
{
    // Ensure that IL2CPP will create code for MyGenericStruct
    // using MyStruct as an argument.
    new GenericType<MyStruct>();

    // Ensure that IL2CPP will create code for SomeType.GenericMethod
    // using MyStruct as an argument.
    new SomeType().GenericMethod<MyStruct>();

	public void OnMessage<T>(T value) 
	{
		Debug.LogFormat("Message value: {0}", value);
	}

    // Include an exception so we can be sure to know if this
    // method is ever called.
    throw new InvalidOperationException(
        "이 메서드는 AOT 코드 생성에만 사용됩니다." +
        "런타임 시 호출하지 마십시오.");
}
```

> **Note:**
>
> 전체 공유 가능한 단일 버전의 일반 코드만 컴파일하려면 **IL2CPP Code Generation** [플레이어 설정](/engine/6000.0/manual/unity-editor/editor-settings-reference/comp-manager-group/class-player-settings.md)을 **Optimize for code size and build time**으로 설정하십시오. 이렇게 하면 생성되는 메서드의 수가 줄어들고 컴파일 시간과 빌드 크기가 단축되지만 런타임 성능이 저하됩니다.

## 네이티브 코드에서 관리되는 메서드 호출##calling-managed-methods-from-native-code

네이티브 코드에서 호출할 수 있도록 C 함수 포인터로 마셜링해야 하는 관리되는 메서드는 AOT 플랫폼에서 몇 가지 제한 사항이 있습니다.

* 관리되는 메서드는 정적 메서드여야 합니다.
* 관리되는 메서드에는 `[MonoPInvokeCallback]` 속성이 있어야 합니다.
* 관리되는 메서드가 일반적인 경우, 지원해야 하는 일반적인 전문화를 지정하려면 `[MonoPInvokeCallback(Type)]` 오버로드를 사용해야 할 수 있습니다. 이 경우 유형은 올바른 수의 일반 인수가 포함된 일반 인스턴스여야 합니다. 다음과 같이 메서드에 여러 `[MonoPInvokeCallback]` 속성을 가질 수 있습니다.

```lang-cs
// Generates reverse P/Invoke wrappers for NameOf<long> and NameOf<int>
// Note that the types are only used to indicate the generic arguments.
[MonoPInvokeCallback(typeof(Action<long>))]
[MonoPInvokeCallback(typeof(Action<int>))]
private static 문자열 NameOfT<T>(T 항목) 
{
    return typeof(T).Name;
}
```

## 지원되지 않는 .NET API##unsupported-.net-apis

IL2CPP는 다음 .NET API 및 기능을 지원하지 않습니다.

* [`MarshalAs`](https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.marshalasattribute?view=net-9.0) 및 [`FieldOffset`](https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.fieldoffsetattribute?view=net-9.0) 속성의 반사 컴파일 시 이러한 속성을 지원합니다. 적절한 [플랫폼 호출 마셜링](https://docs.microsoft.com/en-us/dotnet/framework/interop/marshaling-data-with-platform-invoke)에 사용해야 합니다.
* C# [`dynamic`](https://learn.microsoft.com/en-us/dotnet/csharp/advanced-topics/interop/using-type-dynamic) 키워드입니다. 이 키워드는 JIT 컴파일이 필요하며, IL2CPP에서는 불가능합니다.
* [`Marshal.Prelink`](https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.marshal.prelink?view=net-9.0) 또는 [`Marshal.PrelinkAll`](https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.marshal.prelinkall?view=net-10.0) API 메서드
* [](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.process?view=net-9.0)API 메서드

데스크톱 플랫폼에서 필요한 경우에는 [Mono 스크립팅 백엔드](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/mono.md)를 사용하십시오.

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

* [Unity .NET 기능](/engine/6000.0/manual/scripting/environment-and-tools/overview-of-dot-net-in-unity.md)
