コンソール向け GDK で Clang/LLVM を使用する

​

必要な Visual Studio のバージョンとコンポーネント

​

コンパイラおよびリンカ スイッチ

  -Wno-c++98-compat -Wno-c++98-compat-pedantic -Wno-reserved-id-macro
  -Wno-pragma-pack -Wno-unknown-pragmas
  -Wno-unused-command-line-argument

​

サポートされる CPU 組み込み関数

• https://walbourn.github.io/directxmath-3.14/

​

msbuild での Clang/LLVM の使用

<PlatformToolset>ClangCl</PlatformToolset>

1>Game.cpp(56,13): warning : Game.cpp: TODO in Update [-W#pragma-messages]
1>Game.cpp(58,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(79,13): warning : Game.cpp: TODO in Render [-W#pragma-messages]
1>Game.cpp(81,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(137,13): warning : Game.cpp: TODO in CreateDeviceDependentResources [-W#pragma-messages]
1>Game.cpp(139,5): warning : expression result unused [-Wunused-value]
1>Game.cpp(145,13): warning : Game.cpp: TODO in CreateWindowSizeDependentResources [-W#pragma-messages]

​

cmake での Clang/LLVM の使用

​

CMakeExample の使用

1. Visual Studio の [ローカル フォルダーを開く] オプションを使用して、ルートの CMakeExample フォルダー内の Desktop、XBOX Series X|S、または XboxOne フォルダーを開きます。

​

CMakePresets.json 統合

2. ソリューション エクスプローラーで、CMakePresets.json ファイルをダブルクリックします。

"cacheVariables": {
  "XdkEditionTarget": "260400",
  "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
}

3. x64-Debug-Clang または x64-Release-Clang プリセットを選択します。

​

CMakeSettings.json 統合

2. ソリューション エクスプローラーで、CMakeSettings.json ファイルをダブルクリックします。
3. [プラス] アイコンを選択し、次の図に示すように x64-Clang-Debug と x64-Clang-Release を選択します。変更を保存します。

4. [Json の編集] を選択し、次の例のように別の構成から新しい Clang 構成へ変数セクションをカット アンド ペーストします。XDKEditionTarget の値を、QFE レベルを含む使用中の GDK バージョンに適したものに設定します。

"variables": [
  {
    "name": "XdkEditionTarget",
    "value": "260400",
    "type": "STRING"
  }
]

5. すべての変更を保存後、ビルド構成ドロップダウンから x64-Clang-Debug または x64-Clang-Release を選択してビルドします。

​

CMakeGDKExample の使用

1. Visual Studio の [ローカル フォルダーを開く] オプションを使用して CMakeGDKExample フォルダーを開きます。

​

CMakePresets.json 統合

2. ソリューション エクスプローラーで、CMakePresets.json ファイルをダブルクリックします。

"cacheVariables": {
  "XdkEditionTarget": "260400",
  "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}"
}

3. x64-Scarlett-Clang または x64-XboxOne-Clang プリセットを選択します。

​

CMakeSettings.json 統合

2. ソリューション エクスプローラーで、CMakeSettings.json ファイルをダブルクリックします。
3. 編集する構成を選択します。Toolset 値を clang_cl_x64 に設定します。保存して閉じます。

4. XBOX One および XBOX Series X|S 構成の場合、[Json の編集] を選択し、XdkEditionTarget 変数が GDK エディションおよび QFE レベルと一致していることを確認します。
5. 構成ドロップダウンから目的の値を選択し、[ビルド] メニューから [すべて再ビルド] を選択します。
6. [ファイル] -> [開く] -> [プロジェクト/ソリューション] を使用して、生成されたソリューションおよびプロジェクトを選択します。例:

​

サポートの取得

​

既知の問題

• Clang/LLVM ツールセットは、特に -Wall -Wextra -Wpedantic を使用する場合、Visual C++ よりも大幅に冗長です。少なくとも、コマンド ラインまたは #pragma で以下の警告を抑制してください。

#ifdef __clang__
#pragma clang diagnostic ignored "-Wc++98-compat"
#pragma clang diagnostic ignored "-Wc++98-compat-pedantic"
#pragma clang diagnostic ignored "-Wgnu-anonymous-struct"
#pragma clang diagnostic ignored "-Wlanguage-extension-token"
#pragma clang diagnostic ignored "-Wnested-anon-types"
#pragma clang diagnostic ignored "-Wreserved-id-macro"
#pragma clang diagnostic ignored "-Wunknown-pragmas"
#endif

• XBOX ツールはデバッグ シンボルとして Microsoft PDB のみで動作し、LLVM .ld ファイルが出力する CodeView や DWARF デバッグ情報はサポートしません。
• Clang/LLVM のリンク時コード生成 (Link-Time Code Generation) の実装は、Microsoft Visual C++ のソリューションとは明確に異なります。MSVC と clang/LLVM の間でリンク時コード生成を使用するコードを混在させることはできません。
• 2022 年 10 月リリースおよび Windows SDK (10.0.22621) 以降、C++ スタティック ライブラリには eXtended Flow Control Guard (XFG) メタデータが含まれます。v15 リリース以前の ld リンカーは、これらのライブラリを使用すると常に無害な警告を発します。

lld-link: warning/error: ignoring unknown debug$S subsection kind 0xFF in file xgameruntime.lib

• vcpkg パッケージ マネージャーの MSBuild 統合は、ライブラリのファイル名にワイルドカードを使用するため、lld-link で正しく動作しません。この問題は、vcxproj で <UseLldLink>false</UseLldLink> を設定することで回避できます。この問題は、VS プロジェクト ジェネレーターを使用する vcpkg CMake 統合には影響しません。
• clang v18 の C++20 モードで XBOX 向けにビルドする際、テンプレート評価の変更により、WRL ヘッダーを使用すると 2 つのシンボルが未定義になります。

wrl\implements.h(115,11): error : no member named 'RoOriginateError' in the global namespace
wrl/event.h(681,17): error : no member named 'RoTransformError' in the global namespace
wrl/event.h(712,18): error : no member named 'RoTransformError' in the global namespace

#include <wrl/client.h>

#if (__cplusplus >= 202002L) && (WINAPI_FAMILY == WINAPI_FAMILY_GAMES)
inline BOOL RoOriginateError(HRESULT, HSTRING) { return TRUE; }
inline BOOL RoTransformError(HRESULT, HRESULT, HSTRING) { return TRUE; }
#endif

#include <wrl/event.h>

​

関連項目