Cómo iniciar una sesión de depuración (JavaScript)

En este tema se describe cómo iniciar una sesión de depuración para aplicaciones de la Tienda Windows escritas en JavaScript y HTML5. Puedes iniciar la depuración presionando una sola tecla. Si lo prefieres, puedes configurar la sesión de depuración para escenarios concretos y, después, elegir la manera de iniciar la aplicación.

En este tema

In this topic

The easy way to start debugging

Configure the debugging session

• Open the debugging property page for the project

• Choose the build configuration options

• Choose the deployment target

• Choose the debugger to use

• (Optional) Delay starting the app in the debug session

• (Optional) Disable network loopbacks

Start the debugging session

• Start debugging (F5)

• Start debugging (F5) but delay the app start

Start an installed app in the debugger

Attach the debugger to a running app

• Set the app to run in debug mode

• Attach the debugger

Iniciar la depuración de manera sencilla

1. Abre la solución de aplicación en Visual Studio.

2. Presiona F5.

Visual Studio compila e inicia la aplicación con el depurador asociado. La ejecución continúa hasta que se alcanza un punto de interrupción, se suspende manualmente la ejecución, se produce una excepción no controlada o la aplicación finaliza. Para obtener más información, consulta Inicio rápido: depurar aplicaciones (JavaScript).

Configurar la sesión de depuración

Dado que el script no se compila, las configuraciones de compilación y de la plataforma no se aplican. Si estás depurando un componente de C++ o administrado, establece Configuración en Depurar y elige la plataforma de destino en el cuadro de diálogo Configuración.

Abrir la página de propiedades de depuración del proyecto

1. En el Explorador de soluciones, selecciona el proyecto. Elige Propiedades en el menú contextual.

2. Expande el nodo Propiedades de configuración y selecciona Depuración.

Elegir las opciones de configuración de compilación

1. En la lista Configuración, elige Debug o (Active) Debug.

2. En la lista Plataforma elige la plataforma de destino para la que se va a compilar. En la mayoría de los casos, Any CPU es la mejor opción.

Elegir el destino de implementación

Puedes implementar y depurar una aplicación en el equipo de Visual Studio, en el simulador de Visual Studio del equipo local, o en un equipo remoto. Elige el destino en la lista Depurador para iniciar de la página de propiedades de Depuración del proyecto.

Elige una de estas opciones en la lista Depurador para iniciar:

Si eliges Equipo remoto, especifica el nombre o la dirección IP del equipo remoto de una de estas maneras:

• Escribe el nombre o la dirección IP del equipo remoto en el cuadro Nombre de equipo.

• Haz clic en la flecha abajo en el cuadro Nombre de equipo y elige <Buscar...>. Luego, elige el equipo remoto en el cuadro de diálogo Seleccionar conexión del depurador remoto.

  

  Nota

  El cuadro de diálogo Seleccionar conexión del depurador remoto muestra los equipos que están en la subred local y los que están conectados directamente con el equipo de Visual Studio mediante un cable Ethernet. Para especificar otro equipo, escribe su nombre en el cuadro Nombre de equipo.

Elegir el depurador utilizado

De forma predeterminada, el depurador se asocia al código de JavaScript de la aplicación. Puedes depurar el código C++ nativo y administrado de los componentes de la aplicación en lugar del código de JavaScript. El código que se debe depurar se especifica en la lista Tipo de depurador de la página de propiedades de Depuración del proyecto de aplicación.

Elige uno de estos depuradores en la lista Tipo de depurador:

(Opcional) Retrasar el inicio de la aplicación en la sesión de depuración

De forma predeterminada, Visual Studio inicia inmediatamente la aplicación cuando se iniciar la depuración. También puedes iniciar una sesión de depuración pero retrasar el inicio de la aplicación. La aplicación se inicia en el depurador cuando se inicia en el menú Inicio, mediante un contrato de activación, o desde otro proceso o método. También puedes utilizar el inicio retrasado para depurar eventos en segundo plano en la aplicación que deseas que se produzcan cuando la aplicación no se esté ejecutando.

Si el inicio de la aplicación se retrasará o no se especifica en la lista Iniciar aplicación de la página de propiedades de Depuración del proyecto de aplicación. Elige una de estas opciones:

• Elige No para retrasar el inicio de la aplicación.

• Elige Sí para iniciar la aplicación inmediatamente.

(Opcional) Deshabilitar bucles invertidos de red

Por razones de seguridad, a las aplicaciones de la Tienda Windows instaladas de la manera estándar en un dispositivo no se les permite realizar llamadas de red a ese dispositivo. De forma predeterminada, la implementación de Visual Studio crea una exención respecto a esta regla para la aplicación implementada. Esta exención te permite probar procedimientos de comunicación en un mismo equipo. Antes de enviar tu aplicación a la Tienda Windows, debes probarla sin la exención.

Para quitar la exención de bucle invertido de red, elige No en la lista Permitir bucle invertido de red en la página de propiedades de Depuración.

Iniciar la sesión de depuración

Iniciar la depuración (F5)

Cuando eliges Iniciar depuración en el menú Depurar (teclado: F5), Visual Studio inicia la aplicación con el depurador asociado. La ejecución continúa hasta que se alcanza un punto de interrupción, se suspende manualmente la ejecución, se produce una excepción no controlada o la aplicación finaliza.

Iniciar la depuración (F5) pero retrasar el inicio de la aplicación

Puedes establecer que la aplicación se ejecute en modo de depuración, pero hacer que se inicie mediante un método que no sea el depurador. Por ejemplo, puedes depurar el inicio de tu aplicación desde el menú Inicio o depurar un proceso en segundo plano de la aplicación sin iniciarla. Si deseas retrasar el inicio de la aplicación, realiza lo siguiente:

1. En la página Depurar de propiedades del proyecto de la aplicación, elige No en la lista Iniciar aplicación.

2. Elige Iniciar depuración en el menú Depurar (teclado: F5).

3. Inicia la aplicación desde el menú Inicio, un contrato de ejecución o mediante otro procedimiento.

La aplicación se inicia en modo de depuración. La ejecución continúa hasta que se alcanza un punto de interrupción, se suspende manualmente la ejecución, se produce una excepción no controlada o la aplicación finaliza.

. Para obtener más información sobre la depuración de tareas en segundo plano, consulta Desencadenar eventos de suspensión, reanudación y en segundo plano en aplicaciones de la Tienda Windows.

Iniciar una aplicación instalada en el depurador

Si inicias la depuración utilizando F5, Visual Studio compila e implementa la aplicación, establece que la aplicación se ejecute en modo de depuración y, a continuación, la inicia. Para iniciar una aplicación que ya está instalada en un dispositivo, utiliza el cuadro de diálogo Depurar paquete de aplicaciones instalado. Este procedimiento es útil si necesitas depurar una aplicación instalada desde la Tienda Windows o si tienes los archivos de origen de la aplicación pero no tienes un proyecto de Visual Studio para ella. Por ejemplo, puede que tengas un sistema de compilación personalizado que no utilice proyectos o soluciones de Visual Studio.

La aplicación puede estar instalada en el dispositivo local o en un dispositivo remoto. Puedes iniciar la aplicación inmediatamente o establecer que se ejecute en el depurador cuando se inicie mediante otro proceso o método, por ejemplo desde el menú Inicio o mediante un contrato de activación. También puedes establecer que la aplicación se ejecute en modo de depuración cuando desees depurar un proceso en segundo plano sin iniciar la aplicación. Para obtener más información, consulta Desencadenar eventos de suspensión, reanudación y en segundo plano en aplicaciones de la Tienda Windows.

Para establecer que una aplicación instalada se ejecute en modo de depuración, realiza lo siguiente:

1. En el menú Depurar, elige Depurar paquete de aplicaciones instalado

2. Elige una de las opciones siguientes de la lista:

   Equipo local	Depura la aplicación en la sesión actual en el equipo local. Consulta Ejecutar aplicaciones de la Tienda Windows en el equipo local.
   Simulador	Depura la aplicación en el simulador de Visual Studio para aplicaciones de la Tienda Windows. El simulador es una ventana del escritorio que te permite depurar la funcionalidad del dispositivo (por ejemplo, gestos táctiles y de rotación de dispositivos) que no está disponible en el equipo local. Consulta Ejecutar aplicaciones de la Tienda Windows en el simulador.
   Equipo remoto	Depura la aplicación en un dispositivo que esté conectado al equipo local a través de la intranet o directamente mediante un cable Ethernet. Para depurar remotamente, las Herramientas remotas de Visual Studio deben estar instaladas y ejecutándose en el dispositivo remoto. Consulta Ejecutar aplicaciones de la Tienda Windows en un equipo remoto.

