언어:
페이지 정보
수준별:
엔진 버전:
언리얼 엔진
이 문서가 번역된 이후 업데이트된 내용이 있을 수 있습니다. 자세한 내용은 영문 페이지를 참고하세요.

프로젝트 패키징

언리얼 엔진

언리얼 프로젝트를 사용자에 배포하기 전, 올바른 방식으로 패키지를 만들어야 합니다. 패키징을 통해 모든 코드와 콘텐츠가 최신인지, 타깃 플랫폼에서 실행하기에 적합한 포맷으로 되어있는지를 확인합니다.

패키징 프로세스 도중에는 여러가지가 단계별로 수행됩니다. 프로젝트에 커스텀 소스 코드가 있을 경우, 이 코드 먼저 컴파일합니다. 그런 다음 필수 콘텐츠 전부를 타깃 플랫폼에서 사용 가능한 포맷으로 변환, 다른 말로 "쿠킹"합니다. 그 이후 컴파일된 코드와 쿠킹된 콘텐츠를 묶어 Windows용 인스톨러와 같은 배포가능 세트 파일로 만듭니다.

메인 파일 메뉴 아래 Package Project (프로젝트 패키지)라는 옵션이 있습니다. 그 서브 메뉴에는 패키지를 만들 수 있는 대상 플랫폼이 전부 표시됩니다. 패키징의 목적은 하나의 맵이 아닌 전체 게임을 테스트하거나, 제출/배포용 게임을 준비하는 것입니다.

Android에서 패키징하는 경우, 여러가지 선택사항이 있습니다. 자세한 정보는 Android 텍스처 포맷 관련 부분을 참고해 주시기 바랍니다.

패키징 전 설정할 수 있는 고급 옵션도 몇 가지 있습니다.

게임 디폴트 맵 설정

게임을 패키징하기 전 먼저 패키징된 게임 시작시 로드할 게임 디폴트 맵 을 설정해야 합니다. 맵을 설정하지 않고 기본 프로젝트를 사용중이면 패키징된 게임 시작시 검정 화면만 보입니다. 일인칭 템플릿 또는 삼인칭 템플릿같은 템플릿 맵 중 하나를 사용했다면 시작 맵이 로드됩니다.

게임 디폴트 맵 설정을 위해서는 에디터의 메인 메뉴에서 편집 > 프로젝트 세팅 > 맵 & 모드 를 클릭합니다:

Project_Settings_MapsNModes.png

패키지 만들기

프로젝트를 특정 플랫폼용 패키지로 만들려면, 에디터의 메인 메뉴에서 파일 > 프로젝트 패키지 > [플랫폼 이름] 을 선택합니다.

packaging_menu.png

packaging_menu_Mac.png

타깃 디렉터리를 선택하라는 대화창이 뜹니다. 패키징이 성공적으로 끝나면, 그 디렉터리에 패키징된 프로젝트가 들어갑니다.

타깃 디렉터리를 확인하고 나면 선택된 플랫폼용으로 프로젝트를 패키징하는 실제 프로세스가 시작됩니다. 패키징은 시간이 매우 오래 걸리는 작업이기 때문에, 이 프로세스는 백그라운드로 진행되며, 에디터 사용을 계속할 수 있습니다. 에디터 우하단의 상태 표시를 통해 진행상황을 알 수 있습니다:

progress.png

progress_MAC.png

상태 표시의 '취소' 버튼을 누르면 활성 패키징 프로세스를 취소시킬 수 있습니다. '로그 표시' 링크를 클릭하면 자세한 출력 로그 정보를 확인할 수도 있습니다. 출력 로그는 패키징 프로세스가 성공적으로 끝나지 않은 경우 무엇이 잘못되었는지 알아낼 때 좋습니다.

log.png

log_MAC.png

익숙하지 않은 분들의 경우, 오류나 경고같은 중요 로그 메시지들은 일반 메시지 로그 창에 로그로 기록됩니다:

message_log.png

message_log.png

message_log_Mac.png

이 창이 보이지 않으면, 창 > 개발자 툴 > 출력 로그 / 메시지 로그 옵션으로 열 수 있습니다.

패키징된 게임 실행하기

