IL2CPP 제한 사항
IL2CPP를 스크립팅 백엔드로 사용할 때 일부 AOT 플랫폼에 적용되는 제한 사항을 이해합니다.
읽는 시간 4분최근 업데이트: 9일 전
IL2CPP 백엔드에는 AOT(Ahead-of-Time) 컴파일의 고유한 특성과 플랫폼별 제한으로 DUE 몇 가지 중요한 제한 사항이 있습니다.
스레드
관리되는 스레드는 웹 플랫폼에서 지원되지 않습니다. 네임스페이스의 대부분의 API는 효과 없이 실행되거나 작동하지 않습니다. 또한 .NET 클래스 라이브러리의 일부는 암시적으로 스레드에 의존합니다. 일반적인 예는 스레드 지원에 의존하는 클래스입니다. 자세한 내용은 웹 플랫폼의 .NET API 지원을 참고하십시오.
System.ThreadingSystem.Timers.Timer반사
Unity AOT 플랫폼에서 반사를 지원합니다. 하지만 컴파일러가 반사를 통해 코드가 사용되었음을 추론할 수 없는 경우 런타임 시 코드가 존재하지 않을 수 있습니다. 자세한 내용은 관리되는 코드 스트리핑을 참조하십시오.
AOT 플랫폼은 네임스페이스에 있는 메서드를 구현할 수 없습니다.
System.Reflection.Emit예외 필터
IL2CPP는 예외 필터를 지원합니다. 그러나 IL2CPP는 C++ 예외를 사용하여 관리된 예외를 구현하기 때문에 필터 문과 블록의 실행 순서는 다릅니다. 필드에 필터 블록이 쓰지 않는 한 눈에 띄지 않습니다.
catchMono에서 필드 쓰기는 필터 평가 시점, 블록에 들어가기 전에 다른 필터에 대한 정의된 순서로 수행됩니다. IL2CPP에서는 필드 쓰기가 시뮬레이션되기 때문에 다른 시간에 발생할 수 있습니다. 이는 다음과 같은 눈에 띄는 차이를 리드 수 있습니다.
catch- 또는
catch블록에 대한 예상보다 빨리 또는 늦게 업데이트되는 필드입니다.finally - 여러 필터가 있는 경우 서로 다른 인터리빙이 가능하며, 어떤 업데이트가 먼저 표시되는지 변경할 수 있습니다.
- 또는
catch의 게이트 동작에 대한 필터 부작용에 의존하는 코드가 오래되거나 순서가 다른 값을 볼 경우가 드물습니다.finally
IL2CPP 및 Mono 전반에서 일관된 동작을 보장하기 위해 상태 변경 사항을 블록(또는 에서 호출된 헬퍼 함수)으로 이동하여 필터의 부작용을 방지하는 것이 가장 좋습니다.
catchcatchSerialization
AOT 플랫폼은 반사 사용으로 인해 Serialization 및 역직렬화에 문제가 발생할 수 있습니다. 타입 또는 메서드가 Serialization 또는 역직렬화의 일환으로 반사를 통해서만 사용되는 경우 AOT 컴파일러는 타입 또는 메서드에 필요한 코드를 생성해야 한다는 것을 감지할 수 없습니다.
일반 타입 및 메서드
일반 타입 및 메서드의 경우, 다른 일반 인스턴스에 다른 코드가 필요할 수 있으므로 컴파일러는 어떤 일반 인스턴스를 사용할지 결정해야 합니다. 예를 들어, 의 코드는 의 코드와 다릅니다. 그러나 IL2CPP는 레퍼런스 유형의 사용을 위한 코드를 공유하므로 및 에 동일한 코드가 사용됩니다.
List<int>List<double>List<object>List<string>다음과 같은 경우 IL2CPP가 컴파일 시점에 찾지 못한 일반 타입 및 메서드를 참조할 수 있습니다.
- 런타임 시 새 일반 인스턴스 생성:
Activator.CreateInstance(typeof(SomeGenericType<>).MakeGenericType(someType)); - 일반 인스턴스에서 정적 메서드 호출:
typeof(SomeGenericType<>).MakeGenericType(someType).GetMethod("AMethod").Invoke(null, null); - 정적 제네릭 메서드 호출:
typeof(SomeType).GetMethod("GenericMethod").MakeGenericMethod(someType).Invoke(null, null); - 컴파일 시점에 추론할 수 없는 일반 가상 함수를 호출하는 경우가 있습니다.
- 깊게 중첩된 일반 값 타입(예: )이 있는 호출.
Struct<Struct<Struct<...<Struct<int>>>>
이러한 경우를 지원하기 위해 IL2CPP는 모든 타입의 파라미터와 함께 작동하는 일반 코드를 생성합니다. 그러나 이 코드는 타입의 크기 또는 레퍼런스 또는 값 타입인지 결정할 수 없으므로 속도가 느려집니다. 더 빠른 일반 메서드가 생성되도록 하려면 다음을 수행하십시오.
- 일반 인수가 항상 레퍼런스 유형인 경우, 제약을 추가합니다. 그런 다음 IL2CPP는 레퍼런스 타입 공유를 사용하여 폴백 메서드를 생성하여 성능 저하를 일으키지 않습니다.
where: class - 일반 인수가 항상 값 유형인 경우, 제약을 추가합니다. 이를 통해 최적화를 일부 수행할 수 있지만, 값 유형이 서로 다른 크기일 수 있으므로 코드 속도가 더 느려집니다.
where: struct - 라는 메서드를 생성하고 IL2CPP가 생성할 일반 타입 및 메서드에 대한 레퍼런스를 추가합니다. 이 메서드를 호출할 필요는 없습니다. 다음 예시에서는
UsedOnlyForAOTCodeGeneration전문화를 생성합니다.GenericType<MyStruct>
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 코드 생성에만 사용됩니다." + "런타임 시 호출하지 마십시오.");}
네이티브 코드에서 관리되는 메서드 호출
네이티브 코드에서 호출할 수 있도록 C 함수 포인터로 마셜링해야 하는 관리되는 메서드는 AOT 플랫폼에서 몇 가지 제한 사항이 있습니다.
- 관리되는 메서드는 정적 메서드여야 합니다.
- 관리되는 메서드에는 속성이 있어야 합니다.
[MonoPInvokeCallback] - 관리되는 메서드가 일반적인 경우, 지원해야 하는 일반적인 전문화를 지정하려면 오버로드를 사용해야 할 수 있습니다. 이 경우 유형은 올바른 수의 일반 인수가 포함된 일반 인스턴스여야 합니다. 다음과 같이 메서드에 여러
[MonoPInvokeCallback(Type)]속성을 가질 수 있습니다.[MonoPInvokeCallback]
// 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
IL2CPP는 다음 .NET API 및 기능을 지원하지 않습니다.
- 및
MarshalAs속성의 반사 컴파일 시 이러한 속성을 지원합니다. 적절한 플랫폼 호출 마셜링에 사용해야 합니다.FieldOffset - C# 키워드입니다. 이 키워드는 JIT 컴파일이 필요하며, IL2CPP에서는 불가능합니다.
dynamic - 또는
Marshal.PrelinkAPI 메서드Marshal.PrelinkAll - API 메서드
데스크톱 플랫폼에서 필요한 경우에는 Mono 스크립팅 백엔드를 사용하십시오.