기술 자료

Unity 엔진

Unity 엔진

IL2CPP 런타임 코드 확인

null 레퍼런스 및 바운드 외 검사와 같은 런타임 안전 기능을 포함하거나 비활성화하도록 IL2CPP의 C++ 생성을 구성합니다.
읽는 시간 2분최근 업데이트: 9일 전

[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]
속성을 사용하는 방법을 보여 줍니다.
[Il2CppSetOption(Option.NullChecks, false)]public static string MethodWithNullChecksDisabled(){ var tmp = new object(); return tmp.ToString();}
어셈블리, 타입, 메서드 및 프로퍼티에
[Il2CppSetOption]
를 적용할 수 있습니다. Unity 가장 로컬 범위의 속성을 사용합니다.
[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(); } }}

추가 리소스