---
title: 추가 IL2CPP 컴파일러 인자
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/handling-il2cpp-additional-args
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/handling-il2cpp-additional-args.md
generated_at: 2026-11-19T13:46:08.670Z
locale: ko-kr
---

# 추가 IL2CPP 컴파일러 인자

> 코드에서 IL2CPP 컴파일러에 커스텀 추가 인자를 제공합니다.

[`PlayerSettings.SetAdditionalIl2CppArgs`](/engine/6000.0/script-reference/unityeditor/playersettings/setadditionalil2cppargs.md) API를 사용하거나 `IL2CPP_ADDITIONAL_ARGS` 환경 변수를 설정하여 IL2CPP 컴파일러에 대한 추가 인자를 제공할 수 있습니다.

> **Warning:**
>
> 추가 인수를 IL2CPP 컴파일러에 전달하는 것은 복잡한 프로젝트에서 IL2CPP 코드 생성을 디버깅하고 최적화하는 실험 기능입니다. [진단 스위치](/engine/6000.0/manual/unity-editor/editor-settings-reference/preferences/editor-diagnostics.md)와 마찬가지로 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`를 링커에 전달합니다.                         |

여러 인수는 다음과 같이 공백으로 구분되어야 합니다.

```lang-cs
PlayerSettings.SetAdditionalIl2CppArgs("--compiler-flags=\"COMPILER_FLAG_1 COMPILER_FLAG_2\" --linker-flags="\LINKER_FLAG_1 LINKER_FLAG_2\"");
```

> **Note:**
>
> `SetAdditionalIl2CppArgs`를 두 번 이상 호출하면 이전에 제공된 모든 플래그를 덮어씁니다. 빈 문자열을 이 메서드에 전달하여 이전에 제공된 추가 인자를 제거합니다.

유효한 컴파일러 및 링커 플래그는 플랫폼에 따라 IL2CPP가 해당 플랫폼에서 사용하는 기본 C++ 컴파일러(msvc 또는 clang)에 따라 다릅니다. 유효한 컴파일러 및 링커 옵션 리스트는 msvc [컴파일러](https://learn.microsoft.com/en-us/cpp/build/reference/compiler-options?view=msvc-170), [링커](https://learn.microsoft.com/en-us/cpp/build/reference/linker-options?view=msvc-170) 옵션 또는 [클랜 컴파일러 및 링커](https://clang.llvm.org/docs/ClangCommandLineReference.html) 옵션에 대한 관련 타사 문서를 참조하십시오.

## 인수가 설정되었는지 확인합니다.##check-if-arguments-are-set

프로젝트에 추가 IL2CPP 인수가 설정되어 있다면 두 개 이상의 플랫폼에 대해 컴파일하는 것이 예상대로 작동하지 않을 수 있습니다. 특히 [Linux용 크로스 컴파일](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/linux-il2cpp-crosscompiler.md)을 수행할 때 말이죠.

추가 IL2CPP 인수가 이미 설정되어 있는지 확인하려면 다음 중 하나를 수행하십시오.

* 환경 변수 `IL2CPP_ADDITIONAL_ARGS`가 설정되었는지 확인합니다.
* `ProjectSettings/ProjectSettings.asset`에서 에디터 스크립트에 `additionalIl2CppArgs`라는 값이 있는지 확인합니다.

> **Important:**
>
> 추가 IL2CPP 인수가 전역적으로 적용되므로 원하는 플랫폼이 아닌 플랫폼에 대해 설정하면 컴파일 문제가 발생할 수 있습니다. `IPreprocessBuildWithContext` 후크를 사용하여 IL2CPP 인수가 필요한 플랫폼에 대해서만 설정되도록 합니다.

### IPreprocessBuildWithContext 후크##ipreprocessbuildwithcontext-hook

[`IPreprocessBuildWithContext`](ScriptRef:Build.IPreprocessBuildWithContext) 콜백을 사용하여 스크립트를 빌드하거나 빌드 다이얼로그를 사용하여 추가 인자를 설정할 수 있습니다.

```lang-cs
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);
    }
}
```

## 추가 리소스##additional-resources

* [Linux IL2CPP cross-compiler](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/linux-il2cpp-crosscompiler.md)
* [관리되는 스택 추적](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp/il2cpp-managed-stack-traces.md)
* Discussions IL2CPP 호출을 위한 컴파일러 또는 링커 플래그를 추가하는 방법]\([https://discussions.unity.com/t/how-to-add-compiler-or-linker-flags-for-il2cpp-invocation/221183](https://discussions.unity.com/t/how-to-add-compiler-or-linker-flags-for-il2cpp-invocation/221183))
