기술 자료

Unity 엔진

Unity 엔진

사용자 지정 스크립팅 심볼

에디터 UI를 통해 스크립트나 에셋 파일을 사용하여 고유한 커스텀 스크립팅 심볼을 만들 수 있습니다.
읽는 시간 3분최근 업데이트: 9일 전

Unity의 내장 스크립팅 심볼 외에도 사용자 지정 스크립팅 심볼을 정의할 수 있습니다. 커스텀 스크립팅 심볼을 정의하는 위치는 해당 심볼이 적용되는 범위를 결정합니다. 다음 위치에서 커스텀 심볼을 정의할 수 있습니다.
  • 프로젝트의 모든 에디터 및 플레이어 코드에 적용되는 기호에 대한 에셋 파일으로, 활성화된 빌드 프로파일에 관계없이 사용합니다.
  • 특정 플랫폼 또는 해당 빌드 프로파일 중 하나가 활성화된 경우 모든 에디터 및 플레이어 코드에 적용되는 기호에 대한 플레이어 설정입니다.
  • 특정 빌드 프로파일이 활성화된 경우 모든 에디터 및 플레이어 코드에 적용되는 기호를 위한 빌드 프로파일입니다.
  • 코드에서, 액티브 플랫폼에 적용되는 기호 또는 사용되는 API에 따라 개별 플레이어 빌드에 적용됩니다.

전체 프로젝트에 대한 커스텀 심볼

다음과 같이 전체 프로젝트에 적용되는 커스텀 스크립팅 심볼을 응답 파일 에셋으로 정의할 수 있습니다.
  1. 파일
    csc.rsp
    의 이름을 지정하고 프로젝트의 Assets 폴더 루트에 배치합니다.
  2. -define:
    로 시작하는 줄에 스크립팅 심볼을 정의한 다음 세미콜론으로 구분된 하나 이상의 스크립팅 심볼을 지정합니다.
Unity 시작 시 이 파일을 읽고 코드를 컴파일하기 전에 적용합니다. 예를 들어
csc.rsp
파일에 단일 줄
-define:UNITY_DEBUG;UNITY_TEST
를 포함하는 경우
UNITY_DEBUG
및
UNITY_TEST
기호는 프로젝트의 모든 C# 스크립트에 대해 전역 정의된 스크립팅 기호로 포함됩니다.
참고
Unity가 스크립트를 다시 컴파일하기 전에는
.rsp
파일에 대한 변경 사항이 적용되지 않습니다. 단일 스크립트 파일을 업데이트하거나 다시 임포트하여 재컴파일을 트리거할 수 있습니다.

플랫폼용 커스텀 심볼

다음과 같이 플랫폼별 커스텀 스크립팅 심볼을 정의할 수 있습니다.
  1. 플레이어 설정을 엽니다.
  2. 기타 설정 > 스크립트 컴파일 섹션의 스크립팅 정의 심볼 목록으로 이동합니다.
  3. + 버튼을 선택하고 텍스트 필드에 심볼 이름을 입력하여 목록에 새 스크립팅 심볼을 추가합니다. 기존 목록 항목을 - 버튼으로 제거합니다.
  4. 목록 편집을 마치면 적용하기를 선택하여 변경 사항을 적용합니다. Unity 새 심볼을 사용하여 프로젝트의 스크립트를 다시 컴파일합니다.
참고
Copy Defines 버튼은 목록의 현재 커스텀 스크립팅 심볼 세트를 세미콜론으로 구분된 값의 문자열로 클립보드에 복사합니다.

빌드 프로파일의 커스텀 심볼

