Depuración de aplicaciones para UWP en máquinas remotas desde Visual Studio

Puede usar Visual Studio para ejecutar, depurar y probar una aplicación de la Plataforma universal de Windows (UWP), además de generar perfiles para ella, en otro equipo o dispositivo. Ejecutar la aplicación para UWP en una máquina remota es especialmente útil cuando el equipo de Visual Studio no admite la funcionalidad específica de UWP, como la entrada táctil, la ubicación geográfica o la orientación física.

Prerrequisitos

Para depurar una aplicación para UWP en un dispositivo remoto desde Visual Studio:

• El proyecto de Visual Studio debe estar configurado para la depuración remota.
• La máquina remota y el equipo de Visual Studio se deben conectar a través de una red o directamente mediante un cable USB o Ethernet. No se admite la depuración a través de Internet.
• Debe activar el modo de desarrollador tanto en el equipo de Visual Studio como en la máquina remota.
• Los equipos remotos deben ejecutar las Herramientas remotas para Visual Studio.
  • Algunas versiones de Windows 10 y posteriores inician y ejecutan automáticamente las herramientas remotas. Si no es así, instale y ejecute las Herramientas remotas para Visual Studio.
  • Los dispositivos Windows Mobile 10 no necesitan ni admiten las herramientas remotas.

Configuración de un proyecto de Visual Studio para la depuración remota

Usará la página Propiedades del proyecto para especificar el dispositivo al que conectarse. La configuración varía en función del lenguaje de programación.

Precaución

De forma predeterminada, la página de propiedades establece Universal (protocolo sin cifrar) como Tipo de autenticación para las conexiones remotas de Windows 10 y versiones posteriores. Es posible que deba establecer Sin autenticación para conectarse al depurador remoto. Los protocolos Universal (protocolo sin cifrar) y Sin autenticación no disponen de seguridad de red, por lo que los datos que se pasan entre las máquinas de desarrollo y remotas son vulnerables. Elija estos tipos de autenticación solo con redes de confianza que esté seguro de que no corren peligro debido a tráfico hostil o malintencionado.

Si elige Autenticación de Windows como Tipo de autenticación, tendrá que iniciar sesión en la máquina remota durante la depuración. El depurador remoto también debe ejecutarse en modo de Autenticación de Windows, con la misma cuenta de usuario que en la máquina de Visual Studio.

Configuración de un proyecto de C# o Visual Basic para la depuración remota

1. Seleccione el proyecto de C# o Visual Basic en el Explorador de soluciones de Visual Studio, seleccione el icono Propiedades y presione Alt+Entrar o haga clic con el botón derecho y seleccione Propiedades.

2. Seleccione la pestaña Depurar.

3. En Dispositivo de destino, seleccione Máquina remota si el equipo es remoto, o Dispositivo si se trata de un dispositivo de Windows Mobile 10 conectado directamente.

4. En el caso de una máquina remota, escriba el nombre o la dirección IP de la red en el campo Máquina remota, o bien seleccione Buscar para buscar el dispositivo en el cuadro de diálogo Conexiones remotas.

   

Configuración de un proyecto de C++ para la depuración remota

1. Seleccione el proyecto de C++ o Visual Studio en el Explorador de soluciones, elija el icono Propiedades y presione Alt+Entrar o haga clic con el botón derecho y seleccione Propiedades.

2. Seleccione la pestaña Depuración.

3. En Depurador para iniciar, seleccione Máquina remota si es un equipo remoto, o Dispositivo si se trata de un dispositivo Windows Mobile 10 conectado directamente.

4. En el caso de una máquina remota, escriba el nombre o la dirección IP de la red en el campo Nombre de la máquina, o baje y seleccione Buscar para buscar el dispositivo en el cuadro de diálogo Conexiones remotas.

   

Uso del cuadro de diálogo Conexiones remotas

En el cuadro de diálogo Conexiones remotas, puede buscar una dirección IP o un nombre de equipo remoto específico o detectar las conexiones automáticamente seleccionando el icono de actualización de flecha redondeada. El cuadro de diálogo solo busca en los dispositivos de la subred local que ejecutan actualmente el depurador remoto. No todos los dispositivos se pueden detectar en el cuadro de diálogo Conexiones remotas.

Sugerencia

Si no puede conectarse a un dispositivo remoto por nombre, pruebe a usar su dirección IP. Para determinar la dirección IP, en el dispositivo remoto, escriba ipconfig en una ventana de comandos. La dirección IP aparece como Dirección IPv4.

Descargue e instale Herramientas remotas para Visual Studio

Para que Visual Studio depure aplicaciones en un equipo remoto, el equipo remoto debe ejecutar las Herramientas remotas para Visual Studio.

• Los dispositivos Windows Mobile 10 no necesitan ni admiten las herramientas remotas.
• Los equipos con Windows 11 y los equipos con Windows 10 que ejecutan Creator's Update (versión 1703) y versiones posteriores y los dispositivos de Windows 10 Xbox, IoT y HoloLens instalan las herramientas remotas automáticamente al implementar la aplicación.
• En los equipos con Windows 10 anteriores a Creator's Update, debe descargar, instalar y ejecutar manualmente las herramientas remotas en el equipo remoto antes de iniciar la depuración.

Para descargar e instalar las herramientas remotas:

En el dispositivo o servidor remoto en el que desea depurar, en lugar de en el equipo de Visual Studio, descargue e instale la versión correcta de las herramientas remotas desde los vínculos de la tabla siguiente.

