プロジェクト ランチャー

Unreal Engine で使用するプロジェクトをデプロイするプロジェクト ランチャーのリファレンス

プロジェクト ランチャーは、プロジェクトのテスト、デバッグ、リリースをするために、プロジェクトのビルドをクックして、指定したプラットフォームにデプロイします。以下のリファレンスは、プロジェクト ランチャーを構成している要素と、コンテンツを異なるプラットフォームにデプロイするためのカスタム ローンチ プロジェクトの作成時に使用可能な設定の詳細です。

Project Launcher UI

プロジェクト ランチャー インターフェース

プロジェクト ランチャーを開くには、[Platform] をクリックして [Project Launcher] を選択します。

Open the Project Launcher window

プロジェクト ランチャーのインターフェースは、大きく 2 つのエリアに分けられます。

Project Launcher UI description

  1. デフォルト ローンチ プロファイル

  2. カスタム ローンチ プロファイル

[Default Launch Profiles (カスタム ローンチ プロファイル)] ウィンドウで使用可能なプラットフォームを確認し、ビルドのデプロイ先のデバイスの中から選択することができます。ウィンドウの上部で [Project] (現在開いているプロジェクトと異なる場合) とこれらのデフォルト ローンチ プロファイルの [Advanced (詳細)] 設定の切り替えを指定することができます。

[Advanced (詳細)] トグルボタンをクリックすると、デフォルト ローンチ プロファイルの隣に追加オプションができて、[Build Configuration (ビルド コンフィギュレーション)][Cook] メソッドを選択することができます。

Advance options in the Project Launcher

[Custom Launch Profiles] ウィンドウで、コンテンツのビルドやデプロイ方法を細かく指定することができる自分のプロファイルを作成することができます。詳細は カスタム ローンチ プロファイル セクションをご覧ください。

カスタム ローンチ プロファイル

プロジェクト ランチャーを使って、すべてのプラットフォームまたは Nintendo Switch のような特定のプラットフォームで使用できる カスタム ローンチ プロファイル (Custom Launch Profile) を作成することができます。ビルド作業で行うクック、パッケージ、デプロイ方法を設定して、特別な方法でコンテンツをビルドすることができます。

[Custom Launch Profiles] ウィンドウの プラス (+) 記号をクリックすれば、独自のカスタム ローンチ プロファイルの追加も可能です。

Add a Custom Launch Profile

[Custom Launcher Profile] ウィンドウがすぐに開きます。わかりやすい名前を付けて、後になっても特定できるようにしておきましょう。

Custom Launch Profile editor window

名前と説明

ヘッダー バーにこのカスタム プロファイルに適用できる [Name][Description] があります。いずれかのセクションのテキストをダブルクリックして編集を開始します。

Editing of the name and description of the Custom Launcher Profile

Project

[Project] セクションでは、このプロファイルを関連づけたいプロジェクトを指定したり、他のプロジェクトと一緒に使用するかどうかを指定することができます。デフォルト設定は [Any Projec]t ですが、どれかに指定して設定することもできます。複数のプラットフォームからプロジェクトを開発していて、それらのプラットフォームが特殊な方法によるデプロイ、テスト、デバッグ、リリースを要求する場合に有用です。

Specify project for the Custom Launch Profile

Build

[Build] セクションで、プロジェクトの開発段階に応じてビルドおよびデプロイするコンフィギュレーションの種類や、プロジェクトのテスト、デバッグ、リリース方法を指定することができます。

Build section

設定

説明

Build Configuration

プロジェクトのビルトとテストを行いたいコンフィギュレーションを選択します。

Settings of the Build Configuration

コンフィギュレーション

説明

DebugGame

このコンフィギュレーションはエンジンを最適化してビルドしますが、ゲームコードはデバッグ可能な状態のままです。ゲーム モジュールのみをデバッグする場合に理想的です。

Development

このコンフィギュレーションはリリース ビルドと同じです。Unreal Editor ではデフォルトで Development を使用します。このコンフィギュレーションを使ってプロジェクトをコンパイルすると、プロジェクトに対して行ったコード変更がエディタで反映されているかを確認することができます。

Shipping