다음과 같이 빌드 프로파일에 대한 커스텀 스크립팅 심볼을 정의할 수 있습니다.
  1. Build Profiles 창에서 기호를 정의할 빌드 프로파일을 선택합니다.
  2. 빌드 데이터 섹션의 스크립팅 정의 목록으로 이동합니다.
  3. + 버튼을 선택하고 텍스트 필드에 심볼 이름을 입력하여 목록에 새 스크립팅 심볼을 추가합니다. 기존 목록 항목을 - 버튼으로 제거합니다. 리스트의 수정 사항은 저장되어 자동으로 적용됩니다.
참고
-activeBuildProfile
커맨드 라인 인자를 사용하여 에디터를 실행하여 지정된 빌드 프로파일과 커스텀 스크립팅 심볼을 시작할 때부터 적용할 수 있습니다.

코드로 정의된 커스텀 심볼

다음 API를 사용하여 스크립팅 심볼을 정의할 수 있습니다.
BuildPlayerOptions.extraScriptingDefines
및
Build.Player.ScriptCompilationSettings-extraScriptDefines
는 플레이어 빌드에만 적용되므로 에디터 스크립트에 적용되는 스크립팅 심볼을 정의할 때는
PlayerSettings.SetScriptingDefineSymbols
를 사용하십시오. 이것은 플랫폼별 스크립팅 심볼을 구성하는 코드와 동등한 코드입니다. 플레이어 설정
중요
SetScriptingDefineSymbols
가 있는 코드로 생성된 기호는 에디터가 다시 제어하고 스크립트를 다시 컴파일할 때까지 적용되지 않습니다. 예를 들어 에디터 스크립트에서
SetScriptingDefineSymbols
로 스크립팅 심볼을 생성한 다음 다음 줄에서
BuildPipeline.BuildPlayer
를 호출하는 경우 이전 줄에서 생성된 새로운 심볼은 아직 적용되지 않습니다. 이 경우
BuildPlayer
실행의 일환으로 실행되는 에디터 코드는 새 기호 없이 실행되며 플레이어가 의도한 대로 빌드하지 않을 수 있습니다.

배치 모드의 커스텀 심볼

에디터가 배치 모드로 실행되면 스크립트 재컴파일을 트리거하는 메커니즘이 없습니다. 배치 모드에서 실행되는 에디터에서 특정 기호를 정의해야 하는 경우 시작 시 csc.rsp 에셋 파일을 사용하여 해당 기호가 존재해야 합니다.

스크립팅 심볼 상속

커스텀 스크립팅 심볼을 여러 위치에 정의하면 Unity 현재 빌드 구성에 적용되는 모든 심볼을 합칩니다. 다음과 같이 기호는 덮어쓰기가 아니라 각 범위에서 상속받습니다. 프로젝트 전체 심볼(
csc.rsp
에서) + 플랫폼별 심볼(플레이어 설정에서) + 빌드 프로필 심볼(빌드 데이터에서) 플랫폼 및 빌드 프로파일 심볼은 활성 빌드 프로파일과 일치하는 경우에만 포함됩니다.
예를 들어 프로젝트에 다음 위치에 정의된 커스텀 스크립팅 기호가 있다고 가정해 보겠습니다.

위치

정의된 기호

csc.rsp
SYMBOL_A
Windows 플레이어 설정
SYMBOL_B
WindowsBuildProfile1
SYMBOL_C
WindowsBuildProfile2
SYMBOL_D
이 예제 구성을 고려하여 다음 표에는 다양한 빌드 프로파일이 활성화될 때 에디터와 플레이어 코드에 대해 활성화되는 심볼이 나와 있습니다.

활성 빌드 프로파일

활성 심볼

Android
SYMBOL_A
Windows
SYMBOL_A
,
SYMBOL_B
WindowsBuildProfile1
SYMBOL_A
,
SYMBOL_B
,
SYMBOL_C
WindowsBuildProfile2
SYMBOL_A
,
SYMBOL_B
,
SYMBOL_D
코드에서
#if
지시문으로 이러한 동작을 테스트할 수 있습니다. 자세한 내용은 테스트 조건부 컴파일을 참조하십시오.

추가 리소스