패키징을 하면, 패키징 프로세스 결과물을 출력할 디렉터리를 선택하는 창이 뜹니다. 패키징된 게임은 플랫폼에 맞는 서브디렉터리에 들어갑니다. 예를 들어 C:/PackagedOutput/ 이라는 디렉터리를 선택한 경우, Windows 빌드는 C:/PackagedOutput/WindowsNoEditor/ 에 들어갑니다. 그 서브디렉터리에서, 플랫폼에 맞는 포맷의 패키징된 게임을 찾을 수 있습니다. 예를 들어 Windows 게임은 .exe 파일, Android 게임은 .apk.obb 파일에 .bat 인스톨러 포함, iOS 게임은 .ipa 파일이 있습니다. 생성되는 파일 수와 유형은 타깃 플랫폼에 따라 다릅니다. 다음 이미지는 WindowsNoEditor 서브디렉터리의 Windows 프로젝트 출력 예제를 보여줍니다:

results.png

results_MAC.png

배포

App Store 나 Google Play Store 에 iOS 또는 Android 게임을 제출하려면, Distribution (배포) 모드로 게임 패키지를 만들어 줘야 합니다. 그 방법은 패키징 메뉴의 패키징 세팅 옵션에서 Distribution (배포) 체크박스를 체크합니다.

iOS 에서는 애플의 개발자 웹사이트에서 배포 Certificate 와 MobileProvision 을 만들어 줘야 합니다. Development Certificate 와 같은 방식으로 Distribution Certificate 를 설치한 다음, 배포 Provision 이름에 "Distro_" 접두사를 붙여줍니다 (즉 Distro_MyProject.mobileprovision 과 MyProject.mobileprovision 이 됩니다).

Android에서는 .apk 파일 사이닝을 할 키를 만들어준 다음, SigningConfig.xml 라는 파일을 포함해서 저희 빌드 툴에 약간의 정보를 줘야 합니다. 이 파일은 설치된 Engine 디렉터리에 (Engine/Build/Android/Java/) 존재합니다. 이 파일을 편집하면, 모든 프로젝트에 적용됩니다. 하지만 이 파일을 프로젝트의 Build/Android/ (Java 를 뺀) 디렉터리에 복사하면, 해당 프로젝트에만 사용됩니다. 키 생성법과 그 파일을 채우는 법은 파일 자체에서 찾아볼 수 있습니다.

고급 세팅

메인 메뉴에서 파일 > 프로젝트 패키지 > 패키징 세팅... 또는 편집 > 프로젝트 세팅 > 패키징 을 선택하면 패키징 기능에 대한 여러가지 고급 환경설정 옵션을 확인할 수 있습니다.

settings.png

현재 다음과 같은 옵션이 포함됩니다:

옵션

설명

Build Configuration

빌드 환경설정 - 코드 기반 프로젝트를 컴파일할 빌드 환경설정입니다. 코드 프로젝트 디버깅의 경우 DebugGame 을 선택합니다. 참고로 블루프린트 전용 프로젝트는 이 옵션이 없습니다. 그 외 디버깅은 최소한으로 지원하지만 퍼포먼스가 좋은 개발용으로는 대부분 Development 를 선택합니다. 최종 출하 빌드의 경우, 디버깅 정보와 (화면상에 디버그 메시지를 출력하거나 디버그 셰이프를 그리는 등의) 디버깅 특화 기능이 제거된 Shipping 을 선택합니다.

Staging Directory

스테이징 디렉터리 - 패키징된 빌드가 들어가게 될 디렉터리입니다. 타깃 디렉터리 선택 창에서 다른 디렉터리를 선택하면 자동으로 업데이트됩니다.

Full Rebuild

풀 빌드 - 코드를 전부 컴파일할지 입니다. 끄면 수정된 코드만 컴파일합니다. 패키징 프로세스 속도가 빨라질 수 있습니다. Shipping 빌드의 경우 누락되거나 오래된 것이 없는지 확실히 하기 위해 항상 풀 리빌드를 해야 합니다. 이 옵션은 기본으로 켜져 있습니다.

Use Pak File

Pak 파일 사용 - 프로젝트의 애셋들을 개별 파일로 놔둘지 하나의 패키지로 만들지 입니다. 켜면 모든 애셋은 하나의 .pak 파일에 들어가며, 끄면 모든 파일을 일일이 복사합니다. 프로젝트에 애셋 파일이 많은 경우, Pak 를 사용하면 전송해야 하는 파일 양이 줄어들어 배포가 쉬워질 수 있습니다. 이 옵션은 기본으로 꺼져 있습니다.

