#define 지시어

플랫폼 #define 지시어

Unity의 Platform Dependent Compilation 기능은 지원되는 플랫폼 중 하나를 위해 작성된 코드 섹션을 컴파일 및 실행할 수 있게 하고, 스크립트를 파티션화할 수 있는 전처리 명령으로 구성됩니다.

코드를 Unity 에디터에서 실행할 수 있기 때문에 타겟 플랫폼에 필요한 코드를 컴파일하고 에디터에서 테스트할 수 있습니다.

Unity가 스크립트를 지원하는 플랫폼 #define 지시어는 다음과 같습니다.

에디터 버전 #define 지시어

코드를 선택적으로 컴파일할 수도 있습니다. 이용 가능한 옵션은 사용하는 에디터 버전에 따라 다릅니다. 버전 X.Y.Z 에 따라(예를 들어, 버전 2.6.0) Unity는 세 개의 전역 #define 지시어를 UNITY_X, UNITY_X_Y 및 UNITY_X_Y_Z 포맷으로 표시합니다.

Unity 2019.4.14에서 나타나는 #define 지시어 예시입니다.

Unity 5.3.4에서부터 Unity의 이전 버전을 기반으로 하여 코드를 선택적으로 컴파일하여 코드의 주어진 포션을 컴파일하거나 실행할 수 있습니다. 위와 동일한 버전의 포맷(X.Y)일 경우 Unity는 이 목적으로 사용될 수 있는 포맷 UNITY_X_Y_OR_NEWER 에 하나의 글로벌 #define을 나타냅니다.

기타 #define 지시어

지원되는 #define 지시어는 다음과 같습니다.

DEVELOPMENT_BUILD #define을 사용하여 스크립트가 “개발용 빌드” 옵션이 활성화될 때 빌드된 플레이어에서 재생되고 있는지 확인할 수 있습니다.

스크립팅 백엔드에 따라 코드를 선택적으로 컴파일할 수 있습니다.

프리컴파일 코드 테스트

아래는 프리컴파일된 코드를 사용하는 방식에 관한 예시입니다. 타겟 빌드로 선택한 플랫폼에 따라 메시지를 출력합니다.

먼저 File > Build Settings 로 이동한 다음, 테스트하고 싶은 코드의 플랫폼을 선택합니다. Build Settings 창이 보여지면 타겟 플랫폼을 선택할 수 있습니다.

프리컴파일된 코드를 테스트하고자 하는 플랫폼을 선택하고 Switch Platform 을 클릭해 Unity에 어떤 플랫폼을 대상으로 하는지 알립니다.

스크립트를 생성한 후 다음의 코드를 복사/붙여넣기합니다.

// C#
using UnityEngine;
using System.Collections;

public class PlatformDefines : MonoBehaviour {
  void Start () {

    #if UNITY_EDITOR
      Debug.Log("Unity Editor");
    #endif

    #if UNITY_IOS
      Debug.Log("iOS");
    #endif

    #if UNITY_STANDALONE_OSX
        Debug.Log("Standalone OSX");
    #endif

    #if UNITY_STANDALONE_WIN
      Debug.Log("Standalone Windows");
    #endif

  }          
}

코드를 테스트하려면 Play Mode 를 선택합니다. Unity 콘솔에 있는 메시지가 선택한 플랫폼에 적절히 나타나는지 확인하여 코드 작동을 확인하기 바랍니다. 예를 들어, iOS 를 선택할 경우 “Iphone” 메시지가 콘솔에 나타나도록 설정됩니다.

C#의 경우 함수를 제거할 때, 더 깔끔하고 오류가 적게 나는 CONDITIONAL 속성을 사용할 수 있습니다. 자세한 내용은 ConditionalAttribute Class를 참조하십시오. Note that common Unity callbacks (ex. Start(), Update(), LateUpdate(), FixedUpdate(), Awake()) are not affected by this attribute because they are called directly from the engine and, for performance reasons, it does not take them into account.

기본적인 #if 컴파일러 명령뿐 아니라 C#에서 다양한 테스트를 사용할 수 있습니다.

# if UNITY_EDITOR
    Debug.Log("Unity Editor");

# elif UNITY_IOS
    Debug.Log("Unity iPhone");

# else
    Debug.Log("Any other platform");

# endif

플랫폼 커스텀 #define

직접 공급을 통해 #define 지시어의 빌트인 선택을 추가할 수도 있습니다. 플레이어 설정의 Other Settings 패널을 연 후 Scripting Define Symbols 텍스트 상자로 이동하시기 바랍니다.

정의하고 싶은 특정 플랫폼의 기호 이름을 입력하시기 바랍니다. 기호 이름은 세미콜론으로 구분됩니다. 입력한 기호 이름은 빌트인 명령처럼 #if 명령의 조건으로 사용될 수 있습니다.

글로벌 커스텀 #define

전처리 지시어를 정의하여 컴파일링할 때 어떤 코드를 포함할지 조절할 수 있습니다. 그러기 위해선 추가 지시어가 있는 텍스트 파일을 Assets 폴더에 추가해야 합니다. 파일명은 사용하고 있는 언어에 따라 달라지며 확장자는 .rsp 입니다.

예를 들어 mcs.rsp 파일에 -define:UNITY_DEBUG 한 줄을 포함할 경우 #define 지시어인 UNITY_DEBUG는 에디터 스크립트의 경우를 제외하고는 C# 스크립트에 대한 글로벌 #define으로 존재하게 됩니다.

.rsp 파일을 변경할 때마다 다시 컴파일해야 해당 파일이 유효합니다. 하나의 스크립트(.js 또는 .cs) 파일을 업데이트하거나 다시 임포트를 하면 됩니다.

참고: 글로벌 ##define 지시어만 수정하고 싶을 경우 플레이어 설정에 있는 Scripting Define Symbols 를 사용하시기 바랍니다. 이 설정이 모든 컴파일러를 다루기 때문입니다. .Rsp 파일을 선택할 경우에는 Unity에서 사용하는 모든 컴파일러에 해당하는 하나의 파일을 제공해야 합니다.

.rsp 파일 사용법은 에디터 설치 폴더에 포함된 mcs 애플리케이션의 ‘도움말’ 섹션에 설명돼 있습니다. mcs -help를 실행하여 자세한 내용을 알 수 있습니다.

.rsp 파일은 호출되는 컴파일러와 반드시 매치돼야 함을 유의하시기 바랍니다. 예를 들어

• .NET 3.5 Equivalent(지원 중단 예정) 스크립팅 런타임 버전을 대상으로 하는 경우 mcs 가 mcs.rsp와 함께 사용됩니다.
• .NET 4.x Equivalent 스크립팅 런타임 버전 컴파일러를 대상으로 하는 경우 csc 가 csc.rsp와 함께 사용됩니다.