사용자 지정 스크립팅 심볼
에디터 UI를 통해 스크립트나 에셋 파일을 사용하여 고유한 커스텀 스크립팅 심볼을 만들 수 있습니다.
읽는 시간 3분최근 업데이트: 9일 전
Unity의 내장 스크립팅 심볼 외에도 사용자 지정 스크립팅 심볼을 정의할 수 있습니다. 커스텀 스크립팅 심볼을 정의하는 위치는 해당 심볼이 적용되는 범위를 결정합니다. 다음 위치에서 커스텀 심볼을 정의할 수 있습니다.
- 프로젝트의 모든 에디터 및 플레이어 코드에 적용되는 기호에 대한 에셋 파일으로, 활성화된 빌드 프로파일에 관계없이 사용합니다.
- 특정 플랫폼 또는 해당 빌드 프로파일 중 하나가 활성화된 경우 모든 에디터 및 플레이어 코드에 적용되는 기호에 대한 플레이어 설정입니다.
- 특정 빌드 프로파일이 활성화된 경우 모든 에디터 및 플레이어 코드에 적용되는 기호를 위한 빌드 프로파일입니다.
- 코드에서, 액티브 플랫폼에 적용되는 기호 또는 사용되는 API에 따라 개별 플레이어 빌드에 적용됩니다.
전체 프로젝트에 대한 커스텀 심볼
다음과 같이 전체 프로젝트에 적용되는 커스텀 스크립팅 심볼을 응답 파일 에셋으로 정의할 수 있습니다.
- 파일 의 이름을 지정하고 프로젝트의 Assets 폴더 루트에 배치합니다.
csc.rsp - 로 시작하는 줄에 스크립팅 심볼을 정의한 다음 세미콜론으로 구분된 하나 이상의 스크립팅 심볼을 지정합니다.
-define:
Unity 시작 시 이 파일을 읽고 코드를 컴파일하기 전에 적용합니다. 예를 들어 파일에 단일 줄 를 포함하는 경우 및 기호는 프로젝트의 모든 C# 스크립트에 대해 전역 정의된 스크립팅 기호로 포함됩니다.
csc.rsp-define:UNITY_DEBUG;UNITY_TESTUNITY_DEBUGUNITY_TEST플랫폼용 커스텀 심볼
다음과 같이 플랫폼별 커스텀 스크립팅 심볼을 정의할 수 있습니다.
- 플레이어 설정을 엽니다.
- 기타 설정 > 스크립트 컴파일 섹션의 스크립팅 정의 심볼 목록으로 이동합니다.
- + 버튼을 선택하고 텍스트 필드에 심볼 이름을 입력하여 목록에 새 스크립팅 심볼을 추가합니다. 기존 목록 항목을 - 버튼으로 제거합니다.
- 목록 편집을 마치면 적용하기를 선택하여 변경 사항을 적용합니다. Unity 새 심볼을 사용하여 프로젝트의 스크립트를 다시 컴파일합니다.
빌드 프로파일의 커스텀 심볼
다음과 같이 빌드 프로파일에 대한 커스텀 스크립팅 심볼을 정의할 수 있습니다.
- Build Profiles 창에서 기호를 정의할 빌드 프로파일을 선택합니다.
- 빌드 데이터 섹션의 스크립팅 정의 목록으로 이동합니다.
- + 버튼을 선택하고 텍스트 필드에 심볼 이름을 입력하여 목록에 새 스크립팅 심볼을 추가합니다. 기존 목록 항목을 - 버튼으로 제거합니다. 리스트의 수정 사항은 저장되어 자동으로 적용됩니다.
코드로 정의된 커스텀 심볼
다음 API를 사용하여 스크립팅 심볼을 정의할 수 있습니다.
PlayerSettings.SetScriptingDefineSymbolsBuildPlayerOptions.extraScriptingDefinesBuild.Player.ScriptCompilationSettings-extraScriptingDefines
BuildPlayerOptions.extraScriptingDefinesBuild.Player.ScriptCompilationSettings-extraScriptDefinesPlayerSettings.SetScriptingDefineSymbols배치 모드의 커스텀 심볼
에디터가 배치 모드로 실행되면 스크립트 재컴파일을 트리거하는 메커니즘이 없습니다. 배치 모드에서 실행되는 에디터에서 특정 기호를 정의해야 하는 경우 시작 시 csc.rsp 에셋 파일을 사용하여 해당 기호가 존재해야 합니다.
스크립팅 심볼 상속
커스텀 스크립팅 심볼을 여러 위치에 정의하면 Unity 현재 빌드 구성에 적용되는 모든 심볼을 합칩니다. 다음과 같이 기호는 덮어쓰기가 아니라 각 범위에서 상속받습니다. 프로젝트 전체 심볼(에서) + 플랫폼별 심볼(플레이어 설정에서) + 빌드 프로필 심볼(빌드 데이터에서) 플랫폼 및 빌드 프로파일 심볼은 활성 빌드 프로파일과 일치하는 경우에만 포함됩니다.
csc.rsp예를 들어 프로젝트에 다음 위치에 정의된 커스텀 스크립팅 기호가 있다고 가정해 보겠습니다.
위치 | 정의된 기호 |
|---|---|
| |
| Windows 플레이어 설정 | |
| WindowsBuildProfile1 | |
| WindowsBuildProfile2 | |
이 예제 구성을 고려하여 다음 표에는 다양한 빌드 프로파일이 활성화될 때 에디터와 플레이어 코드에 대해 활성화되는 심볼이 나와 있습니다.
활성 빌드 프로파일 | 활성 심볼 |
|---|---|
| Android | |
| Windows | |
| WindowsBuildProfile1 | |
| WindowsBuildProfile2 | |
코드에서 지시문으로 이러한 동작을 테스트할 수 있습니다. 자세한 내용은 테스트 조건부 컴파일을 참조하십시오.
#if