Utiliser Clang/LLVM avec le GDK pour les consoles

​

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, XBOX Series X|S ou XboxOne situé dans le dossier racine de CMakeExample.

​

Intégration de CMakePresets.json

2. Dans l’Explorateur de solutions, double-cliquez sur le fichier CMakePresets.json.

"cacheVariables": {
  "XdkEditionTarget": "260400",
  "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. Dans l’Explorateur de solutions, double-cliquez sur le fichier CMakeSettings.json.
3. Sélectionnez l’icône PLUS et choisissez x64-Clang-Debug et x64-Clang-Release, comme illustré dans la figure suivante. Enregistrez les modifications.

4. Sélectionnez 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": "260400",
    "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. Dans l’Explorateur de solutions, double-cliquez sur le fichier CMakePresets.json.

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

3. Sélectionnez le préréglage x64-Scarlett-Clang ou x64-XboxOne-Clang.

​

Intégration de CMakeSettings.json

2. Dans l’Explorateur de solutions, double-cliquez sur le fichier CMakeSettings.json.
3. Sélectionnez la configuration que vous voulez modifier. 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 et le projet générés. Par exemple :

​

Obtenir de l’aide

​

Problèmes connus

• L’ensemble d’outils Clang/LLVM est beaucoup plus verbeux que Visual C++, en particulier lorsque vous utilisez -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 XBOX 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++. Vous ne pouvez pas mélanger entre MSVC et clang/LLVM du code qui utilise la génération de code au moment de l’édition de liens.
• 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 lorsque vous utilisez ces bibliothèques :

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

• L’intégration MSBuild du gestionnaire de packages vcpkg ne fonctionne pas correctement avec lld-link, car elle utilise des caractères génériques dans les noms de fichiers de bibliothèques. Vous pouvez contourner ce problème en définissant <UseLldLink>false</UseLldLink> dans le fichier vcxproj. Ce problème n’affecte pas l’intégration CMake de vcpkg avec les générateurs de projets VS.
• Lors d’une génération pour XBOX avec clang v18 en mode C++20, deux symboles ne sont pas définis lors de l’utilisation des en-têtes WRL, en raison de modifications de l’évaluation des modèles.

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>

​

Voir aussi