INTSourceChangelist:2624352
Availability:Public
Title:언리얼 빌드 시스템 환경설정하기
Crumbs: %ROOT%, Programming, Programming/UnrealBuildSystem
Description:언리얼 빌드 시스템 환경설정을 통한 엔진 빌드 방식을 제어하기 입니다.
Version: 4.9

언리얼 빌드 시스템은 `BuildConfiguration.cs` 파일을 통해 빌드 프로세스를 다양한 요구에 맞춰 수정할 수 있습니다.

## UnrealBuldTool 환경설정 프로퍼티

$ bStopXGECompilationAfterErrors 오류가 나면 XGE 컴파일 중지 : _True_ 면 XGE 컴파일은 오류 발생시 중지됩니다.
    * 계속 컴파일을 하면 이상한 오류를 고치고난 후 앞으로의 컴파일이 훨씬 빨라집니다.
    * 빌드를 빠져나가지 않고도 모든 파일의 컴파일 오류를 볼 수 있습니다.
    * **Ctrl + Break** 키를 눌러 실패한 빌드를 중단시킬 수 있습니다.
$ bOmitPCDebugInfoInDevelopment Development 에서는 PC 디버그 정보 생략 : _True_ 면 Development 환경설정으로 빌드할 때 디버그 정보는 포함되지 않습니다.
    * 디버그 정보를 항상 포함시키려면 _False_ 로 설정합니다.
    * 디버그 정보를 포함시키면 컴파일이 느려지지만, Development 빌드에 줄 번호와 스택 정보가 나옵니다.
$ bUseUnityBuild 유니티 빌드 사용 : _True_ 로 설정하면 엔진을 통째로 리빌드합니다. 빠른 반복처리 모드를 사용할 때는 이 옵션을 꺼야 합니다. 자세한 정보는 [빌드 모드](#빌드모드) 부분을 참고하시기 바랍니다.
$ bEnableFastIteration 빠른 반복처리 켜기 : _True_ 면 컴파일과 링크 시간이 엄청나게 빨라집니다. 유니티 빌드를 만들 때는 이 옵션을 꺼야 합니다. 자세한 정보는 [빌드 모드](#빌드모드) 부분을 참고하시기 바랍니다.
    * _True_ 로 설정하면 반복처리 시간이 가장 빠릅니다.
    * 이상한 "RPC" 나 "PDB" 링크 오류가 나는 경우, `ValidateConfiguration()` (환경설정 검증) 함수에서 `bUseIncrementalLinking=false` 설정을 해야 합니다.


## 빌드 모드

빌드 모드는 두 가지, **유니티** (unity, 통합)과 **패스트 이터레이션** (fast iteration, 빠른 반복처리) 모드가 있습니다. 유니티 모드는 엔진 헤더를 바꾼다던가 전체 엔진 리빌드를 요하는 변경을 가할 때 좋습니다. 패스트 이터레이션 모드는 국지적인 변경을 가할 때 좋으며, 컴파일/링크 시간이 4초까지도 내려갈 수 있습니다. 이 둘을 왔다갔다 변경하려면 `BuildConfiguration.cs` 를 열고 다음 줄을 찾습니다:

	bEnableFastIteration = Utils.GetEnvironmentVariable( "ue.bEnableFastIteration", false );
	bUseUnityBuild = Utils.GetEnvironmentVariable("ue.bUseUnityBuild", true);

강제로 사용하려는 것에 해당하는 줄을 `true` 로 수정하면 됩니다. Unity 가 디폴트입니다.