最適なパフォーマンスを実現し、ゲームを出荷するためのコンフィギュレーションです。このコンフィギュレーションはコンソール コマンド、統計情報、プロファイリング ツールを削除します。また、ゲームがリリースできる状態になった時に使用してください。

Build UAT

有効にすると Unreal Automation Tool がビルドの一部としてビルドされます。

Additional Command Line Parameters

ここで指定されたパラメータは起動時にアプリケーションに渡されます

Cook

[Cook] セクションには by the bookon the fly の 2 通りの方法でクックすることができます。

By the Book

[Cook] の by the book オプションを使うと、どのコンテンツをクックするのか指定することができるようになるので、ゲームを起動する前に予めすべてをクックします。

Cook By the Book option

設定

説明

Cooked Platform

このカスタム ローンチ プロファイルがコンテンツをクックする ターゲット プラットフォームをリストから選択します。

Cooked Cultures

このコンテンツをクックするローカリゼーション カルチャーから選択します。

Cooked Maps

クックするタイトルで利用できるマップから選択します。

リリース / DLC / パッチ処理の設定

Create a release version of the game for distribution

配布に使われるタイトルのリリース バージョンの作成ができるようになります。

Name of the new release to create

クック中に使用する新しい名前をリリースに付けることができます。

Release version this is based on

次回のリリース / DLC / パッチ処理の元になるリリース バージョンです。

Generate Patch

有効にすると、ソース コンテンツに対する差分を取り、変更のあったファイルのみが新しい pak ファイルにインクルードされます。

Build DLC

有効にすると、オリジナル ゲームでリリースされたコンテンツなしの DLC がビルドされます。

Name of the DLC to build

ビルドされる DLC 名を付けます。

Include Engine Content

有効にすると、オリジナル リリースには含まれなかった Engine の中のコンテンツが DLC に含まれます。チェックが入っていない場合、Engine ディレクトリからコンテンツにアクセスする時にエラーが発生します。

詳細設定

Iterative Cooking:Only cook content modified from previous cook

有効にすると、変更されたコンテンツのみがクックされるので、クック処理が速くなります。可能な限りこのオプションを使用することを推奨します。

Stage base release pak files

有効にすると、基本のリリース バージョンに存在する変更のない pak ファイルをステージングします。

Compress Content

有効にすると、生成されたコンテンツが圧縮されます。圧縮すると小さくなりますが、解凍が必要なためロード時間は長くなる可能性があります。

Add a new patch tier

有効にすると、パッチ コンテンツで pak ファイルが生成され新しい番号が付けられます。

Save Packages Without Versions

有効にすると、最新のバージョンと見なしてロードされます。リスクがありますが、パッチサイズは小さくなります。

Store all content in a single file (UnrealPak)

有効にすると、コンテンツは個々の多数のファイルではなく、1 つの UnrealPak ファイルとしてデプロイされます。

Encrypt INI files (only with Use Pak File enabled)

有効にすると、UnrealPak ファイル内に格納されている ini ファイルが暗号化されます。

Generate Chunks

有効にすると、コンテンツは1 つの UnrealPak ファイルではなく、個々の多数のファイルとしてデプロイされます。

Don't include Editor content in the build

有効にすると、クッカは Editor 内のコンテンツをスキップしてビルド内には含みません。

HTTP Chunk Install Data Path

Create HTTP Chunk Install Data

有効にすると、コンテンツは複数の Pak ファイルに分割されて、ダウンロード可能なデータとして格納されます。

HTTP Chunk Install Data Path

Chunk Install Data 用のファイル パスを指定します。

HTTP Chunk Install Release Name

このバージョンの HTTP Chunk Install Data の名前です。

Cooker Build Configuration

クック コマンドレットに使用するビルド コンフィギュレーションを設定します。

Additional Cooker Options

追加のクッカ コマンドライン パラメータを指定することができます。

On the Fly

Cook on the fly オプションは、必要に応じて、デバイスに送る前にランタイム時にコンテンツをクックすることができます。

Cook On the Fly option

設定

説明

Only Cook Modified Content

有効にすると、変更されたコンテンツのみがクックされるので、クック処理が速くなります。可能な限りこのオプションを有効にすることを推奨します。

Additional Cooker Options

追加のクッカ コマンドライン パラメータを指定することができます。

