Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

Unreal Engine の新しいバージョンがリリースされると、新しいバージョンのエンジン用に現在のプロジェクトを変換する作業を行うか、現在使用しているエンジンのバージョンのままにしてプロジェクトの機能を維持するか、選択する必要があります。

プロジェクトの変換に関する作業をすべて取り除く方法はありませんが、UE4 が提供する便利な機能を利用できます。UE4 は簡単なプロジェクトを完全に更新する UI ベースのプロジェクト更新機能を搭載し、さらにもっと複雑なプロジェクトの更新作業を開始することもできます。

簡単なプロジェクトを変換する

複雑なコードやブループリントをまだ作成していない簡単なプロジェクトを変換する場合は、以下の手順に従います。

1. プロジェクトを変換する先の UE4 のバージョンを起動して、対象のプロジェクトを見つけます。現在のバージョンと異なる場合は、リストに表示された各プロジェクトについて UE4 バージョンを確認できます。

2. 対象のプロジェクトを選択して開くと、そのプロジェクトが別のバージョンで作成されたことを示す警告メッセージが表示されます。オリジナル データの損傷を防ぐために、デフォルトで UE4 はプロジェクトのコピーを作成して変換を行います。

   [More Options (より多くのオプション)] をクリックするとオリジナル プロジェクトを開いて変換したり、プロジェクトの変換をスキップしてそのまま開いたりできますが、どちらも推奨しません。

   古いバージョンの UE4 では、新しいバージョンのプロジェクトを開けません。開こうとすると失敗します。

3. [Open a copy (コピーを開く)] (または [Convert in-place] ) をクリックすると、UE4 がすぐに新しいバージョンのエンジンに対応したプロジェクト ファイルのコードを自動で生成します。

4. この自動変換プロセスに UE4 が成功すると、目的のプロジェクトがエディタで開きます。

複雑なプロジェクトを変換する

複雑なプロジェクトの変換は簡単なプロジェクトの変換と似ていますが、特にカスタムの C++ コードやブループリントを使用している場合に UE4 がプロジェクトの完全なコードを生成できない可能性がある点が異なります。そのような場合は部分的な変換のみを実行し、Visual Studio を利用して手動で変換プロセスを完了できます。

複雑なプロジェクトの場合は、以下の手順に従います。

1. 簡単なプロジェクトの変換と同じように、まず最初に対象のプロジェクトを見つけます。この例では、古いバージョンで作成した PlatformerGame サンプル プロジェクトを使用します。

2. 簡単な変換に関する上記の説明で、ステップ 2 と 3 に従います。

3. 通常、複雑なプロジェクトのコード生成プロセスは失敗し、変換プロセスで問題が発生した箇所に関する詳細を含むエラー メッセージ ウィンドウを表示します。

4. Visual Studio でプロジェクトを開いて、自動変換の完了を妨げる問題を手動で修正するオプションを利用できます。こうした問題は、プロジェクトの具体的な詳細によって異なります。