UNREAL ENGINE

Install Build 빠르게 학습하기.

jplee 2023. 10. 26. 23:28

인터넷 들을 탐색 하다 보면 언리얼엔진 소스 빌드와 Install Build 에 대해서 많은 기사들을 찾을 수 있습니다.

하지만 정작 중요한 핵심은 거의 대부분 누락 되어 있었어요.

 

그래서 간단히 언급을 해 보고자 합니다.

 

약 10년 정도 중국의 거대 게임사들을 다니면서 중요하게 생각되는 점이 있는데요... 그건 CI/CD 에 대한 것이고 포괄적인 DEV-OPS 에 대한 많은 시스템들 이었습니다.

오랜 시간 넷이즈 엔진센터에서 고위 수석 전문가 직위의 테크니컬 아트디렉터로 근무 했을 때 부터 XD 라는 인터넷 기업과 거인네트웍의 전사적 기술집중센터의 테크니컬 아트디렉터로 근무 할 때도 역시 엔진팀과 데브옵스팀과 거의 많은 시간을 보냈습니다.

 

그 첫 걸음중의 하나인 빌드 자동화의 일부인 Install Build 인데요...

 

BUILD

직접 아래와 같은 형식의 배치파일을 작성.
BuildEditor.bat

Engine\Build\BatchFiles\RunUAT.bat BuildGraph -target="Make Installed Build Win64" -script=Engine/Build/InstalledEngineBuild.xml -clean -set:HostPlatformOnly=true -set:WithDDC=false



빌드그래프를 사용하여 클린 로컬 빌드를 수행.
빌드 완료 후 LocalBuild 디렉토리에 빌드 된 에디터파일이 출력 됨.

다만... 비주얼스튜디오를 사용해서 빌드 하면 빌드성공이 100 프로이던 녀석이.... 인스톨빌드를 하기 위해  BuildGraph 를 사용해서 빌드 하면 여러가지 애러를 뱉어 내면서 LocalBuild 가 생성되지 못함.

 

인스톨빌드가 생성 되지 않을 경우 log 를 확인 하고 빌드 단계에서 어떤 문제가 발생했는지 확인.

Engine\Programs\AutomationTool\Saved\Logs 에서 찾을 수도 있음. 다만 찾는데 시간을 좀 드려야 하죠... 더 쉬운 방법.

 

CMD 활용

자신이 만든 빌드 배치파일을 클릭 해서 실행 하면 애러 로그를 찾기 어렵다.
관리자모드로 CMD 를 실행 후 배치파일을 실행 해 주자! 로그에서 찾을 수도 있지만 눈이 아픔….;;;

Unable to find installation of PDBCOPY.EXE, which is required to strip symbols. This tool is included as part of the 'Windows Debugging Tools' component of the Windows 10 SDK (https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk).
while executing task <Strip Platform="Win64" BaseDir="D:\UnrealEngineSRC\EngineSRC\TS_ENGINE" Files="#UnrealEditor Win64 Unstripped" OutputDir="D:\UnrealEngineSRC\EngineSRC\TS_ENGINE\Engine\Saved" Tag="#UnrealEditor Win64 Stripped" />
at D:\UnrealEngineSRC\EngineSRC\TS_ENGINE\Engine\Build\InstalledEngineBuild.xml(183)
(see D:\UnrealEngineSRC\EngineSRC\TS_ENGINE\Engine\Programs\AutomationTool\Saved\Logs\Log.txt for full exception trace)

배치파일이 다 실행 되고 빌드 실패가 되어도 CMD 창이 닫히지 않기 때문에 쉽게 찾을 수 있고 CMD 창에는 애러 부분이 빨간색으로 정확히 표시가 되니까...!

 

이러한 애러를 출력 하고 인스톨빌드가 완료 되지 않을 수 있습니다.

Windows SDK - Windows app development 에 가서 ~~ 다운로드 하고 설치.

 

Windows SDK - Windows app development

The Windows SDK for Windows 11 contains headers, libraries, and tools you can use when you create apps that run on Windows.

developer.microsoft.com

비주얼 스튜디오 인스톨러를 사용해서 설치 해야 합니다.

제 경우 Windows 10 SDK 를 설치 안해서 Debugging Tools for Windows 의 미설치 문제였습니다. 언리얼엔진의 특정 서브 솔루션에서 이것이 필요 했던 거죠.

옵션을 보면 Debugging tools for Windows 설치를 볼 수 있습니다. 만약 최초에 windows 10 sdk 가 설치 되어 있다면 인스톨빌드는 잘 수행 되었을거에요.


그 외에 특이한 문제가 없다면 아래와 같이 빌드 성공 메시지를 출력 합니다.

 

새로이 LocalBuilds 폴더가 생겼고 그 안에 정확히 필요한 언리얼에디터 빌드가 생성 된 걸 확인 할 수 있습니다.


LocalBuilds 경로를 변경 하기 위해서는  InstalledEngineBuild.xml 에서 수정 할 수 있습니다.

 

인스톨 빌드 된 엔진을 레지스트리에 추가 하는 방법은 언리얼 엔진 공식 문서를 참조 할 수 있습니다.

 

설치 빌드 사용

Installed Build 프로세스와 그 스크립트를 작성하는 법에 대한 개요입니다.

docs.unrealengine.com

다만… 이 방법 보다 가장 간편한 방법은  UnrealVersionSelector.exe 를 사용하는 것인데요.

Engine/Binaries/Win64 에 첨부 된 파일을 복사 후 실행 하면 자동 등록 됩니다.

 

다음 시간에는 팀씨티 또는 젠킨스 쪽을 살펴 보겠습니다.