Unreal Engine 用に Visual Studio をセットアップする

Unreal Engine (UE) は Visual Studio (VS) とスムーズに統合するように設計されており、プロジェクトのコードをすばやく簡単に変更してコンパイル後にすぐ結果を確認できます。Visual Studio を Unreal Engine と連携するように設定すると、Unreal Engine を使用するデベロッパーの効率と全体的なユーザー エクスペリエンスが向上します。

本ページでは、Unreal Engine から Visual Studio へのワークフロー設定の基本も説明します。

バージョンの互換性

次の表に、バイナリ バージョンの Unreal Engine に統合された Visual Studio のバージョンを示します。

UE 5.1 では、Unreal Build Tool (UBT) は、最新バージョンをサポートしない Platform SDK がインストールされていない限り、インストールされている Visual Studio の最新バージョンの Visual Studio ソリューション ファイルを生成するようになりました。この場合、UBT は該当する Platform SDK をサポートする最新バージョンの Visual Studio 用ソリューションファイルを生成します。

UE 5.2 では、Unreal Engine のコンパイルにおいて、VS 2022 がデフォルトの Visual Studio バージョンとなりました。

UE 5.2 用のプラグインをプリコンパイルする場合は VS 2019 の使用をお勧めします。これにより、VS 2019 または VS 2022 のどちらを使用しているかにかかわらず、UE 5.2 のすべてのユーザーは自分のプラグインを使用できるようになります。プラグインの詳細については、「Plugins」ドキュメントを参照してください。

Unreal Engine で必須なるインストーラ

Epic Launcherから UE をインストールする場合、または GitHub からクローンする場合、UE で必須とされるインストーラが自動的に起動します。ただし、Perforce から UE をインストールまたは同期する場合は、ローカルにビルドした UE ツールを実行する前に、UE で必須とされるインストーラを手動で起動する必要があります。このインストーラはコードベースの UNREAL_ENGINE_ROOT\Engine\Extras\Redist\en-us\ に置かれています。

新しい Visual Studio のインストール

VS を初めてインストールする場合は、次のオプションを有効化する必要があります。

Visual Studio Workloads

VS で Unreal Engine を開発するには、以下のオプションの Workloads をインストールする必要があります。

• .NET デスクトップ開発
• C++ によるデスクトップ開発
• ユニバーサル Windows プラットフォーム開発
• C++ によるゲーム開発

C++ ツール

VS のインストールに C++ ツールを追加するには、これらの追加オプションおよび [Workloads] から [Game development with C++] を選択します。

• C++ プロファイリング ツール
• C++ AddressSanitizer
• Windows 10 SDK (10.0.18362 以降)
• Unreal Engine インストーラー

推奨設定

UE で VS を使用するデベロッパーの場合、次の設定を推奨します。

テーマを Dark に変更しているので、VS バージョンは少し異なって見えます。[Tools] > [Options] > [Environment] > [General] > [Color theme] で変更することができます。

ソリューション設定用のドロップダウン メニューの幅を広げる

1. VS を起動します。VS を初めて開く場合は、[Get Started (開始する)] ウィンドウが表示されます。[Continue without code] をクリックします。

   クリックして画像を拡大

2. ツールバーを右クリックして、表示されるメニューの下部で [Customize (カスタマイズ)] を選択します。

   クリックして画像を拡大

3. [Commands] タブをクリックして [Toolbar (ツールバー)] ラジオボタンを選択します。
   

4. ツールバー の横のドロップダウンで、[Standard] を選択します。
   

5. [Preview] リストで [Solution Configurations (ソリューション設定)] コントロール (スクロールダウンする必要があります) を選びます。
   

6. [Width (幅)] を 200 に設定して、[OK] をクリックします。
   

7. [Customization] の [Close] をクリックします。すぐにツールバーが更新されます。

ソリューション プラットフォーム用のドロップダウンを追加する

1. [Standard (標準)] ツールバーの一番右にあるボタンを探します (マウスのカーソルを合わせると [Standard Toolbar Options (標準ツールバー オプション)] というラベルが表示されます)。

2. ドロップダウン ボタン > [Add (追加)] または [Remove (追加)] ボタン > [Solution Platforms (ソリューション プラットフォーム)] の順に選択してツールバーにメニューを追加します (デフォルトで有効の場合があります)。

エラーリスト ウィンドウをオフにする

通常、コードにエラーがあると エラー リスト(Error List) ウィンドウが自動的にポップアップします。しかし、UE の作業中に誤ったエラー情報が エラー リスト ウィンドウに表示され場合があります。UE で作業する際は、この エラー リスト ウィンドウをオフにして、出力 (Output) ウィンドウを使用して実際のコード エラーを確認することを推奨します。エラー リスト ウィンドウをオフにするには、次の手順に従ってください。

1. [Error List (エラー リスト)] ウィンドウが開いている場合は閉じます。

2. [Tools (ツール)] メニューから [Options (オプション)] ダイアログを開きます。
   

3. [Projects and Solutions (プロジェクトとソリューション)] を選択して [Always show error list if build finishes with error (ビルドがエラーで終わった場合、常にエラー リストを表示する)] を無効にします。
   

4. [OK] をクリックします。

その他の便利な構成設定を次に示します。

• [Show Inactive Blocks (非アクティブなブロックを表示)] をオフにします。このオプションをオンにすると、コードの一部がテキスト エディタでグレーアウトされる場合があります。設定をオフにするには、[Tools (ツール)] > [Options (オプション)] > [Text Editor (テキスト エディタ)] > [C/C++] > [View (表示)] の順に選択します。

• [Disable External Dependencies Folders (外部依存関係フォルダを無効にする)] を「True」に設定して、[Solution Explorer (ソリューション エクスプローラー)] で不要なフォルダを非表示にします。[Disable External Dependencies Folders (外部依存関係フォルダを無効にする)] は [Tools (ツール)] > [Options (オプション)] > [Text Editor (テキスト エディタ)] > [C/C]++ > [Advanced (詳細設定)] にあります。

• 必要がなければ [Edit & Continue (編集して続行)] 機能をオフにします。[Tools (ツール)] > [Options (オプション)] > [Debugging (デバッグ)] > [Edit & Continue (編集して続行)] を選択します。

• [IntelliSense] をオンにします。