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

# Instalación de la cadena de herramientas del GDK

> Requisitos, requisitos previos e instrucciones de instalación paso a paso del Windows SDK, Visual Studio y el Kit de desarrollo de juegos de XBOX en su PC de desarrollo.

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

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

| Propósito                                                 | Compatible                                                                     |
| --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Desarrollo de títulos de XBOX (clientes)                  | Windows 10 o Windows 11 (64 bits): Home, Pro o Enterprise.                     |
| Desarrollo de títulos de XBOX (servidores de compilación) | Windows Server 2019 (1809 o posterior): Standard o Datacenter.                 |
| Desarrollo de títulos de Windows (Gaming Runtime)         | Windows 10 May 2019 Update o posterior (64 bits), o Windows 11 (64 bits).      |
| Pruebas de juegos de PC empaquetados como MSIXVC          | Windows 10 May 2019 Update o posterior (64 bits), con Gaming Services Runtime. |

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

<Accordion title="Referencia de hardware de 10 GbE validado">
  - 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
</Accordion>

## Paso 2: Instalar el Windows SDK

Los títulos del GDK se basan en Win32, por lo que el [Windows SDK](https://developer.microsoft.com/windows/downloads/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](/build/core-features/common/input/overviews/input-overview) 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++.

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

<Tip>
  Cree un punto de restauración del sistema antes de instalar el GDK.
</Tip>

## 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](https://aka.ms/gdkdl). 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](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols).

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

<Card title="Ejemplos del GDK" icon="arrow-right" href="/home/setup-install/samples">
  Ejemplos de referencia que se incluyen con el GDK.
</Card>


## Related topics

- [Ejemplos del GDK](/es/home/setup-install/samples.md)
- [Compilación y ejecución de su primer título de consola con GDKX](/es/home/build-first-title/first-console-title-walkthrough.md)
- [Herramientas del GDK de XBOX One y XBOX Series X|S](/es/tools/tools-console/tools-sdk.md)
- [Esquema del paquete de implementación y herramientas de instalación mediante streaming](/es/build/core-features/common/packaging/deployment/index.md)
- [Configuración e instalación del GDK](/es/home/setup-install/get-started.md)