Clang を使用して Microsoft プラットフォームをビルドする

Unreal Engine (UE) では Windows 上で Clang コンパイラを使用して、サポートされている Microsoft プラットフォーム のビルドを支援します。Clang は次の方法で有効にすることができます。

• ビルド コンフィギュレーション
• コマンドライン引数
• エンジンのコンフィギュレーション

このページには、次のものなどを指定するための追加オプションの表も含まれています。

• Clang リンカ
• Clang バージョン
• MSVC バージョン
• ツールチェーン バージョン

詳細は、後述の「追加オプション」セクションを参照してください。UE 5.3 でサポートしている最新の Clang バージョンは Clang 16 です。

Clang について

Clang は、C、C++、Objective-C、および Objective-C++ をマシン コードにコンパイルするフロントエンドのコンパイラです。また、Clang は MSVC (Microsoft Visual C++) コンパイラの代替です。

Clang をインストールする

Clang は、Visual Studio を通じて、または直接「LLVM Download」ページからインストールすることができます。

Clang を有効にする

Clang をインストールした後は、次のいずれかの方法に従って Unreal プロジェクトで Clang を有効にします。

ビルド コンフィギュレーション

ビルド コンフィギュレーション で Clang を有効にするには、エンジンの「BuildConfiguration.xml」ファイルに移動して次を追加します。

<?xml version="1.0" encoding="utf-8" ?>
<Configuration xmlns="https://www.unrealengine.com/BuildConfiguration">
	...
	<WindowsPlatform>
      		<Compiler>Clang</Compiler>
	</WindowsPlatform>
...
</Configuration>
Copy full snippet

<?xml version="1.0" encoding="utf-8" ?> <Configuration xmlns="https://www.unrealengine.com/BuildConfiguration"> ... <WindowsPlatform> <Compiler>Clang</Compiler> </WindowsPlatform> ... </Configuration>

コマンドライン引数

コマンドライン引数 を使用して Clang を有効にするには、-Compiler=Clang オプションを渡します。

エンジンのコンフィギュレーション

エンジンのコンフィギュレーション で Clang を有効にするには、「DefaultEngine.ini」などのエンジンのコンフィギュレーション ファイルに移動して次を追加します。

[/Script/WindowsTargetPlatform.WindowsTargetSettings]
CompilerVersion=Clang
Copy full snippet

[/Script/WindowsTargetPlatform.WindowsTargetSettings] CompilerVersion=Clang

追加のオプション

次のオプションでは、以下のことを前提としています。

• ビルド コンフィギュレーション オプションは、「BuildConfiguration.xml」の「<WindowsPlatform>...</WindowsPlatform>」セクション内に追加されます。
• エンジンのコンフィギュレーション オプションは、「DefaultEngine.ini」などのエンジンのコンフィギュレーション ファイルの「[/Script/WindowsTargetPlatform.WindowsTargetSettings]」セクションに追加されます。

Clang リンカ

Clang リンカは、Clang を使用してコンパイルするときに Clang リンカを使用するかどうかを決定するブーリアンのオプションです。

Epic では Microsoft プラットフォーム用の Clang リンカを使用しておらず、現時点ではテストが行われていません。

Clang コンパイラのバージョン

Clang コンパイラのバージョンは、指定されたコンパイラのどのバージョンが使用されるかを決定する文字列のオプションです。次のオプションがあります。

• 具体的なバージョン番号：たとえば「16.0.0」のように、バージョン番号を直接指定して使用します。
• 最新：最も新しいインストール済みのバージョンを使用します。

MSVC バージョン

MSVC ツールチェーンは、どのツールチェーンが使用されるかを決定する文字列のオプションです。次のオプションがあります。

• VisualStudio2022
• VisualStudio2019

ツールチェーン バージョン

ツールチェーンのバージョンは、MSVC ツールチェーンのどのバージョンが使用されるかを決定する文字列のオプションです。次のオプションがあります。

• 具体的なバージョン番号：たとえば「14.37.32822」のように、バージョンを直接指定して使用します。
• 最新：最も新しいインストール済みのバージョンを使用します。
• プレビュー：最も新しいインストール済みのプレビュー バージョンを使用します。

追加資料

次に関する内容については、次のリンクから参照してください。

• 「ビルド コンフィギュレーション」の「WindowsPlatform」セクション
• コマンドライン引数
• エンジンのコンフィギュレーション ファイル