윈도우 배치 스크립팅과 Unreal Engine 빌드 자동화를 활용하여 반복적인 작업을 자동으로 처리하는 것을 목표로 합니다. 배치 스크립트를 사용하여 일괄 처리 작업을 간소화하고, Unreal Engine 프로젝트의 빌드 과정을 자동화합니다.

Batch

어떤 반복되는 작업을 일괄적으로 한꺼번에 처리하는데 사용하는 스크립트이며, 간단한 프로그래밍 언어의 한 종류라고 할 수 있습니다.

Window 배치 스크립팅

  • batch는 일괄 처리를 위해 함께 묶다의 단어입니다.
  • 메모장이나 텍스트에디터로 간단하게 만들 수 있습니다. 대체로 IDE가 개발 환경을 지원합니다.
  • echo off는 배치 파일이 명령들을 복창하지 않도록 만들어 화면을 간결하게 하기 위한 명령입니다.

배치파일을 이용하면, 윈도우를 이용한 반복잡업을 미리 정의해서 업무의 효율을 높일 수 있습니다.

Unreal build batch

unreal의 uproject를 복사하여, 다른 빌드 배치를 생성하는 배치파일입니다.

  1. 패스와 프로젝트 명의 변수를 설정합니다.
  2. 빌드하기 위한 준비를 합니다.
  3. AutomationTool.exe를 실행하여 언리얼엔진을 빌드합니다.
  • 프로그램의 이름을 변경하기 위해 다른 .uproject를 사용합니다.
  • 사용하는 플러그인으로인해 타겟이 생성되는데, 한 프로젝트에는 타겟이 하나만있어야 하지만 여러개가 있으므로 문제가 발생합니다. 목적대로 작동하게 하기 위해 Intermediate 폴더를 지웁니다.
  • 사용하는 현지화 언어를 강제하기 위해 처음 프로그램실행시 참고되는 유저설정(BaseGameUserSetting)에 culture=en을 추가합니다.
:: 언리얼 엔진과 프로젝트 주소, 저장할 주소를 입력합니다.
@echo off
set EngineDirectoryPath=D:\Unreal\UE_4.27\Engine
set ProjectName=UnrealProjectName
@echo on

:: 현재 프로젝트와 폴더 경로에 
@echo off
set ProjectDictionaryPath=%cd%
set DefaultStagingDirectoryPath=%cd%
@echo on

:: 인수로 사용할 변수를 작성합니다.
@echo off
set AutomationToolPath=%EngineDirectoryPath%\Binaries\DotNET\AutomationTool.exe
set UE4ExePath=%EngineDirectoryPath%\Binaries\Win64\UE4Editor-Cmd.exe
set UProject=%ProjectName%.uproject
set ConfigPathInBuild=WindowsNoEditor\Engine\Config
set BaseGameUserSettinginBuild=%ConfigPathInBuild%\BaseGameUserSettings.ini
@echo on

:: 해당 프로그램의 Config에 마지막으로 사용한 현지화 Config가 있을 경우 초기 설정이 적용되지 않을 수 있습니다.
:Main
call :RunUAT UnrealProjectName_en
	@echo off
	set BaseGameUserSettingPath=%StagingDirectoryPath%\%BaseGameUserSettinginBuild%
	@echo on
	:: 마지막 스테이징의 BaseGameuserSetting에 culture를 추가합니다.
	echo. >> "%BaseGameUserSettingPath%"
	echo culture=en >> "%BaseGameUserSettingPath%"
call :RunUAT UnrealProjectName_ko
goto EOF

:: .uproject를 복사하고 해당 프로젝트를 이용하여 빌드합니다.
:: UAT를 이용하여 프로젝트를 빌드하고, 해당 위치에 저장합니다.
:: UAT가 종료되면 Intermediate폴더를 삭제합니다.
:: 커멘드는 unreal에서 project launch를 세팅하여 빌드할 때, 보내는 파라메터를 가져와 이용합니다.
:RunUAT <NewProjectName>
@echo off
set NewProjectName=%~1
set NewUProject=%~1.uproject
set NewUProjectpath=%ProjectDictionaryPath%\%NewUProject%
set StagingDirectoryPath=%DefaultStagingDirectoryPath%\%NewProjectName%
@echo on
@echo off
set RunCommand="%AutomationToolPath%" BuildCookRun -project="%NewUProjectpath%"
@echo on
if not exist %NewUProject% copy %UProject% %NewUProject%
if exist "Intermediate" rd /s /q "Intermediate"
%RunCommand% -noP4 -clientconfig=Shipping -serverconfig=Shipping -nocompile -nocompileeditor -installed -ue4exe="%UE4ExePath%" -utf8output -platform=Win64 -targetplatform=Win64 -build -cook -map= -unversionedcookedcontent -compressed -prereqs -stage -package -stagingdirectory="%StagingDirectoryPath%" -cmdline=" -Messaging"
if not "%ProjectName%.uproject" == "%NewUProject%" del %NewUProject%