Usar Clang/LLVM com o GDK

​

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

​

Usar o CMakeExample

1. Use a opção Abrir uma pasta local do Visual Studio para abrir a pasta Desktop na pasta raiz do CMakeExample.

​

Integração com CMakePresets.json

2. Clique duas vezes no arquivo CMakePresets.json no Gerenciador de Soluções.

"cacheVariables": {
  "XdkEditionTarget": "250400",
  "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. Clique duas vezes no arquivo CMakeSettings.json no Gerenciador de Soluções.
3. Selecione o ícone “MAIS” e escolha “x64-Clang-Debug” e/ou “x64-Clang-Release”, conforme mostrado na figura a seguir. Salve as alterações.

4. Clique em “Editar JSON” e 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": "210400",
    "type": "STRING"
  }
]

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

​

Usar o CMakeGDKExample

1. Use a opção Abrir uma pasta local do Visual Studio para abrir a pasta CMakeGDKExample.

​

Integração com CMakePresets.json

2. Clique duas vezes no arquivo CMakePresets.json no Gerenciador de Soluções.

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

3. Selecione a predefinição x64-Desktop-Clang.

​

Integração com CMakeSettings.json

2. Clique duas vezes no arquivo CMakeSettings.json no Gerenciador de Soluções.
3. Selecione a configuração que você deseja editar e defina o valor de Toolset como “clang_cl_x64”. Salve e feche.

4. Para as configurações do XBOX One e do XBOX Series X|S, selecione Editar 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ções e escolha Recompilar Tudo no menu Compilar.
6. Use Arquivo -> Abrir -> Projeto/Solução para selecionar a solução/projeto gerado. Por exemplo:

​

Obter suporte

​

Problemas conhecidos

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

• As ferramentas do Microsoft Game Development Kit (GDK) 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 em arquivos .ld do LLVM.
• A implementação da Geração de Código Durante o Tempo de Vinculação do Clang/LLVM é distintamente diferente da solução do Microsoft Visual C++. Códigos que usam a Geração de Código Durante o Tempo de Vinculação não podem ser misturados 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 emitirá um aviso inofensivo ao usar essas bibliotecas:

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

​

Veja também