12.6.2 Hxcpp 빌드 환경(The Hxcpp Build Environment)

hxcpp 빌드 환경은 키-값 쌍으로 변수를 설정하거나 정의하여 제어할 수 있습니다. 특정 값 없이 키를 정의하는 것만으로 보통 원하는 동작을 촉발하기에 충분하며, 이러한 키는 흔히 "defines"라고 불립니다.

표준 defines 목록은 Defines를 참조하세요.

커맨드 라인에서 정의(Defining from the Command Line)

hxcpp 빌드 환경을 바꾸는 가장 쉬운 방법은 -D를 사용해 Haxe 커맨드 라인으로 defines를 전달하는 것입니다. 키-값 쌍도 이렇게 전달할 수 있습니다. 예:

haxe --main Main --cpp cpp -D android -D static_link -D PLATFORM=android-9

여기서:

android가 정의됨 - hxcpp가 Android로 크로스 컴파일하게 함.
static_link가 정의됨 - (동적이 아닌) 정적 라이브러리가 생성되게 함.
Android 타깃 플랫폼(PLATFORM)이 특정 값(android-9)으로 설정됨. 이 플랫폼 정보는 SDK에 전달되어 적절한 코드를 생성하게 합니다.

고급 사용자는 컴파일 타임에 매크로를 사용해 시스템에 추가 defines를 추가할 수 있습니다. 이 정의들은 hxcpp 빌드 도구에도 전달됩니다.

시스템 환경 변수에서 정의(Defining from System Environment Variables)

hxcpp 빌드 도구는 모든 시스템 환경 변수를 가져오므로, 시스템을 사용해 프로세스를 구성할 수 있습니다. 예:

export HXCPP_VERBOSE=

또는 Windows에서:

set HXCPP_VERBOSE=1

IDE를 통해 Haxe를 실행한다면 환경 변수에 주의해야 합니다. 변수는 시스템에서 변수가 변경될 때가 아니라 IDE가 시작된 환경에서 한 번 읽을 수 있기 때문입니다.

.hxcpp_config.xml에서 정의(Defining from .hxcpp_config.xml)

hxcpp 빌드 도구는 여러 "빌드 파일"을 파싱합니다. 이 파일들은 기본 XML 파일 형식이며 구성 변수를 설정하거나 조건적으로 설정하는 데 사용할 수 있습니다. 빌드 과정의 일부로 구성 파일이라고 알려진 .hxcpp_config.xml 파일이 (두 번) 읽힙니다. 이 파일은 사용자의 홈 디렉토리(Windows에서는 사용자 프로필 디렉토리)에 있으며, 크로스 컴파일러 SDK의 위치처럼 자주 바뀌지 않는 시스템별 변수를 구성하기에 가장 좋은 위치입니다. 자리표시자 파일은 사용자가 그 머신에서 hxcpp를 처음 실행할 때 생성됩니다. HXCPP_VERBOSE define으로 컴파일하면 빌드 로그에서 이 파일의 정확한 위치를 볼 수 있습니다.

구성 파일은 두 번 읽힙니다. 첫 번째로 vars 섹션이 구성 과정 초기에 읽혀 컴파일러의 위치를 설정하고 구성하는 데 사용됩니다. 두 번째로 exes 섹션이 과정 끝쯤에 읽혀 사용 가능한 모든 정보를 바탕으로 컴파일러나 빌드 과정을 수정할 수 있게 합니다. 파일 형식에 대한 자세한 내용은 build.xml 파일 형식을 참조하세요.

@:buildXml 메타데이터로 정의(Defining via @:buildXml Metadata)

구성 데이터를 Haxe가 만드는 build.xml 파일에 주입할 수 있습니다. 이는 빌드에 직접/간접적으로 포함된 Haxe 클래스에 메타데이터를 붙여 수행합니다. 예:

@:buildXml("
<files id='haxe'>
  <compilerflag value='-Iinclude'/>
</files>
")
@:keep class StaticNme { ... }

이 메타데이터는 빌드에 라이브러리나 include 경로를 추가하는 데 가장 좋습니다. 몇 가지 참고:

@:keep 메타데이터는 죽은 코드 제거가 이 클래스를 제거하지 않도록 추가됩니다.
인용은 까다로울 수 있습니다 - 여기서 큰따옴표는 Haxe용이고 작은따옴표가 build.xml에 추가됩니다.
단일 "include" 명령을 주입하는 것이 인용 문제를 관리하는 좋은 방법입니다.
올바르게 하려면 빌드 시스템에 대한 지식이 필요합니다. 파일 형식에 대한 자세한 내용은 build.xml 파일 형식을 참조하세요.

build.xml 파일은 컴파일러 선택이 이루어진 후에 읽히므로 일반적으로 컴파일러를 구성하는 데는 적합하지 않습니다.

출처: The Hxcpp Build Environment

더 알아보기

Haxe/C++ 시작하기