Utiliser Clang/LLVM avec le GDK

​

Versions et composants de Visual Studio requis

​

Commutateurs du compilateur et de l’éditeur de liens

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

​

Intrinsèques CPU prises en charge

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

​

Utilisation de Clang/LLVM avec msbuild

<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]

​

Utilisation de Clang/LLVM avec cmake

​

Utilisation de CMakeExample

1. Utilisez l’option Ouvrir un dossier local de Visual Studio pour ouvrir le dossier Desktop situé dans le dossier racine de CMakeExample.

​

Intégration de CMakePresets.json

2. Double-cliquez sur le fichier CMakePresets.json dans l’Explorateur de solutions.

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

3. Sélectionnez le préréglage x64-Debug-Clang ou x64-Release-Clang.

​

Intégration de CMakeSettings.json

2. Double-cliquez sur le fichier CMakeSettings.json dans l’Explorateur de solutions.
3. Sélectionnez l’icône “PLUS” et choisissez “x64-Clang-Debug” et/ou “x64-Clang-Release”, comme illustré dans la figure suivante. Enregistrez les modifications.

4. Cliquez sur “Edit Json”, puis coupez-collez la section des variables d’une autre configuration vers les nouvelles configurations Clang, comme dans l’exemple suivant. Définissez la valeur de XDKEditionTarget sur celle qui correspond à votre version du GDK, y compris le niveau de QFE.

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

5. Après avoir enregistré toutes les modifications, sélectionnez x64-Clang-Debug ou x64-Clang-Release dans la liste déroulante de configuration de build, puis lancez la génération.

​

Utilisation de CMakeGDKExample

1. Utilisez l’option Ouvrir un dossier local de Visual Studio pour ouvrir le dossier CMakeGDKExample.

​

Intégration de CMakePresets.json

2. Double-cliquez sur le fichier CMakePresets.json dans l’Explorateur de solutions.

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

3. Sélectionnez le préréglage x64-Desktop-Clang.

​

Intégration de CMakeSettings.json

2. Double-cliquez sur le fichier CMakeSettings.json dans l’Explorateur de solutions.
3. Sélectionnez la configuration que vous voulez modifier et définissez la valeur de Toolset sur “clang_cl_x64”. Enregistrez et fermez.

4. Pour les configurations XBOX One et XBOX Series X|S, sélectionnez Edit Json et assurez-vous que la variable XdkEditionTarget correspond à votre édition du GDK et à votre niveau de QFE.
5. Sélectionnez la valeur souhaitée dans la liste déroulante de configuration et choisissez Régénérer tout dans le menu Générer.
6. Utilisez Fichier -> Ouvrir -> Projet/Solution pour sélectionner la solution ou le projet généré. Par exemple :

​

Obtenir de l’aide

​

Problèmes connus

• L’ensemble d’outils Clang/LLVM est beaucoup plus verbeux que Visual C++, en particulier avec -Wall -Wextra -Wpedantic. Au minimum, supprimez les avertissements suivants, soit sur la ligne de commande, soit à l’aide d’un #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

• Les outils du Microsoft Game Development Kit (GDK) fonctionnent uniquement avec les PDB Microsoft pour les symboles de débogage, et ne prennent pas en charge les informations de débogage CodeView ou DWARF émises dans les fichiers .ld de LLVM.
• L’implémentation de la génération de code au moment de l’édition de liens de Clang/LLVM est nettement différente de la solution Microsoft Visual C++. Le code qui utilise la génération de code au moment de l’édition de liens ne peut pas être mélangé entre MSVC et clang/LLVM.
• Depuis la version d’octobre 2022 et le Windows SDK (10.0.22621), les bibliothèques statiques C++ incluent des métadonnées eXtended Flow Control Guard (XFG). L’éditeur de liens ld antérieur à la version v15 émet toujours un avertissement sans conséquence lors de l’utilisation de ces bibliothèques :

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

​

Voir aussi