• Descargue la actualización más reciente de las herramientas remotas para su versión de Visual Studio. Las versiones anteriores de las herramientas remotas no son compatibles con las versiones posteriores de Visual Studio. (Por ejemplo, si usa Visual Studio 2019, descargue la actualización más reciente de las herramientas remotas para Visual Studio 2019. En este escenario, no descargue las herramientas remotas para Visual Studio 2022).
• Descargue las herramientas remotas con la misma arquitectura que el equipo en el que las va a instalar. Por ejemplo, si desea depurar aplicaciones x86 en un equipo remoto que ejecuta un sistema operativo x64, instale las herramientas remotas x64. Para depurar aplicaciones x86, ARM o x64 en un sistema operativo ARM64, instale las herramientas remotas ARM64.

Versión	Vínculo	Notas
Visual Studio 2022	Herramientas remotas	Compatible con todas las versiones de Visual Studio 2022. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64). En versiones anteriores de Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda con la descarga de herramientas remotas.
Visual Studio 2019	Herramientas remotas	Las Herramientas remotas para Visual Studio 2019 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratuito Visual Studio Dev Essentials o inicie sesión con su identificador de suscripción de Visual Studio. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64). En versiones anteriores de Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda con la descarga de herramientas remotas.
Visual Studio 2017	Herramientas remotas	Las Herramientas remotas para Visual Studio 2017 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratuito Visual Studio Dev Essentials o inicie sesión con su identificador de suscripción de Visual Studio. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64). En Windows Server, vea Desbloquear la descarga del archivo para obtener ayuda con la descarga de las herramientas remotas.
Visual Studio 2015	Herramientas remotas	Las Herramientas remotas para Visual Studio 2015 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratuito Visual Studio Dev Essentials o inicie sesión con su identificador de suscripción de Visual Studio. En Windows Server, vea Desbloquear la descarga del archivo para obtener ayuda con la descarga de las herramientas remotas.
Visual Studio 2013	Herramientas remotas	Página de descarga en la documentación de Visual Studio 2013
Visual Studio 2012	Herramientas remotas	Página de descarga de la documentación de Visual Studio 2012

Puede ejecutar el depurador remoto mediante la copia de msvsmon.exe en el equipo remoto, en lugar de instalar las herramientas remotas. Sin embargo, el Asistente para configuración de Remote Debugger (rdbgwiz.exe) solo está disponible cuando se instalan las herramientas remotas. Es posible que tenga que usar el Asistente para configuración si desea ejecutar el depurador remoto como un servicio. Para más información, vea (Opcional) Configuración del depurador remoto como servicio.

Nota

• Para depurar aplicaciones de Windows 10 o versiones posteriores en dispositivos ARM, use ARM64, que está disponible con la última versión de las herramientas remotas.
• Para depurar aplicaciones de Windows 10 en dispositivos Windows RT, use ARM, que solo está disponible en la descarga de las herramientas remotas de Visual Studio 2015.
• Para depurar aplicaciones x64 en un sistema operativo ARM64, ejecute el archivo x64 msvsmon.exe instalado con las herramientas remotas ARM64.

Configuración de las herramientas remotas

1. En el equipo remoto, busque e inicie Remote Debugger en el menú Inicio.

   Si no tiene permisos administrativos en el equipo remoto, haga clic con el botón derecho en la aplicación Remote Debugger y seleccione Ejecutar como administrador. En caso contrario, solo debe iniciarlo de la forma habitual.

   Si tiene previsto realizar una asociación a un proceso que se ejecuta como administrador o se ejecuta en una cuenta de usuario diferente (como IIS), haga clic con el botón derecho en la aplicación Remote Debugger y seleccione Ejecutar como administrador. Para obtener más información, vea Ejecución del depurador remoto como administrador.

2. La primera vez que inicies el depurador remoto (o antes de haberlo configurado), aparecerá el asistente de configuración de depuración remota.

   En la mayoría de los escenarios, elija Siguiente hasta que llegue a la página Configurar firewall de Windows del asistente.

   

3. Seleccione al menos un tipo de red en el que desee usar las herramientas remotas. Si los equipos están conectados a través de un dominio, debe elegir el primer elemento. Si los equipos están conectados a través de un grupo de trabajo o un grupo en el hogar, elija el segundo o tercer elemento según corresponda.

   A continuación, seleccione Finalizar para iniciar el depurador remoto.

4. Cuando se completa la configuración, aparecerá la ventana Remote Debugger.

   

   El depurador remoto ahora está esperando una conexión. Use el nombre del servidor y el número de puerto que se muestran para establecer la configuración de conexión remota en Visual Studio.

Para detener el depurador remoto, seleccione Archivo>Salir. Puede reiniciarlo desde el menú Inicio o desde la línea de comandos:

<Remote debugger installation directory>\msvsmon.exe

Depuración remota de aplicaciones para UWP

La depuración remota funciona igual que la depuración local.

1. En las versiones de Windows 10 anteriores a Creator's Update, asegúrese de que el Monitor de depuración remota (msvsmon.exe) se está ejecutando en el dispositivo remoto.

2. En el equipo de Visual Studio, asegúrese de que el destino de depuración correcto (Máquina remota o Dispositivo) aparezca junto a la flecha verde en la barra de herramientas.

3. Para iniciar la depuración, seleccione Depurar>Iniciar depuración y presione F5 o seleccione la flecha verde en la barra de herramientas.

   El proyecto se vuelve a compilar y, luego, se implementa y se inicia en el dispositivo remoto. El depurador suspende la ejecución en los puntos de interrupción y puede depurar paso a paso por instrucciones o por procedimientos y hasta salir del código.

4. Si es necesario, seleccione Depurar>Detener depuración o presione Mayús+F5 para detener la depuración y cerrar la aplicación remota.

Contenido relacionado

• Opciones avanzadas de implementación remota
• Prueba de aplicaciones para UWP con Visual Studio
• Depuración de aplicaciones para UWP en Visual Studio