> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar o ambiente de build sem instalar o GDK

> Descreve o processo de configuração do ambiente de build sem instalar o Microsoft Game Development Kit (GDK).

# 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.

<Note>
  Para os novos layouts do GDK, os nomes dos parâmetros são: GamingXboxGen8VS2019, GamingXboxGen8VS2022, GamingXboxGen9VS2019, GamingXboxGen9VS2022, GamingWindowsVS2019 ou GamingWindowsVS2022.
</Note>

## 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.

```cmd theme={null}
SET GXDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GXDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GXDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "GamingGXDKBuild=%GameDKLatest%GXDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
```

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.

```cmd theme={null}
SET GRDKEDITION=220300
SET "GameDK=C:\ExtractedGDK\%GRDKEDITION%\Microsoft GDK\"
SET "GameDKLatest=%GameDK%%GRDKEDITION%\"
SET "WindowsSdkDir=C:\ExtractedWin10SDK\Windows Kits\10\"
SET "GamingGRDKBuild=%GameDKLatest%GRDK\"
SET "VSInstallDir=C:\Program Files\Microsoft Visual Studio\2022\Enterprise\"
```

## 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).

```cmd theme={null}
INCLUDE=C:\Program Files (x86)\Windows Kits\10\Include\um;C:\Program Files (x86)\Windows Kits\10\Include\shared;C:\Program Files (x86)\Windows Kits\10\Include\winrt;C:\Program Files (x86)\Windows Kits\10\Include\cppwinrt;C:\Program Files (x86)\Windows Kits\10\Include\ucrt;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\include;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\include;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\INCLUDE;

LIB=C:\Program Files (x86)\Windows Kits\10\Lib\um\x64;C:\Program Files (x86)\Windows Kits\10\Lib\ucrt\x64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64\Scarlett;C:\ExtractedGDK\220300\Microsoft GDK\220300\GXDK\gamekit\lib\amd64;C:\ExtractedGDK\220300\Microsoft GDK\220300\GRDK\gamekit\lib\amd64;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.30.30705\lib\x64;

LIBPATH=C:\Windows\Microsoft.NET\Framework\v4.0.30319;C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\
```

## 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.

```cmd theme={null}
WindowsIncludeRoot=C:\Program Files (x86)\Windows Kits\10\Include\
WindowsLibRoot=C:\Program Files (x86)\Windows Kits\10\Lib\
```

## Confira também

* [Configurando projetos sem instalar o Microsoft Game Development Kit](/pt-BR/build/console-features/build-without-install/project-configuration-withoutinstall)
* [Visão geral do build sem instalar o Microsoft Game Development Kit](/pt-BR/build/console-features/build-without-install/withoutinstall-overview)


## Related topics

- [Prompts de comando](/pt-BR/tools/tools-console/commandlinetools/commandprompt.md)
- [Configure e instale o GDK](/pt-BR/home/setup-install/get-started.md)
- [Instalar o SDK do PlayFab sem as Editor Extensions no Unity](/pt-BR/services/playfab/sdks/unity3d/installing-unity3d-sdk.md)
- [Notas de suporte do Visual Studio 2019](/pt-BR/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [Ambiente e ferramentas de desenvolvimento de jogos para PC](/pt-BR/tools/tools-pc/gc-tools-pc-toc.md)