기술 자료

Unity 엔진

Unity 엔진

IL2CPP 제한 사항

IL2CPP를 스크립팅 백엔드로 사용할 때 일부 AOT 플랫폼에 적용되는 제한 사항을 이해합니다.
읽는 시간 4분최근 업데이트: 9일 전

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

스레드

관리되는 스레드는 웹 플랫폼에서 지원되지 않습니다.
System.Threading
네임스페이스의 대부분의 API는 효과 없이 실행되거나 작동하지 않습니다. 또한 .NET 클래스 라이브러리의 일부는 암시적으로 스레드에 의존합니다. 일반적인 예는 스레드 지원에 의존하는
System.Timers.Timer
클래스입니다. 자세한 내용은 웹 플랫폼의 .NET API 지원을 참고하십시오.

반사

Unity AOT 플랫폼에서 반사를 지원합니다. 하지만 컴파일러가 반사를 통해 코드가 사용되었음을 추론할 수 없는 경우 런타임 시 코드가 존재하지 않을 수 있습니다. 자세한 내용은 관리되는 코드 스트리핑을 참조하십시오.
AOT 플랫폼은
System.Reflection.Emit
네임스페이스에 있는 메서드를 구현할 수 없습니다.

예외 필터

IL2CPP는 예외 필터를 지원합니다. 그러나 IL2CPP는 C++ 예외를 사용하여 관리된 예외를 구현하기 때문에 필터 문과
catch
블록의 실행 순서는 다릅니다. 필드에 필터 블록이 쓰지 않는 한 눈에 띄지 않습니다.
Mono에서 필드 쓰기는 필터 평가 시점,
catch
블록에 들어가기 전에 다른 필터에 대한 정의된 순서로 수행됩니다. IL2CPP에서는 필드 쓰기가 시뮬레이션되기 때문에 다른 시간에 발생할 수 있습니다. 이는 다음과 같은 눈에 띄는 차이를 리드 수 있습니다.
  • catch
    또는
    finally
    블록에 대한 예상보다 빨리 또는 늦게 업데이트되는 필드입니다.
  • 여러 필터가 있는 경우 서로 다른 인터리빙이 가능하며, 어떤 업데이트가 먼저 표시되는지 변경할 수 있습니다.
  • catch
    또는
    finally
    의 게이트 동작에 대한 필터 부작용에 의존하는 코드가 오래되거나 순서가 다른 값을 볼 경우가 드물습니다.
IL2CPP 및 Mono 전반에서 일관된 동작을 보장하기 위해 상태 변경 사항을
catch
블록(또는
catch
에서 호출된 헬퍼 함수)으로 이동하여 필터의 부작용을 방지하는 것이 가장 좋습니다.

Serialization

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

일반 타입 및 메서드

일반 타입 및 메서드의 경우, 다른 일반 인스턴스에 다른 코드가 필요할 수 있으므로 컴파일러는 어떤 일반 인스턴스를 사용할지 결정해야 합니다. 예를 들어,
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>
    전문화를 생성합니다.
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 코드 생성에만 사용됩니다." + "런타임 시 호출하지 마십시오.");}
참고
전체 공유 가능한 단일 버전의 일반 코드만 컴파일하려면 IL2CPP Code Generation 플레이어 설정을 Optimize for code size and build time으로 설정하십시오. 이렇게 하면 생성되는 메서드의 수가 줄어들고 컴파일 시간과 빌드 크기가 단축되지만 런타임 성능이 저하됩니다.

네이티브 코드에서 관리되는 메서드 호출

네이티브 코드에서 호출할 수 있도록 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 및 기능을 지원하지 않습니다.
데스크톱 플랫폼에서 필요한 경우에는 Mono 스크립팅 백엔드를 사용하십시오.

추가 리소스