Como iniciar uma sessão de depuração (JavaScript)

Este tópico descreve como iniciar uma sessão de depuração para aplicativos da Windows Store gravados em JavaScript e em HTML5. Você pode iniciar a depuração com um único pressionamento de tecla ou pode configurar a sessão de depuração para cenários específicos e então escolher a maneira de iniciar o aplicativo.

Neste tópico

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

A maneira fácil de iniciar a depuração

1. Abra a solução do aplicativo no Visual Studio.

2. Pressione F5.

O Visual Studio compila e inicia o aplicativo com o depurador anexado. A execução continua até que um ponto de interrupção seja alcançado, você suspenda a execução manualmente, ocorra uma exceção sem tratamento ou o aplicativo chegue ao fim. Para obter mais informações, consulte Guia de início rápido: Depurando aplicativos (JavaScript).

Configurar a sessão de depuração

Como o script não é compilado, as configurações da plataforma e da compilação não se aplicam. Se você estiver depurando um componente gerenciado ou em C++, defina Configuração como Depurar e escolha a plataforma de destino na caixa de diálogo Configuração.

Abrir a página de propriedades de depuração do projeto

1. No Gerenciador de Soluções, selecione o projeto. No menu de atalho, escolha Propriedades.

2. Expanda o nó Propriedades de Configuração e escolha Depuração.

Escolher as opções de configuração de compilação

1. Na lista Configuração, escolha Depurar ou (Ativo) Depurar.

2. Na lista Plataforma, escolha a plataforma de destino da compilação. Na maioria dos casos, Qualquer CPU é a melhor opção.

Escolher o destino de implantação

Você pode implantar e depurar um aplicativo no computador com o Visual Studio, no simulador do Visual Studio no computador local, ou em um computador remoto. Escolha o destino na lista Depurador a iniciar na página de propriedades Depurando do projeto.

Escolha uma destas opções na lista Depurador a iniciar:

Computador Local	Depura o aplicativo na sessão atual no computador local. Consulte Executando aplicativos da Windows Store no computador local.
Simulador	Depura o aplicativo no simulador do Visual Studio para aplicativos Windows Store. O simulador é uma janela da área de trabalho que permite depurar recursos, como gestos de toque e rotação de dispositivos, que não estão disponíveis no computador local. Consulte Executando aplicativos da Windows Store no simulador.
Computador Remoto	Depura o aplicativo em um dispositivo conectado ao computador local por uma intranet ou diretamente por meio de um cabo Ethernet. Para depurar remotamente, as Ferramentas Remotas do Visual Studio devem estar instaladas e em execução no dispositivo remoto. Consulte Executando aplicativos da Windows Store em um computador remoto.

Se você escolher Computador Remoto, especifique o nome ou endereço IP do computador remoto de uma destas formas:

• Digite o nome ou endereço IP do computador remoto na caixa Nome do Computador.

• Clique na seta para baixo da caixa Nome do Computador e escolha <Localizar...>. Em seguida, escolha o computador remoto na caixa de diálogo Selecionar Conexão de Depurador Remoto.

  

  Dica

  A caixa de diálogo Selecionar Conexão de Depurador Remoto exibe os computadores que estão na sub-rede local e os computadores que estão diretamente conectados ao computador com o Visual Studio por um cabo Ethernet. Para especificar outro computador, digite o nome na caixa Nome do Computador.

Escolher o depurador a ser usado

Por padrão, o depurador é anexado ao código JavaScript do aplicativo. Você pode optar por depurar o código gerenciado e C++ nativo dos componentes do aplicativo em vez do código JavaScript. Especifique o código a ser depurado na lista Tipo de Depurador na página de propriedades Depuração do projeto do aplicativo.

Escolha um destes depuradores na lista Tipo de Depurador:

Somente Script	Depura o código JavaScript no aplicativo. O código gerenciado e o código nativo são ignorados.
Somente Nativo	Depura o código C/C++ nativo no aplicativo. O código gerenciado e o código JavaScript são ignorados.
Somente Gerenciado	Depura o código gerenciado no aplicativo. O código JavaScript e o código C/C++ nativo são ignorados.
Misto (Gerenciado e Nativo)	Depura o código C/C++ nativo e o código gerenciado no aplicativo. O código JavaScript é ignorado.

(Opcional) Atrasar o início do aplicativo na sessão de depuração

Por padrão, o Visual Studio inicia o aplicativo imediatamente quando você começa a depuração. Você também pode iniciar uma sessão de depuração, mas atrasar o início do seu aplicativo. O aplicativo é iniciado no depurador quando é executado no menu Iniciar ou por um contrato de ativação ou quando é iniciado por outro processo ou método. Você também pode usar o início atrasado para depurar eventos em segundo plano no seu aplicativo que deseja que ocorra quando o aplicativo não estiver em execução.

Você especifica se deseja ou não atrasar a inicialização do aplicativo na lista Iniciar Aplicativo na página de propriedades Depuração do projeto do aplicativo. Escolha uma destas opções:

• Escolha Não para atrasar a inicialização do aplicativo.

• Escolha Sim para iniciar o aplicativo imediatamente.

(Opcional) Desabilitar loopbacks de rede

Por motivos de segurança, um aplicativo da Windows Store instalado da maneira padrão não pode efetuar chamadas de rede para o dispositivo em que está instalado. Por padrão, a implantação do Visual Studio cria uma isenção dessa regra para o aplicativo implantado. Essa isenção permite que você teste procedimentos de comunicação em um único computador. Antes de enviar seu aplicativo para o Windows Store, você deve testá-lo sem a isenção.

Para remover a isenção de loopback de rede, escolha Não na lista Permitir Loopback de Rede na página de propriedades Depuração.

Iniciar a sessão de depuração

Iniciar a depuração (F5)

Quando você escolhe Iniciar Depuração no menu Depurar (teclado: F5), o Visual Studio inicia o aplicativo com o depurador anexado. A execução continua até que um ponto de interrupção seja alcançado, você suspenda a execução manualmente, ocorra uma exceção sem tratamento ou o aplicativo chegue ao fim.

Iniciar a depuração (F5), mas atrasar o início do aplicativo

Você pode definir que o aplicativo seja executado no modo de depuração, mas deixe-o ser iniciado por outro método que não seja o depurador. Por exemplo, convém depurar a inicialização do aplicativo no menu Iniciar ou depurar um processo em segundo plano do aplicativo sem iniciá-lo. Para atrasar o início do aplicativo, faça o seguinte:

1. Na página Depurar das propriedades do projeto do aplicativo, escolha Não na lista Iniciar Aplicativo.

2. Escolha Iniciar Depuração no menu Depurar (teclado: F5).

3. Inicie o aplicativo pelo menu Iniciar, por um contrato de execução ou por outro procedimento.

O aplicativo é iniciado no modo de depuração. A execução continua até que um ponto de interrupção seja alcançado, você suspenda a execução manualmente, ocorra uma exceção sem tratamento ou o aplicativo chegue ao fim.

. Para obter mais informações sobre como depurar tarefas em segundo plano, consulte Como disparar eventos de suspensão, retomada e no plano de fundo em aplicativos da Windows Store.

Iniciar um aplicativo instalado no depurador

Quando você inicia a depuração usando F5, o Visual Studio compila e implanta o aplicativo, define que ele seja executado no modo de depuração e, em seguida, inicia-o. Para iniciar um aplicativo que já está instalado em um dispositivo, use a caixa de diálogo Depurar Pacote do Aplicativo Instalado. Esse procedimento é útil quando você precisa depurar um aplicativo instalado da Windows Store ou quando você tem os arquivos de origem do aplicativo, mas não tem um projeto do Visual Studio para o aplicativo. Por exemplo, você pode ter um sistema de compilação personalizado que não use projetos ou soluções do Visual Studio.

O aplicativo pode ser instalado no dispositivo local ou pode estar localizado em um dispositivo remoto. É possível iniciar o aplicativo imediatamente ou defini-lo para ser executado no depurador quando for iniciado por outro processo ou método, por exemplo, no menu Iniciar ou por um contrato de ativação. Você também pode definir o aplicativo para ser executado no modo de depuração quando quiser depurar um processo em segundo plano sem iniciar o aplicativo. Para obter mais informações, consulte Como disparar eventos de suspensão, retomada e no plano de fundo em aplicativos da Windows Store.

Para definir um aplicativo instalado para ser executado no modo de depuração, faça o seguinte:

Dica

O aplicativo não deve estar em execução quando você iniciar este procedimento.

1. No menu Depurar, escolha Depurar Pacote do Aplicativo Instalado.

2. Escolha uma destas opções na lista:

   Computador Local	Depura o aplicativo na sessão atual no computador local. Consulte Executando aplicativos da Windows Store no computador local.
   Simulador	Depura o aplicativo no simulador do Visual Studio para aplicativos Windows Store. O simulador é uma janela da área de trabalho que permite depurar recursos, como gestos de toque e rotação de dispositivos, que não estão disponíveis no computador local. Consulte Executando aplicativos da Windows Store no simulador.
   Computador Remoto	Depura o aplicativo em um dispositivo conectado ao computador local por uma intranet ou diretamente por meio de um cabo Ethernet. Para depurar remotamente, as Ferramentas Remotas do Visual Studio devem estar instaladas e em execução no dispositivo remoto. Consulte Executando aplicativos da Windows Store em um computador remoto.