3. Elige la aplicación en la lista Paquetes de aplicaciones instalados.

4. Elige el motor de depuración que deseas usar en la lista Depurar este tipo de código.

5. (Opcional). Elige No iniciar, pero depurar mi código al empezar para depurar la aplicación cuando se inicie mediante otro método o para depurar un proceso en segundo plano.

Cuando hagas clic en Inicio, la aplicación se iniciará o se establecerá que se ejecute en modo de depuración.

Asociar el depurador a una aplicación en ejecución

Si quieres asociar el depurador a una aplicación de la Tienda Windows, debes utilizar el Administrador de paquetes depurables para establecer la aplicación de modo que se ejecute en modo de depuración. El Administrador de paquetes depurables se instala con las Herramientas remotas de Visual Studio.

Asociar el depurador a una aplicación resulta útil si tienes que depurar una aplicación ya instalada, por ejemplo, que se haya instalado desde la Tienda Windows. Es necesario asociarlo cuando tienes los archivos de origen de la aplicación pero no tienes un proyecto de Visual Studio para ella. Por ejemplo, puede que tengas un sistema de compilación personalizado que no utilice proyectos o soluciones de Visual Studio.

Para asociarlo a una aplicación:

1. Establece la aplicación para que se ejecute en modo de depuración. Se tiene que hacer cuando la aplicación no se está ejecutando.

2. Inicia la aplicación. Puedes iniciar la aplicación desde el menú Inicio, un contrato de ejecución o algún otro método.

3. Asocia el depurador a la aplicación en ejecución.

Establecer la aplicación para que se ejecute en modo de depuración

1. Instala las Herramientas remotas de Visual Studio en el dispositivo donde esté instalada la aplicación. Consulta Installing the Remote Debugger.

2. En el menú Inicio, busca Debuggable Package Manager. Inícialo.

   Se abre una ventana de PowerShell configurada correctamente para cmdlet AppxDebug.

3. Para habilitar la depuración de una aplicación, debes especificar el identificador PackageFullName de la aplicación. Para ver una lista de todas las aplicaciones que incluyen PackageFullName, escribe Get-AppxPackage en el símbolo del sistema de PowerShell.

4. En el símbolo del sistema de PowerShell, especifica Enable-AppxDebug PackageFullName, donde PackageFullName es el identificador PackageFullName de la aplicación.

Asociar el depurador

Para asociar el depurador:

1. En el menú Depurar, elige Asociar al proceso.

   Aparece el cuadro de diálogo Asociar al proceso.

2. Para asociarlo a una aplicación de un dispositivo remoto, especifícalo en el cuadro Calificador. Puedes realizar lo siguiente:

   • Escribir el nombre en el cuadro Calificador.

   • Hacer clic en la flecha abajo del cuadro Calificador y, después, elegir el dispositivo en una lista de dispositivos asociados previamente.

   • Elegir Buscar para elegir el dispositivo en una lista de dispositivos de la subred local.

3. Especifica el tipo de código que deseas depurar en el cuadro Asociar a.

   Elige Seleccionar y realiza una de las siguientes operaciones:

   • Elige Determinar automáticamente el tipo de código para depurar.

   • Elige Depurar estos tipos de código y seleccionar uno o más tipos de la lista.

4. En la lista Procesos disponibles, elige el proceso wwahost.exe apropiado. Utiliza la columna Título para identificar la aplicación.

5. Elige Asociar.

Visual Studio asocia el depurador al proceso. La ejecución continúa hasta que se alcanza un punto de interrupción, se suspende manualmente la ejecución, se produce una excepción no controlada o la aplicación finaliza.

Vea también

Conceptos

Inicio rápido: navegación del depurador (JavaScript)

Inicio rápido: depurar aplicaciones (JavaScript)

Desencadenar eventos de suspensión, reanudación y en segundo plano en aplicaciones de la Tienda Windows

Depurar aplicaciones de la Tienda Windows