기술 자료

Unity 엔진

Unity 엔진

추가 IL2CPP 컴파일러 인자

코드에서 IL2CPP 컴파일러에 커스텀 추가 인자를 제공합니다.
읽는 시간 2분최근 업데이트: 9일 전

PlayerSettings.SetAdditionalIl2CppArgs
API를 사용하거나
IL2CPP_ADDITIONAL_ARGS
환경 변수를 설정하여 IL2CPP 컴파일러에 대한 추가 인자를 제공할 수 있습니다.
경고
추가 인수를 IL2CPP 컴파일러에 전달하는 것은 복잡한 프로젝트에서 IL2CPP 코드 생성을 디버깅하고 최적화하는 실험 기능입니다. 진단 스위치와 마찬가지로 Unity 지원 팀과 협력하여 고급 개발자가 사용할 수 있습니다. 인수는 해석 없이 C++ 컴파일러에 직접 전달되므로 빌드가 중단될 위험이 높습니다. Unity 사전 고지 없이 이 기능을 변경하거나 제거할 수 있습니다.
다음 표에는 IL2CPP 컴파일러에 추가 플래그를 제공하는 데 사용할 수 있는 인수가 나와 있습니다.

인수

설명

--compiler-flags="<flags>"
추가 플래그를 C++ 컴파일러에 전달합니다.
<flags>
를 원하는 플래그로 교체합니다. 예를 들어,
--compiler-flags=\"COMPILER_FLAG_1 COMPILER_FLAG_2\"
는 컴파일러 플래그
COMPILER_FLAG_1
및
COMPILER_FLAG_2
를 C++ 컴파일러에 전달합니다.
--linker-flags="<flags>"
추가 플래그를 링커에 전달합니다.
<flags>
를 원하는 플래그로 교체합니다. 예를 들어,
--linker-flags="\LINKER_FLAG_1 LINKER_FLAG_2\"
는 링커 플래그
LINKER_FLAG_1
및
LINKER_FLAG_2
를 링커에 전달합니다.
여러 인수는 다음과 같이 공백으로 구분되어야 합니다.
PlayerSettings.SetAdditionalIl2CppArgs("--compiler-flags=\"COMPILER_FLAG_1 COMPILER_FLAG_2\" --linker-flags="\LINKER_FLAG_1 LINKER_FLAG_2\"");
참고
SetAdditionalIl2CppArgs
를 두 번 이상 호출하면 이전에 제공된 모든 플래그를 덮어씁니다. 빈 문자열을 이 메서드에 전달하여 이전에 제공된 추가 인자를 제거합니다.
유효한 컴파일러 및 링커 플래그는 플랫폼에 따라 IL2CPP가 해당 플랫폼에서 사용하는 기본 C++ 컴파일러(msvc 또는 clang)에 따라 다릅니다. 유효한 컴파일러 및 링커 옵션 리스트는 msvc 컴파일러, 링커 옵션 또는 클랜 컴파일러 및 링커 옵션에 대한 관련 타사 문서를 참조하십시오.

인수가 설정되었는지 확인합니다.

프로젝트에 추가 IL2CPP 인수가 설정되어 있다면 두 개 이상의 플랫폼에 대해 컴파일하는 것이 예상대로 작동하지 않을 수 있습니다. 특히 Linux용 크로스 컴파일을 수행할 때 말이죠.
추가 IL2CPP 인수가 이미 설정되어 있는지 확인하려면 다음 중 하나를 수행하십시오.
  • 환경 변수
    IL2CPP_ADDITIONAL_ARGS
    가 설정되었는지 확인합니다.
  • ProjectSettings/ProjectSettings.asset
    에서 에디터 스크립트에
    additionalIl2CppArgs
    라는 값이 있는지 확인합니다.
중요
추가 IL2CPP 인수가 전역적으로 적용되므로 원하는 플랫폼이 아닌 플랫폼에 대해 설정하면 컴파일 문제가 발생할 수 있습니다.
IPreprocessBuildWithContext
후크를 사용하여 IL2CPP 인수가 필요한 플랫폼에 대해서만 설정되도록 합니다.

IPreprocessBuildWithContext 후크

IPreprocessBuildWithContext
콜백을 사용하여 스크립트를 빌드하거나 빌드 다이얼로그를 사용하여 추가 인자를 설정할 수 있습니다.
MyCustomPreprocessBuild 클래스: IPreprocessBuildWithReport{ public int callbackOrder { get { return 0; } } public void OnPreprocessBuild(BuildReport report) { string addlArgs = ""; if (report.summary.platform == BuildTarget.StandaloneWindows || report.summary.platform == BuildTarget.StandaloneWindows64) addlArgs = "--compiler-flags=\"d2ssa-cfg-jt\""; UnityEngine.Debug.Log($"Setting Additional IL2CPP Args = \"{addlArgs}\" for platform {report.summary.platform}"); PlayerSettings.SetAdditionalIl2CppArgs(addlArgs); }}

추가 리소스