3. Escolha o aplicativo na lista Pacotes do Aplicativo Instalados.

4. Escolha o mecanismo de depuração a ser usado na lista Depurar este tipo de código.

5. (Opcional). Escolha Não iniciar, mas sim depurar meu código quando iniciar para depurar o aplicativo quando ele for iniciado por outro método ou para depurar um processo em segundo plano.

Quando você clicar em Iniciar, o aplicativo será iniciado ou definido para ser executado no modo de depuração.

Anexar o depurador a um aplicativo em execução

Para anexar o depurador a um aplicativo Windows Store, você deve usar o Gerenciador de Pacotes Depuráveis para definir a execução do aplicativo no modo de depuração. Esse recurso é instalado com as Ferramentas Remotas do Visual Studio.

Anexar o depurador a um aplicativo é útil quando você precisa depurar um aplicativo já instalado; por exemplo, um que tenha sido instalado da Windows Store. A anexação é necessária quando você tem os arquivos de origem do aplicativo, mas não tem um projeto do Visual Studio para ele. Por exemplo, você pode ter um sistema de compilação personalizado que não use projetos ou soluções do Visual Studio.

Para anexar a um aplicativo:

1. Defina o aplicativo para ser executado no modo de depuração. Isso deve ser feito quando o aplicativo não está em execução.

2. Inicie o aplicativo. Você pode fazer isso pelo menu Iniciar, por um contrato de execução ou por outro método.

3. Anexe o depurador ao aplicativo em execução.

Definir o aplicativo para ser executado no modo de depuração

1. Instale as Ferramentas Remotas do Visual Studio no dispositivo em que o aplicativo está instalado. Consulte Installing the Remote Debugger.

2. No menu Iniciar, procure por Debuggable Package Manager e inicie-o.

   É exibida uma janela do PowerShell corretamente configurada para o cmdlet AppxDebug.

3. Para habilitar a depuração de um aplicativo, é preciso especificar o identificador NomeCompletodoPacote do aplicativo. Para ver uma lista de todos os aplicativos que incluem o NomeCompletodoPacote, digite Get-AppxPackage no aviso do PowerShell.

4. No aviso do PowerShell, insira Enable-AppxDebug NomeCompletodoPacote, onde NomeCompletodoPacote é o identificador NomeCompletodoPacote do aplicativo.

Anexar o depurador

Dica

Os aplicativos em JavaScript são executados em uma instância do processo de wwahost.exe. Se outros aplicativos em JavaScript estiverem em execução quando você anexar o depurador ao aplicativo, será preciso saber a ID de processo numérica (PID) do wwahost.exe em que o aplicativo está sendo executado.

A maneira mais fácil de lidar com essa situação é fechar todos os outros aplicativos em JavaScript. Como alternativa, você pode abrir o Gerenciador de Tarefas do Windows antes de iniciar o aplicativo e anotar as IDs dos processos de wwahost.exe. Quando você especificar o processo ao qual anexar na caixa de diálogo Processos Disponíveis, o wwahost.exe do aplicativo terá uma ID que será diferente daquelas que você anotou.

Para anexar o depurador:

1. No menu Depurar, escolha Anexar ao Processo.

   É exibida a caixa de diálogo Anexar ao Processo.

2. Para anexar a um aplicativo em um dispositivo remoto, especifique o dispositivo remoto na caixa Qualificador. Você pode:

   • Digitar o nome na caixa Qualificador.

   • Clicar na seta para baixo na caixa Qualificador e escolher um item em uma lista de dispositivos aos quais o depurador já foi anexado.

   • Escolher Localizar para selecionar o dispositivo em uma lista na sub-rede local.

3. Especifique o tipo de código que você deseja depurar na caixa Anexar a.

   Escolha Selecionar e siga um destes procedimentos:

   • Escolha Determinar automaticamente o tipo de código a ser depurado.

   • Escolha Depurar esses tipos de código e selecione um ou mais tipos na lista.

4. Na lista Processos Disponíveis, escolha o processo apropriado de wwahost.exe. Use a coluna Título para identificar seu aplicativo.

5. Escolha Anexar.

O Visual Studio anexa o depurador ao processo. A execução continua até que um ponto de interrupção seja alcançado, você suspenda a execução manualmente, ocorra uma exceção sem tratamento ou o aplicativo chegue ao fim.

Consulte também

Conceitos

Guia de início rápido: Navegação do depurador (JavaScript)

Guia de início rápido: Depurando aplicativos (JavaScript)

Como disparar eventos de suspensão, retomada e no plano de fundo em aplicativos da Windows Store

Depurando aplicativos da Windows Store