Package

[Package] セクションでは、ビルドのパッケージ方法と、格納方法 (ローカルにするのか、それとも共有レポジトリでアクセス可能にするのか) を選択することができます。

Package section

設定

説明

Package Method

Package & Store Locally

Local Directory Path

Is this build for distribution to the public

チェックを入れると、ビルドは公開 (配布) としてマークされます。

Include an installer for prerequisitea of packaged games

オンにすると、ビルドには、それをサポートするプラットフォームの前提条件インストーラーが含まれます。

Use container files for optimized loading (I/O Store)

オンにすると、ビルドは最適化されたロード (I/O ストア) のためにコンテナ ファイルを使用します。

Make a binary config file for faster runtime startup times

オプションのカスタム データと共に、構成 (.ini、プラグインを含む) データをバイナリ ファイルにベイクします。

Optional I/O Store Reference Block Database:

  • 以前にリリースされた iostore コンテナのディレクトリ内のグローバル UTOC へのパス。

  • 参照ブロック コンテナを復号化するための暗号 JSON へのパス (実際の場合)。

Package & Store In Repository

Repository Path

Archive

[Archive] セクションでは、後の参照のためのアーカイブにする場合、ビルドとディレクトリ パスをアーカイブするかどうかを指定することができます。

Archive.png

Deploy

[Deploy] セクションでは、[file server (ファイル サーバー)][copying to device (デバイスへコピー)][copying from a repository to device (レポジトリからデバイスへコピー)] を使って、現在のビルドのデバイスへのデプロイ方法を決める必要があります。

以下のデプロイ方法の中から選択します。

Deploy method selection

  • [File Server] は実行時にコンテンツのクックおよびデプロイを行います。

  • [Copy to Device] は、クック済みビルド全体をデバイスにコピーします。

  • [Do Not Deploy] は、クックとパッケージ化が完了すると、ビルドをデバイスには一切デプロイしません。

  • [Copy Repository] は、指定したファイル位置からどんなデバイスへもビルドをコピーします。

File Server

[File Server] を選択すると、以下の設定が利用できます。

File server deploy method

設定

説明

Default Deploy Platform

コンテンツをデプロイするデフォルトのターゲット プラットフォームを設定します。

詳細設定

Hide the file server's console window

有効にすると、ファイル サーバーのコンソール ウィンドウがデスクトップで非表示になります。

Streaming Server (実験的機能)

有効にすると、ファイル サーバーは、複数のファイルに同時に機能する実験的な実装を使用します

Copy to Device

[Copy to Device] を選択すると、以下の設定が利用できます。

Copy to device deploy method

設定

説明

Default Deploy Platform

コンテンツをデプロイするデフォルトのターゲット プラットフォームを設定します。

詳細設定

Only Cook Modified Content

有効にすると、変更されたコンテンツのみがクックされるので、クック処理が速くなります。可能な限りこのオプションを有効にすることを推奨します。

Copy Repository

[Copy Repository (レポジトリをコピー)] を選択すると、以下の設定が利用できます。

CopyToRepository.png

設定

説明

Repository Path

コンテンツをデプロイするレポジトリへのファイル パスを設定します。

Default Deploy Platform

コンテンツをデプロイするデフォルトのターゲット プラットフォームを設定します。

Launch

Launch section

設定

説明

Launch As

ビルドのこのインスタンスの起動方法を選択します。

Launch As options

スタンドアローンClient

スタンドアローン ゲーム クライアントとしてこのインスタンスを起動します。

Listen Server

他のクライアントからの接続を許可することができるゲーム クライアントにこのインスタンスを起動します。

Dedicated Server

このインスタンスを専用のゲームサーバーとして起動します。

Unreal Editor

このインスタンスを Unreal Editor として起動します。

Initial Culture

ビルドを起動する時に、最初に使用しようとするカルチャーを選択します。

Initial Map

ビルドを起動する時に、最初に使用しようとするマップを選択します。

Additional Command Line Parameters

ビルドを起動する時に、使用する必要なコマンドライン パラメータを入力します。

Synchronize Screen Refresh Rate (VSync)

ビルドがプロジェクトをモニターと同じ更新レートで実行するために有効にします。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル