Skip to main content
Este es el paso 3 de la ruta guiada. Instale el GDK y compile un ejemplo desde Configuración e instalación del GDK antes de empezar aquí. Todo juego del GDK comienza como un proyecto de Visual Studio. Seleccione una plantilla según dónde quiera que se ejecute su juego: solo PC con Windows, solo consolas XBOX o ambos destinos desde el mismo código. No es necesario que lo decida definitivamente ahora, porque puede agregar otro destino más adelante.
Si no está seguro de qué destino elegir, comience con Escritorio (Gaming.Desktop.x64) cuando tenga un PC con Windows y todavía no disponga de un kit de desarrollo. Puede probar todo localmente. Agregue los destinos de XBOX después de recibir un kit de desarrollo.

​
Plantillas de proyecto

La instalación del GXDK agrega nueve plantillas de proyecto de GDK a Visual Studio: cinco para PC y cuatro para consolas XBOX.

​
Creación de un proyecto

  1. Abra Visual Studio.
  2. Vaya a File > New > Project.
  3. En All Languages, seleccione C++. En All Platforms, seleccione XBOX o Windows. En All Project Types, seleccione Games. También puede buscar por el nombre de la plantilla.
  4. Seleccione una plantilla y elija OK.

​
Selección de una plantilla

​
Solo PC

Comience con Direct3D 12 Desktop Game.
  • Usa WINAPI_FAMILY_DESKTOP_APP y se vincula con el conjunto completo de bibliotecas de PC, incluidas kernel32.lib y user32.lib.
  • Incluye encabezados y bibliotecas para D3D12. Proporciona una cadena de intercambio sencilla, un dispositivo D3D y un bucle de actualización o representación.
  • Incluye XGameRuntime.h y vincula XGameRuntime.lib. Todas las funcionalidades de Gaming Runtime del GDK están listas.
  • Biblioteca de extensión XSAPI disponible de forma predeterminada.
  • Compila con la plataforma x64 estándar o con la plataforma personalizada Gaming.Desktop.x64.
  • Crea un archivo MicrosoftGameConfig.mgc con marcadores de posición para su identidad de Partner Center.

​
Solo XBOX

Comience con Direct3D 12 XBOX Game.
  • Usa WINAPI_FAMILY_GAMES y se vincula con XGamePlatform.lib.
  • Incluye encabezados de D3D12 listos para las extensiones D3D12.x de XBOX.
  • Incluye XGameRuntime.h y vincula XGameRuntime.lib.
  • Biblioteca de extensión XSAPI disponible de forma predeterminada.
  • Usa la plataforma de MSBuild Gaming.XBOX.XboxOne.x64 con expectativas de depuración remota.
  • Crea un archivo MicrosoftGameConfig.mgc con marcadores de posición.

​
PC y XBOX (base de código compartida)

Comience con una plantilla, por ejemplo Direct3D 12 Desktop Game, y agregue una segunda configuración de compilación que apunte a Gaming.XBOX.XboxOne.x64 (o viceversa). Adapte el código fuente con instrucciones de protección #define o #ifdef, o divida el código específico de la plataforma en archivos DLL independientes:
  • La configuración de PC usa D3D12 estándar.
  • La configuración de XBOX usa D3D12.x.
Al cambiar la configuración activa, cambian automáticamente el depurador, las bibliotecas vinculadas y otros ajustes de herramientas.

​
Publicación de un extremo a otro en un kit de desarrollo

Antes de seleccionar una ruta más avanzada, complete el tutorial práctico de consola. Toma la plantilla Direct3D 12 XBOX Game que creó y la lleva hasta una implementación suelta en ejecución en un kit de desarrollo de XBOX. A partir de ahí, produce un XVC instalable.

Compile y ejecute su primer título de consola con GDKX

Tutorial de 14 pasos: fije la edición del GDK, agregue DirectXTK12, compile para consolas XBOX Series X|S, implemente en un kit de desarrollo, diagnostique errores de inicio y produzca un XVC instalable.

​
Pasos siguientes

Ya tiene un proyecto que compila. Seleccione la ruta seleccionada que coincida con lo que va a publicar. La guía le remite a la documentación más detallada (Compilación, Servicios, Optimización, Publicación y Referencias de API) que necesitará a continuación.

Portabilidad

Migre un título publicado desde otra plataforma.

XBOX Play Anywhere

Una compra, PC y consola. Guardados compartidos.

Consolas XBOX Series X|S

Consola primero: Quick Resume, DirectStorage y Smart Delivery.

Windows y ROG XBOX Ally

Publique en PC con Windows y dispositivos portátiles.

Unreal Engine

Complementos del GDK y extensiones de plataforma para Unreal.

Unity

Integración de Unity para PC y XBOX.

Godot y motores de la comunidad

Notas sobre Godot, GameMaker y motores personalizados.
La mayoría de los títulos emparejan el GDK con PlayFab para identidad, multijugador, tablas de clasificación, economía y operaciones en directo. Puede integrarlo en cualquier momento después de que su proyecto compile.

​
Consulte también

Última modificación el 28 de agosto de 2026

Temas relacionados

Compilación y ejecución de su primer título de consola con GDKXGuías de portabilidad al GDK de XBOXModo de desarrolloInicio de un nuevo título para PC con las plantillas de proyecto del GDKLanzamientos de títulos