> ## 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 de Visual Studio 2019

> Notas de compatibilidad de Visual Studio 2019

En este tema se describe la compatibilidad del Microsoft Game Development Kit (GDK) con Visual Studio 2019. Visual Studio 2019 [versión 16.11](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019) es compatible con el desarrollo con el Microsoft Game Development Kit (GDK).

<Note>Las versiones 16.0 a 16.10 de Visual Studio 2019 quedaron fuera de soporte en octubre de 2022.</Note>

## Instalación de Visual Studio 2019

Al instalar Visual Studio 2019, debe seleccionar la carga de trabajo **Desarrollo de juegos con C++** durante la instalación, como se muestra en la captura de pantalla siguiente.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_workloads_game_devlopment.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=4fb4b71036246e053fa20ee3270bb27b" alt="Captura de pantalla del cuadro de diálogo de la carga de trabajo Desarrollo de juegos con C++" width="403" height="84" data-path="images/gdk/tools/vs_workloads_game_devlopment.png" />

Además de las herramientas básicas de C++ que necesita para el desarrollo de juegos para PC con Windows, Desarrollo de juegos con C++ también incluye la versión del SDK de Windows 10 necesaria para compilar juegos para PC con Windows con el Microsoft Game Development Kit (GDK).

Aunque no es obligatorio, instalar la carga de trabajo Desarrollo para el escritorio con C++ proporciona herramientas y ejemplos adicionales que pueden resultarle útiles.

Según sus necesidades, puede elegir instalar cargas de trabajo o componentes opcionales adicionales.

* Si está compilando un juego que usa Unity, instale la carga de trabajo **Desarrollo de juegos con Unity**.

* La versión **v142** de las herramientas de compilación de MVSC se instala con la carga de trabajo Desarrollo de juegos con C++. Si es necesario, puede usar el entorno de desarrollo integrado (IDE) de Visual Studio 2019 con las herramientas de MSVC que se incluían en Visual Studio 2017 (**v141**).  Usar el IDE más reciente sin actualizar al nuevo conjunto de herramientas le permite aprovechar las nuevas características del IDE sin tener que actualizar el código fuente para que funcione con el nuevo compilador.

> Para usar el conjunto de herramientas de Visual Studio 2017 con el IDE de Visual Studio 2019, instale el componente **MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16)** bajo la carga de trabajo **Desarrollo para el escritorio con C++**, como se muestra en la captura de pantalla siguiente. El conjunto de herramientas de Visual Studio 2017 ya no es compatible a partir de la versión de octubre de 2024.

* Para depurar el juego en un equipo remoto, consulte [Depuración remota de un proyecto de C++ en Visual Studio](https://learn.microsoft.com/visualstudio/debugger/remote-debugging-cpp) para obtener instrucciones sobre cómo instalar las Herramientas remotas de Visual Studio.

## Migración de proyectos existentes de Visual Studio 2017 a Visual Studio 2019

En la mayoría de los casos, el asistente de actualización que se proporciona con Visual Studio puede migrar el proyecto a Visual Studio 2019 sin ningún otro cambio. Cuando abre un proyecto de Visual Studio 2017 en Visual Studio 2019, verá el siguiente cuadro de diálogo Revisar acciones de la solución que le pide que actualice. Para actualizar el proyecto, seleccione **Aceptar**.

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs_convert_2017_to_2019.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=77e8e2059ed810747afecaea859027a2" alt="Captura de pantalla del cuadro de diálogo Revisar acciones de la solución del asistente de actualización en Visual Studio 2019, con las opciones de redestinación de un proyecto de Visual Studio 2017" width="669" height="371" data-path="images/gdk/tools/vs_convert_2017_to_2019.png" />

También puede elegir usar el IDE de Visual Studio 2019 sin actualizar las herramientas de compilación. Para ello, seleccione **Cancelar** en el cuadro de diálogo **Revisar acciones de la solución**.

### Actualización manual de proyectos a Visual Studio 2019

Si desea actualizar el proyecto editando directamente los archivos de proyecto (.vcxproj), debe realizar los cambios siguientes.

1. Agregue `WindowsTargetPlatformVersion` al grupo de propiedades `Globals`. Establezca su valor en 10.0. A continuación se muestra un ejemplo.

```xml theme={null}
      <PropertyGroup Label="Globals">
        <WindowsTargetPlatformVersion>10.0</WindowsTargetPlatformVersion>
        ...
```

1. Cambie todas las instancias de `PlatformToolset` de v141 a v142. A continuación se muestra un ejemplo.

```xml theme={null}
    <PlatformToolset>v141</PlatformToolset>
    ...
    <PlatformToolset>v142</PlatformToolset>  
```

1. Recompile el proyecto.

### Compatibilidad con proyectos de clang/LLVM para Windows (ClangCl)

Visual Studio 2019 también admite el desarrollo con clang/LLVM para Windows. Esto requiere instalar **C++ Clang-cl for Windows** y **C++ Clang-cl for v142 build tools (x64/x86)**, que son componentes individuales.

Consulte el tema sobre Clang del [Microsoft Game Development Kit (GDK)](/tools/tools-pc/visualstudio/gr-vs-clang) y [Microsoft Docs](https://learn.microsoft.com/cpp/build/clang-support-msbuild) para obtener más información.

## Problemas conocidos

* Las funciones \*IsNan de DirectXMath pueden producir errores con Visual Studio 2019 cuando se compilan con `/fp:fast`. La corrección es usar Visual Studio 2019 (16.3 o posterior) con DirectXMath 3.14 o posterior. De lo contrario, puede solucionar el problema colocando instrucciones `#pragma float_control` alrededor del uso de esas funciones.

* El uso de encabezados precompilados presenta varios problemas en clang/LLVM para Windows anterior a la versión 11. Según el uso que haga de PCH y de las plantillas de C++, es posible que deba agregar `-fno-pch-instantiate-templates` para compilar correctamente.

* [Las actualizaciones de .NET Core entregadas a través de Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/) pueden bloquear la instalación del Microsoft Game Development Kit (GDK). Para resolver este problema, actualice su instancia de Visual Studio o desinstale el componente Microsoft.NET.Core.Component.SDK.2.1 mediante el Instalador de Visual Studio y, a continuación, vuelva a intentar instalar (o desinstalar) el Microsoft Game Development Kit (GDK).

## Notificación de errores

Los informes de errores del **compilador de Visual C++** deben notificarse (si es posible) mediante *Notificar un problema...* de Visual Studio. 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 adicional cubierta por NDA 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)

## Consulte también

[Visual Studio para el desarrollo de juegos para PC](/tools/tools-pc/visualstudio/gr-visualstudio-toc)


## Related topics

- [Visual Studio (contenido)](/es/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)
- [Visual Studio para el desarrollo en consola](/es/tools/tools-console/visualstudio/visualstudio.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 2022](/es/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md)
- [Notas de compatibilidad del GDK con Visual Studio 2026](/es/tools/tools-console/visualstudio/vs-2026-support-notes.md)
