Etapa 1: Confirme os requisitos do PC de desenvolvimento
Sistema operacional
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.
Referência de hardware 10 GbE validado
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 é essencial para a experiência do desenvolvedor. Ele fornece Direct3D, XAudio, as APIs do PIX for Windows, serviços centrais do SO, a partiçãoWINAPI_FAMILY_GAMES, a xgameplatform.lib, a API unificada GameInput 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++.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.
Etapa 4: Baixe e instale o GDK
- Baixe o GDK, e opcionalmente o Game Core for XBOX, na página de download do XBOX GDK. Isso requer acesso ao ID@XBOX.
- Execute o instalador como Administrador.
- Aceite os termos de licença.
- Selecione o GDK e, opcionalmente, os componentes do Game Core for XBOX.
- Aguarde a conclusão do instalador e reinicie o computador se solicitado.
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,
XMemAlloce 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 comandoxb*, 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.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 commsbuild 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.
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.Exemplos do GDK
Exemplos de referência que acompanham o GDK.