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 フォルダーを開きます。

​

CMakePresets.json の統合

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

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

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

​

CMakeSettings.json の統合

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

4. [Edit Json] をクリックし、次の例のように別の構成の variables セクションを新しい Clang 構成に切り取って貼り付けます。QFE レベルを含め、お使いの GDK のバージョンに適した値を XDKEditionTarget に設定します。

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

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

​

CMakeGDKExample を使用する

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

​

CMakePresets.json の統合

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

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

3. x64-Desktop-Clang プリセットを選択します。

​

CMakeSettings.json の統合

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

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

​

サポートの取得

​

既知の問題

• Clang/LLVM ツールセットは Visual C++ に比べて、特に -Wall -Wextra -Wpedantic を使用するとかなり冗長になります。少なくとも、次の警告をコマンド ラインまたは #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

• Microsoft Game Development Kit (GDK) のツールは、デバッグ シンボルとして 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

​

関連項目