Skip to main content
Esta é a etapa 3 do caminho guiado. Instale o GDK e compile um exemplo em Configurar e instalar o GDK antes de começar aqui. Todo jogo GDK começa como um projeto do Visual Studio. Você seleciona um modelo com base em onde deseja que seu jogo seja executado: somente Windows PC, somente consoles XBOX ou ambos os alvos a partir do mesmo código. Você não precisa decidir isso definitivamente agora, porque pode adicionar outro alvo mais tarde.
Se você não tem certeza de qual alvo escolher, comece com Desktop (Gaming.Desktop.x64) quando tiver um Windows PC e ainda não tiver um dev kit. Você pode testar tudo localmente. Adicione alvos XBOX depois de receber um dev kit.

​
Modelos de projeto

A instalação do GXDK adiciona nove modelos de projeto GDK ao Visual Studio: cinco para PC e quatro para consoles XBOX.

​
Crie um projeto

  1. Abra o Visual Studio.
  2. Vá em File > New > Project.
  3. Em All Languages, selecione C++. Em All Platforms, selecione XBOX ou Windows. Em All Project Types, selecione Games. Você também pode pesquisar pelo nome do modelo.
  4. Selecione um modelo e selecione OK.

​
Selecione um modelo

​
Somente PC

Comece com Direct3D 12 Desktop Game.
  • Usa WINAPI_FAMILY_DESKTOP_APP e faz o link com o conjunto completo de bibliotecas de PC, incluindo kernel32.lib e user32.lib.
  • Inclui cabeçalhos e bibliotecas para D3D12. Fornece uma swap chain simples, um dispositivo D3D e um loop de atualização e renderização.
  • Inclui XGameRuntime.h e faz o link com XGameRuntime.lib. Todas as capacidades do Gaming Runtime do GDK estão prontas.
  • Biblioteca de extensão XSAPI disponível por padrão.
  • Compila para a plataforma x64 padrão ou para a plataforma personalizada Gaming.Desktop.x64.
  • Cria um arquivo MicrosoftGameConfig.mgc com espaços reservados para a sua identidade do Partner Center.

​
Somente XBOX

Comece com Direct3D 12 XBOX Game.
  • Usa WINAPI_FAMILY_GAMES e faz o link com XGamePlatform.lib.
  • Inclui cabeçalhos D3D12 prontos para as extensões D3D12.x do XBOX.
  • Inclui XGameRuntime.h e faz o link com XGameRuntime.lib.
  • Biblioteca de extensão XSAPI disponível por padrão.
  • Usa a plataforma MSBuild Gaming.XBOX.XboxOne.x64 com expectativas de depuração remota.
  • Cria um arquivo MicrosoftGameConfig.mgc com espaços reservados.

​
PC e XBOX (base de código compartilhada)

Comece com um modelo, por exemplo Direct3D 12 Desktop Game, e adicione uma segunda configuração de build com alvo em Gaming.XBOX.XboxOne.x64 (ou vice-versa). Adapte o código-fonte com guardas #define ou #ifdef, ou particione o código específico de plataforma em DLLs separadas:
  • A configuração de PC usa o D3D12 padrão.
  • A configuração de XBOX usa o D3D12.x.
Alternar a configuração ativa muda automaticamente o depurador, as bibliotecas vinculadas e outras configurações de ferramentas.

​
Lance de ponta a ponta em um dev kit

Antes de selecionar um caminho mais profundo, faça o passo a passo prático de console. Ele leva o modelo Direct3D 12 XBOX Game que você criou até uma implantação solta (loose) em execução em um dev kit XBOX. A partir daí, produz um XVC instalável.

Compile e execute seu primeiro título de console com o GDKX

Tutorial de 14 etapas: fixe a edição do GDK, adicione o DirectXTK12, compile para consoles XBOX Series X|S, implante em um dev kit, diagnostique falhas de inicialização e produza um XVC instalável.

​
Próximas etapas

Você tem um projeto compilando. Selecione o caminho selecionado que corresponde ao que você está lançando. O guia aponta para a documentação mais profunda (Build, Serviços, Otimização, Publicação e Referências de API) de que você precisará em seguida.

Portabilidade

Porte um título já lançado de outra plataforma.

XBOX Play Anywhere

Uma única compra, PC e console. Saves compartilhados.

Consoles XBOX Series X|S

Console em primeiro lugar: Quick Resume, DirectStorage e Smart Delivery.

Windows e ROG XBOX Ally

Lance no Windows PC e em portáteis.

Unreal Engine

Plugins do GDK e extensões de plataforma para Unreal.

Unity

Integração do Unity para PC e XBOX.

Godot e engines da comunidade

Notas sobre Godot, GameMaker e engines personalizadas.
A maioria dos títulos combina o GDK com o PlayFab para identidade, multijogador, placares de líderes, economia e live-ops. Você pode integrá-lo a qualquer momento depois que seu projeto compilar.

​
Consulte também

Última modificação em 1 de setembro de 2026

Tópicos relacionados

Compile e execute seu primeiro título de console com o GDKXGuias de portabilidade para o XBOX GDKVisão geral de Godot e engines da comunidadeGuia passo a passo da certificaçãoNotas de versão do SDK C++ do PlayFab Multiplayer