Generate Chunks

청크 생성 - 스트리밍 인스톨에 사용할 수 있는 .pak 파일 청크를 생성할지 입니다.

Build Http Chunk Install Data

HTTP 청크 설치 데이터 빌드 - HTTP 청크 인스톨러용 데이터를 생성할지 입니다. 이를 통해 데이터를 웹서버에 호스팅하여 실행시간에 설치되도록 하는 것이 가능합니다.

Http Chunk Install Data Directory

HTTP 청크 설치 데이터 디렉터리 - 빌드가 완료되면 데이터가 설치되는 디렉터리입니다.

Http Chunk Install Data Version

HTTP 청크 설치 데이터 버전 - HTTP 청크 설치 데이터의 버전명입니다.

Include Prerequisites Intaller

사전 요구사항 인스톨러 포함 - 운영체제 컴포넌트 재배포판 등 패키징된 게임의 사전 요구사항 인스톨러를 포함시킬 것인지를 나타냅니다.

콘텐츠 쿠킹

개발자로서 새 게임이나 변경된 게임에 대한 반복작업을 할 때, 모든 것을 스테이징 디렉터리에 패키징하여 넣은 다음 거기서 그것을 실행하는 지루한 프로세스 전체를 항상 반복하고 싶지는 않을 것입니다. 그래서 파일 > 콘텐츠 쿠킹 > [플랫폼 이름] 을 선택하면 패키징 없이 특정 타깃 플랫폼용 콘텐츠만 쿠킹하는 것도 가능합니다.

이 기능은 프로젝트의 로컬 디벨로퍼 워크스페이스에 있는 콘텐츠를 업데이트할 뿐, 스테이징 디렉터리에 애셋을 복사하지는 않는다는 점 유념해 주시기 바랍니다. 로컬 디벨로퍼 워크스페이스에서 게임을 바로 실행하여 빠른 반복작업을 할 수 있습니다.

로드 시간 최적화

로드 시간을 짧게 하는 것은 오픈 월드 게임에 필수지만, 어떤 게임에도 좋은 일입니다. 언리얼 엔진에서는 패키지 프로세스 도중 프로젝트 로드 시간을 최적화시키는 메서드를 다수 제공하고 있습니다. 게임 로드 시간을 줄이는 실전적인 방법을 몇 가지 소개합니다. 프로젝트 패키지를 만드는 방법에 대해서는, 게임 패키징 & 쿠킹 문서를 참고하세요.

이벤트 주도형 로더 (EDL) 및 비동기 로딩 스레드 (ALT) 사용

  • Asynchronous Loading Thread (ALT, 비동기 로딩 스레드)는 기본으로 꺼져있는 옵션이지만, 프로젝트 세팅 - 엔진 - Streaming (스트리밍)에서 켤 수 있습니다. 엔진에 변경을 가한 경우 약간의 미세 조정이 필요할 수 있지만, 일반적으로 ALT 는 게임의 "최초" (up-front) 로드 시간과 지속적인 데이터 스트리밍 시간을 포함한 전반적인 로드 시간을 배가시켜 줍니다. ALT 작동 방식은 시리얼라이즈와 포스트 로딩 코드를 두 개의 별도 스레드에 동시 실행시키는 방식으로 작동하므로, 그에 따라 게임 코드의 UObject 클래스 생성자, PostInitProperties 함수, Serialize 함수는 반드시 스레드 안전성을 확보(thread-safe)해야 합니다. 이 ALT 기능이 가동되면 로드 속도는 두 배가 됩니다. 비동기 로딩 메서드 (C++) 사용 관련 상세 정보는 비동기 애셋 로딩 문서를 참고하세요.

  • Event-Driven Loader (이벤트 주도형 로더)는 기본적으로 켜져있지만, 프로젝트 세팅 - 엔진 - Streaming (스트리밍) 섹션에서 끌 수 있습니다. 대부분의 프로젝트의 경우 EDL 을 사용하면 로드 시간이 절반으로 줄어듭니다. EDL 은 안정적이며 언리얼 엔진 구버전에 하위 포팅, 또는 수정 및 커스터마이징된 엔진 버전에 맞게 미세 조정 가능합니다.

EngineStreamingSettings.png

