Uso de Clang/LLVM con el GDK para consolas

​

Versiones y componentes de Visual Studio necesarios

​

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

​

Funciones intrínsecas 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. Use la opción Open Local Folder de Visual Studio para abrir la carpeta Desktop, XBOX Series X|S o XboxOne en la carpeta raíz de CMakeExample.

​

Integración con CMakePresets.json

2. En el Explorador de soluciones, haga doble clic en el archivo CMakePresets.json.

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

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

​

Integración con CMakeSettings.json

2. En el Explorador de soluciones, haga doble clic en el archivo CMakeSettings.json.
3. Seleccione el icono PLUS y elija x64-Clang-Debug y x64-Clang-Release, como se muestra en la siguiente figura. Guarde los cambios.

4. Seleccione Edit Json y, después, corte y pegue la sección variables de otra configuración en las nuevas configuraciones de Clang, como en el siguiente ejemplo. Establezca el valor de XDKEditionTarget en el adecuado para su versión del GDK, incluido el nivel de QFE.

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

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

​

Uso de CMakeGDKExample

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

​

Integración con CMakePresets.json

2. En el Explorador de soluciones, haga doble clic en el archivo CMakePresets.json.

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

3. Seleccione el valor preestablecido x64-Scarlett-Clang o x64-XboxOne-Clang.

​

Integración con CMakeSettings.json

2. En el Explorador de soluciones, haga doble clic en el archivo CMakeSettings.json.
3. Seleccione la configuración que desea editar. Establezca el valor de Toolset en clang_cl_x64. Guarde y cierre.

4. Para las configuraciones de XBOX One y XBOX Series X|S, seleccione Edit Json y asegúrese de que la variable XdkEditionTarget coincida con su edición del GDK y nivel de QFE.
5. Seleccione el valor deseado en la lista desplegable de configuraciones y elija Rebuild All en el menú Build.
6. Use File -> Open -> Project/Solution para seleccionar la solución y el proyecto generados. Por ejemplo:

​

Obtención de soporte técnico

​

Problemas conocidos

• El conjunto de herramientas Clang/LLVM es considerablemente más detallado que Visual C++, especialmente cuando usa -Wall -Wextra -Wpedantic. Como mínimo, suprima las siguientes advertencias en la línea de comandos o como #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 de XBOX solo funcionan con archivos PDB de Microsoft para los símbolos de depuración, y no admiten la información de depuración CodeView ni DWARF que emiten 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++. No puede mezclar código que use la generación de código en tiempo de vínculo entre MSVC y clang/LLVM.
• A partir de la versión de octubre de 2022 y el Windows SDK (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 emite una advertencia inofensiva cuando usa estas bibliotecas:

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

• La integración de MSBuild del administrador de paquetes vcpkg no funciona correctamente con lld-link, ya que usa caracteres comodín en los nombres de archivo de las bibliotecas. Puede evitar este problema estableciendo <UseLldLink>false</UseLldLink> en el vcxproj. Este problema no afecta a la integración de vcpkg con CMake mediante generadores de proyectos de VS.
• Al compilar para XBOX con clang v18 en modo C++20, dos símbolos quedan sin definir al usar los encabezados de WRL debido a cambios en la evaluación de plantillas.

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>

​

Consulte también