[Unreal] 패키징

1. 패키징?

패키징은 사용자에게 배포하기 위해 컨텐츠와 소스들을 빌드, 쿠킹, 패킹을 하는 일련의 과정이다.

 

1) 빌드

빌드는 선택한 플랫폼에서 실행 가능한 실행 파일을 만들기 위한 컴파일 과정이다.

 

전처리 UBT → UHT (.h) → 컴파일 (.cpp) → 어셈블리 (.obj) → Module → 완료

• 우선 UBT와 UHT의 전처리 단계를 거친다. 일반적으로 UBT가 먼저 호출되며 필요에 따라 UHT가 호출된다.
• 그 후 컴파일러가 컴파일을 수행한다. 

 

UBT(Unreal Build Tool)는 프로젝트의 빌드 프로세스를 관리한다.

• 어떤 소스 코드 파일들이 변경되었는지 확인하고, 그에 따라 어떤 부분을 새롭게 컴파일할 것인지 결정한다.
• 프로젝트의 폴더 구조와 소스 파일을 기반으로 OS에 맞는 솔루션을 생성하여 멀티 플랫폼 개발이 가능하도록 한다.

 

UBT

 

UBT의 동작 방식은 다음과 같다. 언리얼 C++ 프로젝트를 생성하면 3개의 빌드 정보 파일이 함께 생성된다.

• (프로젝트명).build.cs: PCH, 외부 모듈 등 빌드 옵션을 관리한다.
• (프로젝트명).target.cs: 게임 빌드를 설정한다.
• (프로젝트명Editor).target.cs: 에디터 빌드를 설정한다.

 

빌드 시 UBT가 실행되면서 C# 컴파일러에 의해 빌드 정보 파일도 함께 컴파일되는데, 이 파일에 작성된 사양대로 빌드 과정이 진행되게 된다.

 

2) 쿠킹

쿠킹은 선택한 플랫폼에서 사용할 수 있는 포맷으로 컨텐츠들을 변환하는 작업이다.

 

2. 패키징 설정

패키징을 위해서는 다음과 같은 설정이 필요하다.

 

패키징 설정

• Build Connfiguration
  • Debug
    • 엔진과 게임 코드 모두 빌드한다.
    • 디버깅 심볼이 들어있는 빌드 환경으로 디버깅 시 사용하기 좋다.
  • DebugGame
    • 최적화 없이 게임 코드만 빌드한다.
    • 게임 모듈만 디버깅하는 경우에 좋다.
  • Development
    • 최적화 없이 엔진과 게임 코드 모두 빌드한다.
    • 컴파일 시 코드 변경 사항이 에디터에 반영된다.
    • 개발 시 실전 테스트용으로 사용된다.
  • Test
    • Shipping과 동일하다.
    • console commands, stats, profiling tools 유지한다.
  • Shipping
    • 퍼포먼스 최적화 및 게임 배포 시 사용한다.
    • console commands, stats, profiling tools 삭제한다.
• Full Rebuild: 모든 파일 빌드가 필요하다면 true, 수정된 파일만 빌드가 필요하다면 false로 설정한다.
• List of maps to include in a packaged build

 

설정이 끝났다면 플랫폼 버튼을 통해 플랫폼 별 패키징이 가능하다.

 

플랫폼 패키징

 

참고

https://designerd.tistory.com/entry/Unreal-%EC%BB%B4%ED%8C%8C%EC%9D%BC-%EA%B3%BC%EC%A0%95

[Unreal] 컴파일 과정 (UBT, UHT 호출시점)

https://designerd.tistory.com/entry/UE-%EB%B9%8C%EB%93%9C-%ED%99%98%EA%B2%BD%EC%84%A4%EC%A0%95-Debug

[UE] 빌드 환경설정(Build Mode): Debug, DebugGame, Development, Shipping

https://makerejoicegames.tistory.com/507

언리얼엔진5 Project Packaging