.pak 파일 압축

  • 프로젝트에 .pak 파일 압축을 사용하려면, 프로젝트 세팅 - Packing (패키징) 섹션을 찾습니다. 거기서 Packaging (패키징) 제목줄의 고급 옵션 부분을 열면 나타나는 Create compressed cooked packages (압축 쿠킹 패키지 생성) 옵션을 체크합니다.

  • 대부분의 플랫폼에서는 자동 압축을 제공하지 않기에, .pak 파일을 압축하면 로드 시간이 단축되지만, 고려해야 할 상황이 몇 가지 있습니다:

플랫폼

추천

Sony PlayStation 4

모든 PlayStation4 타이틀에 자동 적용되는 압축과 .pak 파일 압축은 중복되어 파일 크기가 줄어드는 혜택 없이 압축 작업만 중복하게 됩니다. 그러므로 PlayStation 4 릴리즈의 경우 .pak 파일 압축은 하지 않는 것이 좋습니다.

Nintendo Switch

압축된 파일 로드가 더 빠를 수도 있지만, 데이터 압축을 푸는 데 걸리는 시간이 더 오래 걸릴 수도 있습니다. Switch 타이틀의 경우 타이틀마다 직접 테스트해 보고 결정하는 것이 좋습니다.

Microsoft XBoxOne

XBoxOne 플랫폼에서 가장 빠른 로드 시간을 내기 위해서는 압축이 매우 중요합니다.

Steam

사용자가 다운로드하는 도중 파일을 압축하므로, 다운로드 시간은 압축중인 게임의 .pak 파일에 영향받지 않습니다. 하지만 미압축 파일의 경우 Steam 의 차등 패치 시스템이 나을 것입니다. 압축된 .pak 파일은 소비자 시스템의 디스크 공간을 절약해 주지만, 패치할 때 다운로드 시간은 길어집니다.

Project Settings - Compress Pak 옵션

이 박스를 체크하면 .pak 파일의 압축을 켤 수 있습니다.

.pak 파일 순서

로드 시간 단축을 위해서는 .pak 파일 순서를 잘 지정하는 것이 중요합니다. .pak 파일 최적의 순서를 지정하는 데 도움을 드리기 위해, UE4 에서는 데이터 애셋의 필요 순서를 알아내어 더욱 빠른 로딩 패키지를 제작하기 위한 툴 세트가 제공됩니다. 개념적으로, 이 프로세스는 프로파일 주도형 최적화와 비슷합니다. .pak 파일 순서 지정 방법은 다음과 같습니다:

  1. -fileopenlog 명령줄 옵션으로 패키지 게임을 빌드하고 실행시켜, 엔진이 파일을 여는 순서를 기록하도록 하는 것입니다.

  2. 게임 주요 영역을 전부 확인하세요. 모든 레벨, 모든 플레이가능 캐릭터, 모든 무기, 모든 비히클 등을 로드하세요. 모든 것이 로드했으면, 게임을 종료합니다.

  3. 디플로이된 게임에 보면 .pak 파일 순서 최적화에 필요한 정보가 들어있는 GameOpenOrder.log 라는 파일이 있습니다. 예를 들어 Windows 빌드의 경우, 이 파일은 WindowsNoEditor/(YourGame)/Build/WindowsNoEditor/FileOpenOrder/ 에 있습니다. 이 파일을 /Build/WindowsNoEditor/FileOpenOrder/ 아래 개발 디렉터리에 복사하세요.

    디플로이된 게임에 보면 .pak 파일 순서 최적화에 필요한 정보가 들어있는 GameOpenOrder.log 라는 파일이 있습니다. 예를 들어 Mac 빌드의 경우, 이 파일은 MacNoEditor/(YourGame)/Build/MacNoEditor/FileOpenOrder/ 에 있습니다. 이 파일을 /Build/MacNoEditor/FileOpenOrder/ 아래 개발 디렉터리에 복사하세요.

  4. 로그 파일을 배치하고, .pak 파일을 리빌드합니다. 그러면 이번 것과 앞으로 생성되는 모든 .pak 파일은 로그 파일에 나타난 파일 순서를 사용할 것입니다.

프로덕션 환경에서는, 이 로그 파일을 소스 컨트롤에 체크 인 하고, 주기적으로 -fileopenlog 를 붙여 실행한 뒤 주기적으로 업데이트해 주는 것은 물론, 게임 발매 준비가 되면 마지막으로 한 번 더 실행시킨 뒤 포함시켜 줘야 할 것입니다.