기술 자료

Unity 엔진

Unity 엔진

IL2CPP 관리 스택 추적

더 많은 정보를 제공하는 관리되는 스택 추적을 생성하도록 IL2CPP 컴파일러 설정을 구성하여 더 쉽게 디버깅할 수 있습니다.
읽는 시간 2분최근 업데이트: 9일 전

관리되는 코드에서 예외가 발생하면 예외의 스택 추적을 통해 예외의 원인을 파악할 수 있습니다. 하지만 관리되는 스택 추적은 경우에 따라 예상대로 표시되지 않을 수 있습니다. 스택 추적은 빌드 구성에 따라 달라집니다.

C++ 컴파일러 설정

다음 방법 중 하나로 IL2CPP 빌드에 대한 C++ 컴파일러 구성을 설정할 수 있습니다.
  • 에디터의
    플레이어 설정

    ?

    메뉴를 통해 다음 단계를 수행하여 플레이어 설정 메뉴를 통해 스크립팅 백엔드를 변경합니다.
    1. 편집 >
      프로젝트 설정

      ?

      로 이동합니다.
    2. 플레이어 설정 버튼을 클릭하여 현재 플랫폼의 플레이어 설정을 인스펙터에서 엽니다.
    3. 기타 설정 하위 메뉴의 설정 섹션으로 이동합니다.
    4. C++ Compiler Configuration 프로퍼티를 Debug, Release 또는 Master로 설정합니다.
  • 코드에서
    Il2CppCompilerConfiguration
    열거형의 값으로
    PlayerSettings.SetIl2CppCompilerConfiguration
    를 호출합니다.
이 설정은 관리되는 스택 추적에 다음과 같은 영향을 미칩니다.
  • --debug IL2CPP는 신뢰할 수 있는 관리되는 스택 추적을 보고하며, 각 관리되는 메서드를 호출 스택에 포함합니다. 스택 추적에는 원본 C# 소스 코드의 행 숫자가 포함되지 않습니다.
  • 릴리스 또는 마스터: IL2CPP가 하나 이상의 관리되는 메서드가 누락된 호출 스택을 생성할 수 있습니다. 이는 C++ 컴파일러가 누락된 메서드를 인라이닝할 때 발생합니다. 메서드 인라이닝은 일반적으로 런타임 성능을 개선하지만, 호출 스택을 이해하기 어려울 수 있습니다.
IL2CPP는 항상 호출 스택에 하나 이상의 관리되는 메서드를 제공합니다. 관리되는 예외에서 생성된 스택 트레이스의 경우, 이는 예외가 발생한 메서드입니다. 인라인이 아닌 다른 메서드도 포함됩니다.

IL2CPP 스택 추적 정보

다음 방법 중 하나로 관리되는 스택 추적에 파일 및 줄 번호 정보를 포함하도록 IL2CPP를 구성할 수 있습니다.

The IL2CPP Stacktrace Information property, set to Method Name, File Name, and Line Number

이 설정은 IL2CPP가 호출 스택에 모든 관리되는 스택 프레임을 포함하도록 명령합니다. 또한 해당 코드가 존재하는 관리되는 어셈블리(.dll)에 대해 관리되는 기호 파일(.pdb)을 사용할 수 있는 한 각 스택 프레임에는 적절한 C# 줄 번호도 포함됩니다.
이 기능을 활성화하면 빌드 시간과 빌드된 프로그램의 최종 크기가 약간 증가합니다. 플레이어 빌드 프로세스는 디버그 기호 파일을 처리하고 필요한 기호 형성을 포함하는 새 데이터 파일을 생성하는 추가 단계를 포함합니다. Unity 이 데이터 파일을 빌드된 플레이어와 함께 제공하고 런타임 시 사용하여 호출 스택의 C# 줄 정보를 결정합니다.
이 기능을 활성화하면 Unity는 메서드 인라이닝이 활성화된 경우에도 릴리스 또는 마스터 구성에서 올바른 호출 스택을 생성합니다.

스크립트 디버깅

스크립트 디버깅을 활성화하려면 파일 > 빌드 프로파일으로 이동한 다음 스크립트 디버깅 체크박스를 활성화합니다. 스크립트 디버깅이 활성화되면 IL2CPP는 메서드, 파일, 줄 번호와 함께 올바른 관리되는 스택 추적을 보고합니다. 이로 인해 프로그램 크기가 커지고 성능이 저하됩니다.
팁
스택 추적만 개선하려면 스크립트 디버깅을 활성화하지 마십시오. 대신 위에서 설명한 대로 소스 코드 줄 번호를 활성화합니다.

추가 리소스