Skip to main content
Configure su PC de desarrollo, instale la cadena de herramientas y descargue el GDK. Complete los pasos en orden. Los pasos posteriores dependen de los anteriores.

Paso 1: Confirmar los requisitos del PC de desarrollo

Sistema operativo

Los componentes de Visual Studio (VSIX) del GDK no admiten dispositivos ARM. Instale el GDK en un PC de desarrollo x64.

Hardware

  • Un PC x64 rápido y moderno con 30 GB libres para la instalación del GDK.
  • Para el desarrollo dirigido a XBOX, use un SSD NVMe (con disipador de calor), una NIC de 10 GbE en el PC de desarrollo, un conmutador de 10 GbE con cables Cat 6a (PC de desarrollo y kit de desarrollo en la misma subred) y una placa base compatible con Thunderbolt 3.
  • Pantallas 4K o UHD compatibles con HDR para validar las características de pantalla.
  • Conmutador de 8 puertos Netgear XS708T
  • Adaptador PCIe 10GBase-T AQuantia Aqtion AQN-107
  • Intel Ethernet Converged Network Adapter X540-T1
  • SSD Samsung 970 EVO NVMe M.2 de 1 TB
  • Cables Ethernet de categoría 6a

Paso 2: Instalar el Windows SDK

Los títulos del GDK se basan en Win32, por lo que el Windows SDK es fundamental para la experiencia del desarrollador. Proporciona Direct3D, XAudio, las API de PIX para Windows, los servicios básicos del sistema operativo, la partición WINAPI_FAMILY_GAMES, xgameplatform.lib, la API unificada GameInput y la administración del ciclo de vida de procesos (PLM). Versión mínima requerida: Windows SDK 22000 o posterior (Windows 11 SDK). Instálelo de forma independiente o como componente opcional del Instalador de Visual Studio.

Paso 3: Instalar Visual Studio

Use Visual Studio 2022 o Visual Studio 2026 con la carga de trabajo de C++.
Si instala una nueva edición de Visual Studio después del GDK, repare el GDK para que se integre con la nueva edición. Si necesita desinstalar Visual Studio, desinstale primero el GDK.
Cree un punto de restauración del sistema antes de instalar el GDK.

Paso 4: Descargar e instalar el GDK

  1. Descargue el GDK y, opcionalmente, Game Core para XBOX, desde la página de descarga del GDK de XBOX. Esto requiere acceso a ID@XBOX.
  2. Ejecute el instalador como Administrador.
  3. Acepte los términos de licencia.
  4. Seleccione el GDK y, opcionalmente, los componentes de Game Core para XBOX.
  5. Espere a que finalice el instalador y, a continuación, reinicie si se le solicita.
Después de la instalación, abra Visual Studio y confirme que las plataformas Gaming.Desktop.x64 y Gaming.XBOX.Scarlett.x64 aparecen en el Administrador de configuración.

Qué se incluye en el GDK

  • Gaming Runtime: empaquetado MSIXVC, TCUI, Connected Storage, bloques asincrónicos, asociación de dispositivos, usuario, TTS, accesibilidad y Screen Time.
  • Gaming Cloud Services: XSAPI, XAL, redes multijugador, PlayFab y Store con compras desde la aplicación.
  • Extensiones de dispositivo de juego: DirectX 12.x, Audio.x, PIX.x, XMemAlloc y otras API de memoria específicas de la consola.

Herramientas para PC y XBOX

Juegos de PC: itere, pruebe y depure localmente con las herramientas estándar de Visual Studio y PIX para Windows. Opcionalmente, configure VS Remote Tools para reproducir problemas en un PC de laboratorio. Juegos de XBOX: itere de forma remota en consolas XBOX Series X|S o kits de desarrollo de la familia de consolas XBOX One con PIX para XBOX, las herramientas de línea de comandos xb*, XBOX Manager, Dev Home y el XBOX Device Portal (XDP).

Servidores de símbolos de Microsoft

Habilite los servidores de símbolos de Microsoft para obtener los símbolos de Gaming Runtime. En Visual Studio, vaya a Debug > Options > Symbols y seleccione Microsoft Symbol Servers. Consulte la documentación del servidor de símbolos públicos de Microsoft.

Compilación sin instalación (BWOI)

BWOI permite que sus servidores de compilación consuman el GDK sin ejecutar el instalador. Esto es fundamental para CI y entornos de compilación restringidos. Extraiga la carga de instalación del GDK en un directorio conocido, apunte las variables de entorno de compilación a él y compile con msbuild o su cadena de herramientas.
  • BWOI no instala la integración VSIX de Visual Studio.
  • Algunas herramientas necesitan un paso de extracción único, como las cargas de XBTC y makepkg.
  • Los kits de desarrollo por desarrollador y PIX se siguen instalando normalmente en las estaciones de trabajo.
Use BWOI para ejecutar compilaciones del GDK en CI en contenedores.

Desarrollo remoto de juegos de Windows

Use las herramientas remotas de desarrollo de juegos para implementar y depurar en un PC con Windows remoto a través de la red de desarrollo. Esto ayuda con las canalizaciones de desarrollo de varios PC; por ejemplo, un artista en Windows 10, una compilación en Server 2019 y un destino en un PC de pruebas independiente. Hyper-V o VMware funcionan para imágenes de prueba efímeras.

Pasos siguientes

Confirme que la instalación funciona abriendo en Visual Studio uno de los ejemplos incluidos.

Ejemplos del GDK

Ejemplos de referencia que se incluyen con el GDK.
Última modificación el 28 de agosto de 2026