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

# Configurar seu ambiente de desenvolvimento (conteúdo)

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

| 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] 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

## 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](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md) 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.

> [!TIP]
>
> Crie um ponto de restauração do sistema antes de instalar o GDK.

## 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] [Exemplos do GDK](https://docs.xbox.com/pt-BR/home/setup-install/samples.md)
>
> Exemplos de referência que acompanham o GDK.


## Related topics

- [Autenticação de login anônimo no servidor](https://docs.xbox.com/pt-BR/services/playfab/identity/player-identity/platform-specific-authentication/anonymous-login.md)
- [Criar e implantar builds Linux](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/deploying-linux-based-builds.md)
- [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Android (Preterido)](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md)
- [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Windows (Preterido)](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application.md)
- [Configurando áreas restritas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
