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

# Notas de compatibilidad del GDK con Visual Studio 2022

> Notas de compatibilidad del Microsoft Game Development Kit (GDK) con Visual Studio 2022

Este artículo describe la compatibilidad del GDK con Visual Studio 2022. Visual Studio 2022 [versión 17.12 o 17.14](https://learn.microsoft.com/visualstudio/releases/2022/servicing-vs2022) admite el desarrollo con el Microsoft Game Development Kit (GDK). Se proporcionan canales de soporte a largo plazo para las versiones 17.12 y 17.14 según el [ciclo de vida y mantenimiento de productos de Visual Studio](https://learn.microsoft.com/visualstudio/productinfo/vs-servicing).

<Note>Las versiones 17.0 a 17.11 de Visual Studio 2022 están fuera de soporte desde enero de 2026.</Note>

## Instalación de Visual Studio 2022

El GDK admite el desarrollo con la edición **Professional** o la edición **Enterprise** de Visual Studio 2022. La edición Community no se admite.

<Info>Los componentes de extensión de Visual Studio (VSIX) del GDK no se admiten en dispositivos basados en ARM. Para usar las plantillas de proyecto, las páginas de propiedades y las extensiones de depuración de Visual Studio del GDK, instale el GDK en un PC de desarrollo basado en x64.</Info>

Al instalar Visual Studio 2022, seleccione la carga de trabajo **Game development with C++** durante la instalación, como se muestra en la siguiente captura de pantalla.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_workloads_game_development.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=323e575e103c803e945a7b6eee4e0d3d" alt="Instalación de la carga de trabajo Game Development with C++ con Visual Studio 2022" width="1157" height="514" data-path="images/gdk/tools/vs2022_workloads_game_development.png" />

Además de las herramientas principales de C++ que necesita para el desarrollo de juegos, asegúrese de que el componente **Windows 10 SDK (22000)** esté instalado para proporcionar el Windows SDK necesario para compilar juegos con el GDK. También puede usar el *Windows SDK para Windows 11, versión 22H2 (10.0.22621)* o el *Windows SDK para Windows 11, versión 24H2 (10.0.26100)*, pero no son obligatorios.

Aunque no es obligatorio, instalar la carga de trabajo **Desktop development with C++** proporciona más herramientas y ejemplos que pueden resultarle útiles. Por ejemplo, **Desktop development with C++** es necesaria si compila con el conjunto de herramientas Clang/LLVM.

## Instalación de conjuntos de herramientas opcionales

La carga de trabajo **Game development with C++** instala la versión de Visual Studio 2022 de las herramientas de compilación de MSVC (versión **v143**). Además del conjunto de herramientas **v143**, el GDK también admite la compilación con los siguientes conjuntos de herramientas:

* v142 (el conjunto de herramientas de Visual Studio 2019)
* las herramientas de C++ Clang para Windows

Esta flexibilidad le permite actualizar al IDE de Visual Studio 2022 sin actualizar su conjunto de herramientas.

Puede encontrar los conjuntos de herramientas opcionales en la carga de trabajo **Desktop Development with C++**, o buscando en los **Individual Components** en el cuadro de diálogo de instalación de Visual Studio.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_optional_toolsets.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=dabf5dc04ac037d980dc20784cf60caa" alt="Selección de conjuntos de herramientas opcionales al instalar Visual Studio 2022" width="1160" height="518" data-path="images/gdk/tools/vs2022_optional_toolsets.png" />

## Selección de un conjunto de herramientas para un proyecto

Especifique el conjunto de herramientas que se usará para un proyecto mediante la propiedad **Platform Toolset** de la página de propiedades del proyecto.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_specify_a_toolset.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=1ea3eed598eb3d7937b59384b6f5a563" alt="Especificación del conjunto de herramientas que se usará al compilar un proyecto" width="788" height="539" data-path="images/gdk/tools/vs2022_specify_a_toolset.png" />

También puede especificar la propiedad **PlatformToolset** manualmente en el archivo del proyecto, como se muestra en el siguiente grupo de propiedades.

```xml theme={null}
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Gaming.Xbox.Scarlett.x64'" Label="Configuration">
  <ConfigurationType>Application</ConfigurationType>
  <PlatformToolset>v143</PlatformToolset>
  <UseDebugLibraries>true</UseDebugLibraries>
  <CharacterSet>Unicode</CharacterSet>
  <EmbedManifest>false</EmbedManifest>
  <GenerateManifest>false</GenerateManifest>
</PropertyGroup>
```

## Depuración de proyectos de XBOX mediante Visual Studio 2022

Para depurar mediante Visual Studio 2022, compile el título que está depurando con el GDK de marzo de 2022 (o posterior). Esta dependencia existe porque el Game OS que se incluye en esas versiones del GDK contiene archivos binarios necesarios para la depuración mediante Visual Studio 2022. Si intenta depurar mediante Visual Studio 2022 con un Game OS anterior, verá el siguiente mensaje de error.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs_2022_old_gamos_debug_error.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=1c2d4c8fd1be70615c84d85d0ce2f216" alt="Intento de usar el depurador de Visual Studio 2022 con un Game OS anterior a la versión incluida en el GDK de marzo de 2022" width="418" height="191" data-path="images/gdk/tools/vs_2022_old_gamos_debug_error.png" />

Cuando use el cuadro de diálogo **Attach** del menú **Debug** en Visual Studio 2022, seleccione **XBOX Direct Connection** en la lista desplegable **Connection Type** y escriba la dirección Host IP de la consola en el cuadro de texto **Connection Target**. Use la herramienta de línea de comandos [xbconnect](/tools/tools-console/commandlinetools/xbconnect) para determinar la Host IP.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_attach_dialog.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=71f8447875f069e11920e2d3a8ae12c5" alt="Uso del cuadro de diálogo de asociación de Visual Studio 2022" width="860" height="611" data-path="images/gdk/tools/vs2022_attach_dialog.png" />

<Note>Estos valores son diferentes de los valores que se especifican al asociar mediante Visual Studio 2019. Cuando usa Visual Studio 2019, el tipo de conexión es **Remote no authentication** y la dirección IP es la dirección System IP de la consola.</Note>

## Modelo de mantenimiento de Visual Studio 2022

Visual Studio 2022 incluye un nuevo modelo de mantenimiento que puede usar para seleccionar una base de referencia de mantenimiento y, después, obtener solo actualizaciones para esa base de referencia. Este nuevo modelo reemplaza a los modelos de mantenimiento de las versiones anteriores de Visual Studio, que recomendaban encarecidamente el uso de la versión más reciente disponible. Para obtener más detalles, consulte [Ciclo de vida y mantenimiento de productos de Visual Studio](https://learn.microsoft.com/lifecycle/products/visual-studio-2022).

## Notificación de errores

Notifique los errores del **compilador de Visual C++** (si es posible) a través de *Report a Problem...* de Visual Studio. Para obtener más información, consulte [Microsoft Docs](https://learn.microsoft.com/visualstudio/ide/how-to-report-a-problem-with-visual-studio) y el sitio web de la [Developer Community](https://aka.ms/feedback/report?space=62). Asegúrese de leer [esta página](https://aka.ms/compilerbug) para obtener detalles sobre cómo crear un buen informe de errores para el compilador.

<Note>Puede agregar un comentario a un problema notificado públicamente marcado como "Microsoft only" si se requiere información privada para reproducir el problema.</Note>

Para notificar errores del **compilador clang/LLVM para Windows**, use [https://bugs.llvm.org/](https://bugs.llvm.org/)

Para los informes de errores de la **biblioteca estándar de C++ de Microsoft** (también conocida como STL), use [https://github.com/microsoft/STL/issues](https://github.com/microsoft/STL/issues)

Como siempre, no dude en ponerse en contacto con su *representante de Microsoft* para los problemas críticos que necesiten escalarse.

## Problemas conocidos

* El Game OS no admite la funcionalidad de zonas horarias de `std:chrono` agregada en C++20 P0355R7 \<chrono> *Calendars And Time Zones* porque no incluye `icu.dll`, `icuin.dll`, `icuuc.dll` ni los archivos de datos asociados en la imagen XVD. Si usa estas funciones, su aplicación produce una excepción de C++ en tiempo de ejecución. La funcionalidad de calendarios de PR0355R7 sí se admite.

## Consulte también

[Visual Studio](/tools/tools-console/visualstudio/visualstudio)

[Plantillas de proyecto en Visual Studio para el desarrollo de XBOX](/tools/tools-console/visualstudio/durango-visual-studio-templates)

[Propiedades de Visual Studio para el desarrollo de XBOX](/tools/tools-console/visualstudio/durango-property-pages)

[Depuración de proyectos de XBOX mediante Visual Studio](/tools/tools-console/visualstudio/debugging-with-visualstudio)


## Related topics

- [Notas de compatibilidad de Visual Studio 2022](/es/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md)
- [Notas de compatibilidad del GDK con Visual Studio 2019](/es/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Notas de compatibilidad de Visual Studio 2019](/es/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [Notas de compatibilidad del GDK con Visual Studio 2026](/es/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Depuración de proyectos de XBOX con Visual Studio](/es/tools/tools-console/visualstudio/debugging-with-visualstudio.md)