Usar o Clang/LLVM com o GDK para consoles

​

Versões e componentes necessários do Visual Studio

​

Opções do compilador e do vinculador

  -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 compatíveis

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

​

Usar o Clang/LLVM com o 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]

​

Usar o Clang/LLVM com o cmake

​

Usar o CMakeExample

1. Use a opção Open Local Folder do Visual Studio para abrir a pasta Desktop, XBOX Series X|S ou XboxOne na pasta raiz do CMakeExample.

​

Integração com CMakePresets.json

2. No Solution Explorer, clique duas vezes no arquivo CMakePresets.json.

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

3. Selecione a predefinição x64-Debug-Clang ou x64-Release-Clang.

​

Integração com CMakeSettings.json

2. No Solution Explorer, clique duas vezes no arquivo CMakeSettings.json.
3. Selecione o ícone PLUS e escolha x64-Clang-Debug e x64-Clang-Release, conforme mostrado na figura a seguir. Salve as alterações.

4. Selecione Edit Json e, em seguida, recorte e cole a seção de variáveis de outra configuração nas novas configurações do Clang, como no exemplo a seguir. Defina o valor de XDKEditionTarget como o apropriado para a sua versão do GDK, incluindo o nível de QFE.

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

5. Depois de salvar todas as alterações, selecione x64-Clang-Debug ou x64-Clang-Release na lista suspensa de configuração de build e faça o build.

​

Usar o CMakeGDKExample

1. Use a opção Open Local Folder do Visual Studio para abrir a pasta CMakeGDKExample.

​

Integração com CMakePresets.json

2. No Solution Explorer, clique duas vezes no arquivo CMakePresets.json.

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

3. Selecione a predefinição x64-Scarlett-Clang ou x64-XboxOne-Clang.

​

Integração com CMakeSettings.json

2. No Solution Explorer, clique duas vezes no arquivo CMakeSettings.json.
3. Selecione a configuração que deseja editar. Defina o valor de Toolset como clang_cl_x64. Salve e feche.

4. Para as configurações de XBOX One e XBOX Series X|S, selecione Edit Json e verifique se a variável XdkEditionTarget corresponde à sua edição do GDK e ao nível de QFE.
5. Selecione o valor desejado na lista suspensa de configuração e escolha Rebuild All no menu Build.
6. Use File -> Open -> Project/Solution para selecionar a solução e o projeto gerados. Por exemplo:

​

Obter suporte

​

Problemas conhecidos

• O conjunto de ferramentas Clang/LLVM é significativamente mais detalhado que o Visual C++, especialmente quando você usa -Wall -Wextra -Wpedantic. No mínimo, suprima os seguintes avisos na linha de comando ou como um #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

• As ferramentas do XBOX funcionam apenas com PDBs da Microsoft para símbolos de depuração e não oferecem suporte às informações de depuração CodeView ou DWARF emitidas pelos arquivos .ld do LLVM.
• A implementação da Geração de Código em Tempo de Vinculação do Clang/LLVM é nitidamente diferente da solução do Microsoft Visual C++. Não é possível misturar código que usa a Geração de Código em Tempo de Vinculação entre o MSVC e o clang/LLVM.
• A partir da versão de outubro de 2022 e do Windows SDK (10.0.22621), as bibliotecas estáticas C++ incluem metadados do eXtended Flow Control Guard (XFG). O vinculador ld anterior à versão v15 sempre emite um aviso inofensivo quando você usa essas bibliotecas:

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

• A integração do gerenciador de pacotes vcpkg com o MSBuild não funciona corretamente com o lld-link, pois usa curingas nos nomes de arquivos de biblioteca. Você pode contornar esse problema definindo <UseLldLink>false</UseLldLink> no vcxproj. Esse problema não afeta a integração do vcpkg com o CMake usando geradores de projeto do VS.
• Ao fazer o build para XBOX com o clang v18 no modo C++20, dois símbolos ficam indefinidos ao usar os cabeçalhos WRL devido a alterações na avaliação de templates.

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>

​

Veja também