Uso de Clang/LLVM con el GDK

​

Versiones y componentes necesarios de Visual Studio

​

Modificadores del compilador y del enlazador

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

​

Intrínsecos de CPU compatibles

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

​

Uso de Clang/LLVM con 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]

​

Uso de Clang/LLVM con cmake

​

Uso de CMakeExample

1. Usa la opción Open Local Folder de Visual Studio para abrir la carpeta Desktop en la carpeta raíz de CMakeExample.

​

Integración de CMakePresets.json

2. Haz doble clic en el archivo CMakePresets.json en el Explorador de soluciones.

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

3. Selecciona el valor preestablecido x64-Debug-Clang o x64-Release-Clang.

​

Integración de CMakeSettings.json

2. Haz doble clic en el archivo CMakeSettings.json en el Explorador de soluciones.
3. Selecciona el icono “PLUS” y elige “x64-Clang-Debug” o “x64-Clang-Release”, como se muestra en la siguiente figura. Guarda los cambios.

4. Haz clic en “Edit Json” y, a continuación, corta y pega la sección de variables de otra configuración en las nuevas configuraciones de Clang, como en el siguiente ejemplo. Establece el valor de XDKEditionTarget en el adecuado para tu versión del GDK, incluido el nivel de QFE.

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

5. Después de guardar todos los cambios, selecciona x64-Clang-Debug o x64-Clang-Release en la lista desplegable de configuraciones de compilación y compila.

​

Uso de CMakeGDKExample

1. Usa la opción Open Local Folder de Visual Studio para abrir la carpeta CMakeGDKExample.

​

Integración de CMakePresets.json

2. Haz doble clic en el archivo CMakePresets.json en el Explorador de soluciones.

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

3. Selecciona el valor preestablecido x64-Desktop-Clang.

​

Integración de CMakeSettings.json

2. Haz doble clic en el archivo CMakeSettings.json en el Explorador de soluciones.
3. Selecciona la configuración que quieras editar y establece el valor de Toolset en “clang_cl_x64”. Guarda y cierra.

4. Para las configuraciones de XBOX One y XBOX Series X|S, selecciona Edit Json y asegúrate de que la variable XdkEditionTarget coincide con tu edición del GDK y el nivel de QFE.
5. Selecciona el valor deseado en la lista desplegable de configuraciones y elige Rebuild All en el menú Build.
6. Usa File -> Open -> Project/Solution para seleccionar la solución o el proyecto generado. Por ejemplo:

​

Obtención de soporte técnico

​

Problemas conocidos

• El conjunto de herramientas de Clang/LLVM es bastante más detallado que Visual C++, especialmente al usar -Wall -Wextra -Wpedantic. Como mínimo, suprime las siguientes advertencias, ya sea en la línea de comandos o como 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

• Las herramientas del Microsoft Game Development Kit (GDK) solo funcionan con PDB de Microsoft para los símbolos de depuración y no admiten la información de depuración CodeView o DWARF emitida en los archivos .ld de LLVM.
• La implementación de la generación de código en tiempo de vínculo de Clang/LLVM es claramente diferente de la solución de Microsoft Visual C++. El código que usa la generación de código en tiempo de vínculo no se puede mezclar entre MSVC y clang/LLVM.
• A partir de la versión de octubre de 2022 y el SDK de Windows (10.0.22621), las bibliotecas estáticas de C++ incluyen metadatos de eXtended Flow Control Guard (XFG). El enlazador ld anterior a la versión v15 siempre emitirá una advertencia inofensiva al usar estas bibliotecas:

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

​

Consulte también