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

# Depuración de proyectos de PC con Visual Studio

> Depuración de proyectos de PC con Visual Studio

A partir de la versión de junio de 2022 del Microsoft Game Development Kit (GDK), el depurador de código nativo que se incluye con Visual Studio se usa para depurar proyectos de juegos de PC.  Para depurar en un PC local, selecciona **Local Windows Debugger** en la lista desplegable del depurador de la barra de herramientas de Visual Studio, como se muestra en la siguiente figura.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=56657c38839ade7382132de3c5436463" alt="Se usa el depurador estándar para un proyecto" width="405" height="111" data-path="images/gdk/tools/vs_pc_debugger.png" />

Para depurar en un PC remoto, selecciona **Remote Windows Debugger** y sigue los pasos descritos en [depuración de un juego en un PC remoto](#vs_pc_debug_remote).

<Note>El depurador que se usa para proyectos con una versión del Microsoft Game Development Kit (GDK) anterior a junio de 2022 se denomina Local Machine.  La depuración remota no se admite en versiones del Microsoft Game Development Kit (GDK) anteriores a junio de 2022.</Note>

Al actualizar proyectos a la versión de junio de 2022 del Microsoft Game Development Kit (GDK), puede haber casos en los que la propiedad del depurador quede establecida en **Unsupported debug option**, como se muestra en la siguiente figura.  Si esto ocurre, la propiedad del depurador debe restablecerse a **Local Windows Debugger** mediante la barra de herramientas de depuración, la página de propiedades del proyecto o estableciendo la propiedad de msbuild **DebuggerFlavor** en **WindowsLocalDebugger** (quitar por completo la propiedad **DebuggerFlavor** también hará que se use **Local Windows Debugger**).

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_unsupported_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=bfc1a4109ce380cefb6f2726318d3172" alt="Depurador no compatible después de una actualización" width="554" height="253" data-path="images/gdk/tools/vs_pc_unsupported_debugger.png" />

Los proyectos de PC ya no requieren un paso de implementación a partir de la versión de junio de 2022 del Microsoft Game Development Kit (GDK).  La casilla **Deploy** del cuadro de diálogo **Configuration Manager** de Visual Studio está deshabilitada.

Cuando un título se inicia en el entorno comercial, se usa un proceso de inicio intermedio.  Este proceso de arranque (bootstrapper) muestra una pantalla de presentación antes de que el título comience a renderizar, comprueba si hay actualizaciones del juego, sincroniza previamente las partidas guardadas en la nube, inicia sesión previamente con un usuario, etc.  Estos comportamientos no se ejercitan en escenarios de depuración con archivos sueltos.  Usa una [compilación empaquetada](#vs_pc_debug_packaged_build) para probar o depurar un juego tal como se iniciaría en el entorno comercial.

<a id="vs_pc_debug_packaged_build" />

## Depuración de compilaciones empaquetadas

Antes de depurar una compilación empaquetada, el paquete debe instalarse mediante [wdapp install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install).  Una vez instalado, el título se puede depurar mediante la característica **Debug Installed App Package** de Visual Studio.  Usa el menú **Debug** para abrir el cuadro de diálogo de depuración, como se muestra en la siguiente figura.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_menu.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=f06707e7ae498d3863e820cfaa29391f" alt="El elemento de menú Debug Installed App Package en Visual Studio" width="652" height="311" data-path="images/gdk/tools/vs_pc_diap_menu.png" />

Para depurar tu título, búscalo en el cuadro de diálogo, establece **Debug this code type** en *Native Only* y haz clic en el botón **Start**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_dialog.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=b763e70e505dfa7cad5bd189b55dd19a" alt="El cuadro de diálogo Debug Installed App Package en Visual Studio" width="630" height="597" data-path="images/gdk/tools/vs_pc_diap_dialog.png" />

Para depurar tu título tal como se iniciaría en un entorno comercial, agrega la marca **/bootstrapper** a la línea de comandos de [wdapp install](/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install).  Los títulos instalados de esta manera serán iniciados por un proceso de arranque (bootstrapper).  La depuración en este escenario requiere la extensión **Child Process Debugging** en Visual Studio.  Instala la extensión mediante el cuadro de diálogo **Manage Extensions**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_debugger_install_child_process_debugging.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=f9d1e9b9bb0b34316aab21107d4da207" alt="Instalación de la extensión de Visual Studio Child Process Debugging" width="974" height="439" data-path="images/gdk/tools/vs_pc_debugger_install_child_process_debugging.png" />

Una vez instalada, usa el menú **Debug** para ver la configuración de **Child Process Debugging**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_child_process_debugging_menu.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=7f49ac61f434c0328bfac80be5846272" alt="El menú Child Process Debugging en Visual Studio" width="658" height="341" data-path="images/gdk/tools/vs_pc_child_process_debugging_menu.png" />

Activa la casilla **Enable child process debugging** en la página de configuración.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_child_process_debugging_setting.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=87d06bafb8bb0e40260ec6ad47118377" alt="Configuración de Child Process Debugging en Visual Studio" width="625" height="303" data-path="images/gdk/tools/vs_pc_child_process_debugging_setting.png" />

Con la depuración de procesos secundarios habilitada, el cuadro de diálogo **Debug Installed App Package** asociará ahora el depurador al título en lugar de al proceso de arranque.

<a id="vs_pc_debug_remote" />

## Depuración de un juego en un PC remoto

La depuración de un título en un PC remoto requiere las herramientas remotas de Visual Studio.  Instala las herramientas y configura el depurador remoto como se describe en [Depuración remota de un proyecto de C++ en Visual Studio](https://learn.microsoft.com/visualstudio/debugger/remote-debugging-cpp).

Selecciona **Remote Windows Debugger** en la lista desplegable **Debugger to launch** de la página de propiedades del proyecto.  Introduce el nombre del ejecutable del título, el directorio de trabajo deseado, etc.  De forma predeterminada, Visual Studio implementará el ejecutable del título y sus dependencias binarias.  Para depurar de forma remota un juego del Microsoft Game Development Kit (GDK), también será necesario implementar archivos adicionales, incluidos el archivo MicrosoftGame.config y los archivos de logotipo.  Especifica los archivos adicionales que se van a implementar mediante la propiedad **Additional files to deploy** en la página de propiedades **Remote Windows Debugger**, como se muestra en la siguiente figura.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_remote_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=d5daa87b45f098e8b9dfe68f3a794830" alt="Implementación del archivo MicrosoftGame.config y otros archivos en el escenario de PC remoto" width="784" height="541" data-path="images/gdk/tools/vs_pc_remote_debugger.png" />

## Consulte también

[Visual Studio](/tools/tools-pc/visualstudio/gr-visualstudio-toc)


## Related topics

- [Depuración de proyectos de PC en dispositivos Windows remotos en Visual Studio](/es/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md)
- [Depuración de proyectos de XBOX con Visual Studio](/es/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [Notas de compatibilidad del GDK con Visual Studio 2022](/es/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Notas de compatibilidad del GDK con Visual Studio 2026](/es/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Plantillas de proyecto en Visual Studio para el desarrollo de juegos de PC](/es/tools/tools-pc/visualstudio/gr-vs-templates.md)
