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

# Instale a cadeia de ferramentas do GDK

> Requisitos, pré-requisitos e instruções de instalação passo a passo do Windows SDK, do Visual Studio e do XBOX Game Development Kit no seu PC de desenvolvimento.

Configure seu PC de desenvolvimento, instale a cadeia de ferramentas e baixe o GDK. Conclua as etapas em ordem. As etapas posteriores dependem das anteriores.

## Etapa 1: Confirme os requisitos do PC de desenvolvimento

### Sistema operacional

<Warning>
  Os componentes do GDK para Visual Studio (VSIX) não têm suporte para dispositivos ARM. Instale o GDK em um PC de desenvolvimento x64.
</Warning>

| Finalidade                                            | Suportado                                                                         |
| ----------------------------------------------------- | --------------------------------------------------------------------------------- |
| Desenvolvimento de títulos XBOX (clientes)            | Windows 10 ou Windows 11 (64 bits): Home, Pro ou Enterprise.                      |
| Desenvolvimento de títulos XBOX (servidores de build) | Windows Server 2019 (1809 ou posterior): Standard ou Datacenter.                  |
| Desenvolvimento de títulos Windows (Gaming Runtime)   | Windows 10 May 2019 Update ou posterior (64 bits), ou Windows 11 (64 bits).       |
| Teste de jogos de PC empacotados como MSIXVC          | Windows 10 May 2019 Update ou posterior (64 bits), com o Gaming Services Runtime. |

### Hardware

* Um PC x64 rápido e moderno com 30 GB livres para a instalação do GDK.
* Para desenvolvimento voltado a XBOX, use um SSD NVMe (com dissipador de calor), uma NIC de 10 GbE no PC de desenvolvimento, um switch de 10 GbE com cabos Cat 6a (PC de desenvolvimento e dev kit na mesma sub-rede) e uma placa-mãe compatível com Thunderbolt 3.
* Telas 4K ou UHD compatíveis com HDR para validar recursos de exibição.

<Accordion title="Referência de hardware 10 GbE validado">
  - Switch Netgear XS708T de 8 portas
  - Adaptador PCIe 10GBase-T AQuantia Aqtion AQN-107
  - Intel Ethernet Converged Network Adapter X540-T1
  - Samsung SSD 970 EVO NVMe M.2 1 TB
  - Cabos Ethernet categoria 6a
</Accordion>

## Etapa 2: Instale o Windows SDK

Os títulos do GDK são baseados em Win32, então o [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) é essencial para a experiência do desenvolvedor. Ele fornece Direct3D, XAudio, as APIs do PIX for Windows, serviços centrais do SO, a partição `WINAPI_FAMILY_GAMES`, a `xgameplatform.lib`, a API unificada [GameInput](/build/core-features/common/input/overviews/input-overview) e o Process Lifecycle Management (PLM).

Versão mínima exigida: Windows SDK 22000 ou posterior (Windows 11 SDK). Instale-o de forma independente ou como um componente opcional do Visual Studio Installer.

## Etapa 3: Instale o Visual Studio

Use o Visual Studio 2022 ou o Visual Studio 2026 com a carga de trabalho de C++.

<Note>
  Se você instalar uma nova edição do Visual Studio depois do GDK, repare o GDK para que ele se integre à nova edição. Se precisar desinstalar o Visual Studio, desinstale o GDK primeiro.
</Note>

<Tip>
  Crie um ponto de restauração do sistema antes de instalar o GDK.
</Tip>

## Etapa 4: Baixe e instale o GDK

1. Baixe o GDK, e opcionalmente o Game Core for XBOX, na [página de download do XBOX GDK](https://aka.ms/gdkdl). Isso requer acesso ao ID\@XBOX.
2. Execute o instalador como **Administrador**.
3. Aceite os termos de licença.
4. Selecione o GDK e, opcionalmente, os componentes do Game Core for XBOX.
5. Aguarde a conclusão do instalador e reinicie o computador se solicitado.

Após a instalação, abra o Visual Studio e confirme que as plataformas **Gaming.Desktop.x64** e **Gaming.XBOX.Scarlett.x64** aparecem no Configuration Manager.

### O que acompanha o GDK

* **Gaming Runtime:** empacotamento MSIXVC, TCUI, Connected Storage, blocos assíncronos, associação de dispositivos, usuário, TTS, acessibilidade e Screen Time.
* **Gaming Cloud Services:** XSAPI, XAL, rede multijogador, PlayFab e Store com compras no aplicativo.
* **Extensões de dispositivo de jogos:** DirectX 12.x, Audio.x, PIX.x, `XMemAlloc` e outras APIs de memória específicas de console.

## Ferramentas para PC e XBOX

**Jogos de PC:** itere, teste e depure localmente com as ferramentas padrão do Visual Studio e o PIX for Windows. Opcionalmente, configure o VS Remote Tools para reproduzir problemas em um PC de laboratório.

**Jogos de XBOX:** itere remotamente em consoles XBOX Series X|S ou em dev kits de consoles da família XBOX One usando o PIX for XBOX, as ferramentas de linha de comando `xb*`, o XBOX Manager, o Dev Home e o XBOX Device Portal (XDP).

## Microsoft Symbol Servers

Habilite os Microsoft Symbol Servers para obter os símbolos do Gaming Runtime. No Visual Studio, acesse **Debug** > **Options** > **Symbols** e selecione **Microsoft Symbol Servers**. Consulte a documentação do [servidor público de símbolos da Microsoft](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols).

## Build Without Install (BWOI)

O BWOI permite que seus servidores de build usem o GDK sem executar o instalador. Isso é essencial para CI e ambientes de build restritos. Extraia a carga de instalação do GDK em um diretório conhecido, aponte as variáveis de ambiente de build para ele e compile com `msbuild` ou sua cadeia de ferramentas.

* O BWOI não instala a integração VSIX com o Visual Studio.
* Algumas ferramentas exigem uma etapa única de extração, como as cargas do XBTC e do makepkg.
* Os dev kits individuais e o PIX continuam sendo instalados normalmente nas estações de trabalho.

Use o BWOI para executar builds do GDK em CI conteinerizada.

## Desenvolvimento remoto de jogos para Windows

Use as ferramentas remotas de desenvolvimento de jogos para implantar e depurar em um Windows PC remoto pela rede de desenvolvimento. Isso ajuda em pipelines de desenvolvimento com vários PCs — por exemplo, um artista no Windows 10, uma build no Server 2019 e um destino em um PC de teste separado. Hyper-V ou VMware funcionam para imagens de teste efêmeras.

## Próximas etapas

Confirme que sua instalação funciona abrindo um exemplo incluído no Visual Studio.

<Card title="Exemplos do GDK" icon="arrow-right" href="/home/setup-install/samples">
  Exemplos de referência que acompanham o GDK.
</Card>


## Related topics

- [Configure e instale o GDK](/pt-BR/home/setup-install/get-started.md)
- [Exemplos do GDK](/pt-BR/home/setup-install/samples.md)
- [Requisitos de segurança para licenciados do GDK](/pt-BR/home/onboarding-access/security-requirements.md)
- [Integração de Parceiro XBOX para acesso e publicação](/pt-BR/home/onboarding.md)
- [Compile e execute seu primeiro título de console com o GDKX](/pt-BR/home/build-first-title/first-console-title-walkthrough.md)