Pular para o conteúdo principal

​
Configurando o ambiente de build sem instalar o Microsoft Game Development Kit

Este tópico aborda a configuração do ambiente de build e dos prompts de comando no Microsoft Game Development Kit (GDK) extraído, pois eles exigem etapas adicionais após a extração do Microsoft Game Development Kit (GDK) para funcionar corretamente.

​
Arquivos de comando de variáveis de ambiente

O Microsoft Game Development Kit (GDK) inclui um conjunto de arquivos .cmd usados para definir as variáveis de ambiente. Eles são necessários para criar corretamente prompts de comando com acesso a operações de linha de comando (incluindo o build com MSBuild). Há duas instâncias desses arquivos .cmd. Elas podem ser encontradas nos seguintes locais de exemplo dos arquivos extraídos.
  • C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd
  • C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingDesktopVars.cmd
Inspecionar esses arquivos pode ajudar a entender melhor como as variáveis de ambiente são definidas e detectadas. A maioria das variáveis de ambiente é definida com base em uma verificação IF NOT, para que possam ser substituídas se forem definidas antes da execução. A primeira variável de entrada, %1, é usada para determinar a plataforma e a versão do Visual Studio. Os valores disponíveis para ela são os seguintes:
  • GamingXboxVS2019
  • GamingXboxVS2022
  • GamingXboxScarlettVS2019
  • GamingXboxScarlettVS2022
  • GamingDesktopVS2019
  • GamingDesktopVS2022
Um exemplo desse uso é (na linha de comando) GamingXboxVars.cmd GamingXboxVS2022. Isso configura um prompt de comando com variáveis de ambiente definidas para trabalhar com XBOX e Visual Studio 2022. As seções a seguir detalham quais variáveis de ambiente devem ser substituídas para configurar um prompt de comando que faça referência aos arquivos do kit extraídos.
Para os novos layouts do GDK, os nomes dos parâmetros são: GamingXboxGen8VS2019, GamingXboxGen8VS2022, GamingXboxGen9VS2019, GamingXboxGen9VS2022, GamingWindowsVS2019 ou GamingWindowsVS2022.

​
Configuração de variáveis de ambiente para Gaming.Xbox.XboxOne.x64 e Gaming.Xbox.Scarlett.x64

Antes de chamar o GamingXboxVars.cmd nos prompts de comando do Microsoft Game Development Kit (GDK), as seguintes variáveis de ambiente devem ser definidas para fazer referência aos locais extraídos e substituir as verificações de instalação local.
  • GXDKEDITION: o número da edição do Gaming XBOX Development Kit (GXDK). Por exemplo, 220300 refere-se ao Microsoft Game Development Kit (GDK) de março de 2022.
  • GameDK: o local raiz do Microsoft Game Development Kit (GDK).
  • GameDKLatest: a pasta do número da edição mais recente no local raiz.
  • WindowsSdkDir: o local do SDK do Windows 10.
  • GamingGRDKBuild: o local dos arquivos específicos do Gaming Runtime Development Kit (GRDK).
  • GamingGXDKBuild: o local dos arquivos específicos do Microsoft Game Development Kit (GDK).
  • VSInstallDir: o local da instalação do Visual Studio.
Veja a seguir exemplos de comandos para definir essas variáveis de ambiente de modo que apontem para arquivos extraídos de exemplo.
Use a variável de entrada do GamingXboxVars.cmd, descrita na seção anterior, para alternar entre os ambientes do XBOX One e do XBOX Series X|S.

​
Configuração de variáveis de ambiente para Gaming.Desktop.x64

Antes de chamar o GamingDesktopVars.cmd nos prompts de comando do Microsoft Game Development Kit (GDK), as seguintes variáveis de ambiente devem ser definidas para fazer referência aos locais extraídos e substituir as verificações de instalação local.
  • GRDKEDITION: o número da edição do Gaming Runtime Development Kit (GRDK). Por exemplo, 220300 refere-se ao Microsoft Game Development Kit (GDK) de março de 2022.
  • GameDK: o local raiz do Microsoft Game Development Kit (GDK).
  • GameDKLatest: a pasta do número da edição mais recente no local raiz.
  • WindowsSdkDir: o local do SDK do Windows 10.
  • GamingGRDKBuild: o local dos arquivos específicos do Gaming Runtime Development Kit (GRDK).
  • VSInstallDir: o local da instalação do Visual Studio.
Veja a seguir exemplos de comandos para definir essas variáveis de ambiente de modo que apontem para arquivos extraídos de exemplo.

​
Configuração do prompt de comando

Quando o Microsoft Game Development Kit (GDK) está instalado, os prompts de comando são criados como atalhos para o arquivo .cmd de prompts de comando apropriado do Microsoft Game Development Kit (GDK). Veja um exemplo a seguir. C:\Windows\System32\cmd.exe /k "C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd" GamingXboxVS2022 Criar um atalho com o conteúdo anterior fornecerá a mesma configuração de ambiente que os scripts de prompt de comando instalados. Encapsular um script que defina as variáveis de ambiente acima e, em seguida, execute isso com a variável de entrada apropriada seria uma forma recomendada de configurar isso.

​
Referências de Lib e Include do Microsoft Game Development Kit (GDK)

O script de variáveis de ambiente define os seguintes locais para os caminhos de Lib e Include. Os exemplos a seguir, para Gaming.Xbox.Scarlett.x64, são fornecidos como referência e não devem ser substituídos (a versão das ferramentas MSVC, neste exemplo, é derivada da variável de ambiente VCToolsVersion).

​
Referências de Lib e Include do SDK do Windows 10

O script de variáveis de ambiente define os seguintes locais para os caminhos de Lib e Include do SDK do Windows 10. Os exemplos a seguir são fornecidos como referência e não devem ser substituídos.

​
Confira também

Última modificação em 6 de outubro de 2026