Choose your operating system:
Windows
macOS
Linux
언리얼 프로젝트를 사용자에 배포하기 전, 올바른 방식으로 패키지를 만들어야 합니다. 패키징을 통해 모든 코드와 콘텐츠가 최신인지, 타깃 플랫폼에서 실행하기에 적합한 포맷으로 되어있는지를 확인합니다.
패키징 프로세스 도중에는 여러가지가 단계별로 수행됩니다. 프로젝트별 소스 코드가 먼저 컴파일합니다. 그런 다음 필수 콘텐츠 전부를 타깃 플랫폼에서 사용 가능한 포맷으로 변환, 다른 말로 "쿠킹"합니다. 그 이후 컴파일된 코드와 쿠킹된 콘텐츠를 묶어 Windows용 인스톨러와 같은 배포가능 세트 파일로 만듭니다.
메인 파일 메뉴 아래 Package Project (프로젝트 패키지)라는 옵션이 있습니다. 그 서브 메뉴에는 패키지를 만들 수 있는 대상 플랫폼이 전부 표시됩니다.
Android에서 패키징하는 경우, 여러가지 선택사항이 있습니다. 자세한 정보는 Android 개발 레퍼런스 문서를 참고하세요.
패키징 전 설정할 수 있는 고급 옵션도 몇 가지 있습니다.
게임 디폴트 맵 설정
게임을 패키징하기 전 먼저 패키징된 게임 시작시 로드할 게임 디폴트 맵 을 설정해야 합니다. 맵을 설정하지 않고 기본 프로젝트를 사용중이면 패키징된 게임 시작시 검정 화면만 보입니다. 일인칭 템플릿 또는 삼인칭 템플릿같은 템플릿 맵 중 하나를 사용했다면 시작 맵이 로드됩니다.
게임 디폴트 맵 설정을 위해서는 에디터의 메인 메뉴에서 편집 > 프로젝트 세팅 > 맵 & 모드 를 클릭합니다:
패키지 만들기
프로젝트를 특정 플랫폼용 패키지로 만들려면, 에디터의 메인 메뉴에서 파일 > 프로젝트 패키지 > [플랫폼 이름] 을 선택합니다.
타깃 디렉터리를 선택하라는 대화창이 뜹니다. 패키징이 성공적으로 끝나면, 그 디렉터리에 패키징된 프로젝트가 들어갑니다.
타깃 디렉터리를 확인하고 나면 선택된 플랫폼용으로 프로젝트를 패키징하는 실제 프로세스가 시작됩니다. 패키징은 시간이 매우 오래 걸리는 작업이기 때문에, 이 프로세스는 백그라운드로 진행되며, 에디터 사용을 계속할 수 있습니다. 에디터 우하단의 상태 표시를 통해 진행상황을 알 수 있습니다:
상태 표시의 '취소' 버튼으로 패키징 프로세스를 중단할 수도 있습니다. 추가로 Show Log (로그 표시) 링크를 사용하여 자세한 출력 로그 정보를 표시하면, 패키징 프로세스가 실패했을 때 무엇이 잘못되었는지 확인하거나, 제품에 버그가 될 수 있는 경고를 잡아낼 수 있습니다.
오류나 경고같은 가장 중요한 로그 메시지들은 일반 메시지 로그 창에 로그로 기록됩니다:
이 창이 보이지 않으면, 창 > 개발자 툴 > 출력 로그 / 메시지 로그 옵션으로 열 수 있습니다.
배포
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 를 뺀) 디렉터리에 복사하면, 해당 프로젝트에만 사용됩니다. 키 생성법과 그 파일을 채우는 법은 파일 자체에서 찾아볼 수 있습니다.
고급 세팅
메인 메뉴에서 파일 > 프로젝트 패키지 > 패키징 세팅... 또는 편집 > 프로젝트 세팅 > 패키징 을 선택하면 패키징 기능에 대한 여러가지 고급 환경설정 옵션을 확인할 수 있습니다.
현재 다음과 같은 옵션이 포함됩니다:
|
옵션 |
설명 |
|---|---|
|
Build Configuration |
빌드 구성 - 코드 기반 프로젝트를 컴파일할 빌드 구성입니다. 코드 프로젝트 디버깅의 경우 DebugGame 을 선택합니다. 참고로 블루프린트 전용 프로젝트는 이 옵션이 없습니다. 그 외 디버깅은 최소한으로 지원하지만 퍼포먼스가 좋은 개발용으로는 대부분 Development 를 선택합니다. 최종 출하 빌드의 경우, 디버깅 정보와 (화면상에 디버그 메시지를 출력하거나 디버그 셰이프를 그리는 등의) 디버깅 특화 기능이 제거된 Shipping 을 선택합니다. 블루프린트 전용 프로젝트의 경우 DebugGame 빌드를 생성하는 옵션이 없습니다. |
|
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 |
사전 요구사항 인스톨러 포함 - 운영체제 컴포넌트 재배포판 등 패키징된 게임의 사전 요구사항 인스톨러를 포함시킬 것인지를 나타냅니다. |
서명 및 암호화
언리얼 엔진 4.22 이후 데스크톱 플랫폼에 (Windows, Mac, Linux) 업계 표준 OpenSSL 라이브러리를 통합했습니다.
프로젝트를 출시할 때
.Pak
파일을 서명하거나 암호화하여 데이터 추출이나 부당 변경을 방지할 수 있습니다. 프로젝트의 암호화 세팅을 활성화, 비활성화, 또는 조정하려면
프로젝트 세팅
메뉴의
Crypto
(암호화) 섹션을 찾습니다.
프로젝트 세팅 메뉴의 암호화 옵션입니다.
이 메뉴에서 사용할 수 있는 옵션은 다음과 같습니다.
|
옵션 |
설명 |
|---|---|
|
Encrypt Pak INI Files |
Pak INI 파일 암호화 - 프로젝트의
|
|
Encrypt Pak Index |
Pak 인덱스 암호화 -
|
|
Encrypt UAsset Files |
UAsset 파일 암호화 -
|
|
Encrypt Assets |
애셋 암호화 -
이 설정은 런타임 파일 I/O 퍼포먼스에 영향을 주며, 최종 패키지 데이터의 엔트로피 양을 증가시켜, 배포 패칭 시스템 효율을 떨어뜨립니다. |
|
Enable Pak Signing |
Pak 서명 활성화 - .pak 파일 서명을 활성화 또는 비활성화합니다. |
추가로 서명 또는 암호화 키를 설정하거나 지울 수도 있습니다.
콘텐츠 쿠킹
개발자로서 새 게임이나 변경된 게임에 대한 반복작업을 할 때, 모든 것을 스테이징 디렉터리에 패키징하여 넣은 다음 거기서 그것을 실행하는 지루한 프로세스 전체를 항상 반복하고 싶지는 않을 것입니다. 그래서 파일 > 콘텐츠 쿠킹 > [플랫폼 이름] 을 선택하면 패키징 없이 특정 타깃 플랫폼용 콘텐츠만 쿠킹하는 것도 가능합니다.
이 기능은 프로젝트의 로컬 디벨로퍼 워크스페이스에 있는 콘텐츠를 업데이트할 뿐, 스테이징 디렉터리에 애셋을 복사하지는 않는다는 점 유념해 주시기 바랍니다. 로컬 디벨로퍼 워크스페이스에서 게임을 바로 실행하여 빠른 반복작업을 할 수 있습니다.
로드 시간 최적화
로드 시간을 짧게 하는 것은 오픈 월드 게임에 필수지만, 어떤 게임에도 좋은 일입니다. 언리얼 엔진에서는 패키지 프로세스 도중 프로젝트 로드 시간을 최적화시키는 메서드를 다수 제공하고 있습니다. 게임 로드 시간을 줄이는 실전적인 방법을 몇 가지 소개합니다. 프로젝트 패키지를 만드는 방법에 대해서는, 게임 패키징 & 쿠킹 문서를 참고하세요.
이벤트 주도형 로더 (EDL) 및 비동기 로딩 스레드 (ALT) 사용
-
Asynchronous Loading Thread (ALT, 비동기 로딩 스레드)는 기본으로 꺼져있는 옵션이지만, 프로젝트 세팅 - 엔진 - Streaming (스트리밍)에서 켤 수 있습니다. 엔진에 변경을 가한 경우 약간의 미세 조정이 필요할 수 있지만, 일반적으로 ALT 는 게임의 "최초" (up-front) 로드 시간과 지속적인 데이터 스트리밍 시간을 포함한 전반적인 로드 시간을 배가시켜 줍니다. ALT 작동 방식은 시리얼라이즈와 포스트 로딩 코드를 두 개의 별도 스레드에 동시 실행시키는 방식으로 작동하므로, 그에 따라 게임 코드의
UObject클래스 생성자,PostInitProperties함수,Serialize함수는 반드시 스레드 안전성을 확보(thread-safe)해야 합니다. 이 ALT 기능이 가동되면 로드 속도는 두 배가 됩니다. 비동기 로딩 메서드 (C++) 사용 관련 상세 정보는 비동기 애셋 로딩 문서를 참고하세요. -
Event-Driven Loader (이벤트 주도형 로더)는 기본적으로 켜져있지만, 프로젝트 세팅 - 엔진 - Streaming (스트리밍) 섹션에서 끌 수 있습니다. 대부분의 프로젝트의 경우 EDL 을 사용하면 로드 시간이 절반으로 줄어듭니다. EDL 은 안정적이며 언리얼 엔진 구버전에 하위 포팅, 또는 수정 및 커스터마이징된 엔진 버전에 맞게 미세 조정 가능합니다.
.pak 파일 압축
-
프로젝트에
.pak파일 압축을 사용하려면, 프로젝트 세팅 - Packing (패키징) 섹션을 찾습니다. 거기서 Packaging (패키징) 제목줄의 고급 옵션 부분을 열면 나타나는 Create compressed cooked packages (압축 쿠킹 패키지 생성) 옵션을 체크합니다. -
대부분의 플랫폼에서는 자동 압축을 제공하지 않기에,
.pak파일을 압축하면 로드 시간이 단축되지만, 고려해야 할 상황이 몇 가지 있습니다:
|
플랫폼 |
추천 |
|---|---|
|
Sony PlayStation 4 |
모든 PlayStation4 타이틀에 자동 적용되는 압축과 .pak 파일 압축은 중복되어 파일 크기가 줄어드는 혜택 없이 압축 작업만 중복하게 됩니다. 그러므로 PlayStation 4 릴리즈의 경우
|
|
Nintendo Switch |
압축된 파일 로드가 더 빠를 수도 있지만, 데이터 압축을 푸는 데 걸리는 시간이 더 오래 걸릴 수도 있습니다. Switch 타이틀의 경우 타이틀마다 직접 테스트해 보고 결정하는 것이 좋습니다. |
|
Microsoft XBoxOne |
XBoxOne 플랫폼에서 가장 빠른 로드 시간을 내기 위해서는 압축이 매우 중요합니다. |
|
Steam |
사용자가 다운로드하는 도중 파일을 압축하므로, 다운로드 시간은 압축중인 게임의
|
|
Oculus |
Do not enable compression of the
|
이 박스를 체크하면 .pak 파일의 압축을 켤 수 있습니다.
pak 파일 순서
로드 시간 단축을 위해서는
.pak
파일 순서를 잘 지정하는 것이 중요합니다.
.pak
파일 최적의 순서를 지정하는 데 도움을 드리기 위해, UE4 에서는 데이터 애셋의 필요 순서를 알아내어 더욱 빠른 로딩 패키지를 제작하기 위한 툴 세트가 제공됩니다. 개념적으로, 이 프로세스는 프로파일 주도형 최적화와 비슷합니다.
.pak
파일 순서 지정 방법은 다음과 같습니다:
-
-fileopenlog명령줄 옵션으로 패키지 게임을 빌드하고 실행시켜, 엔진이 파일을 여는 순서를 기록하도록 하는 것입니다. -
게임 주요 영역을 전부 확인하세요. 모든 레벨, 모든 플레이가능 캐릭터, 모든 무기, 모든 비히클 등을 로드하세요. 모든 것이 로드했으면, 게임을 종료합니다.
-
로그 파일을 배치하고,
.pak파일을 리빌드합니다. 그러면 이번 것과 앞으로 생성되는 모든.pak파일은 로그 파일에 나타난 파일 순서를 사용할 것입니다.
프로덕션 환경에서는, 이 로그 파일을 소스 컨트롤에 체크 인 하고, 주기적으로
-fileopenlog
를 붙여 실행한 뒤 주기적으로 업데이트해 주는 것은 물론, 게임 발매 준비가 되면 마지막으로 한 번 더 실행시킨 뒤 포함시켜 줘야 할 것입니다.