Iniciar uma sessão de depuração para aplicativos da Store no Visual Studio (JavaScript)
.png "Aplica-se ao Windows e Windows Phone")
Este tópico descreve como iniciar uma sessão de depuração para os aplicativos da Windows Store gravados em JavaScript e HTML5. Você pode iniciar a depuração com um único pressionamento de tecla ou configurar a sessão de depuração para cenários específicos e escolher a maneira de iniciar o aplicativo.
Dica
Para obter os aplicativos gravados em XAML e Visual C#, Visual C++ ou Visual Basic, veja Iniciar uma sessão de depuração de um aplicativo da Store no Visual Studio (VB, C#, C++ e XAML)
Neste tópico
Neste tópico
A maneira fácil de iniciar a depuração
Configurar a sessão de depuração
Abrir a página de propriedades de depuração do projeto
Escolher as opções de configuração de compilação
Escolher o destino de implantação
Escolher o depurador a ser usado
(Opcional) Atrasar o início do aplicativo na sessão de depuração
(Opcional) Desabilitar loopbacks de rede
Iniciar a sessão de depuração
Iniciar a depuração (F5)
Iniciar a depuração (F5), mas atrasar o início do aplicativo
Iniciar um aplicativo instalado no depurador
Anexar o depurador a um aplicativo em execução
Definir o aplicativo para ser executado no modo de depuração
Anexar o depurador
A maneira fácil de iniciar a depuração
.png "Aplica-se somente ao Windows")
Abra a solução do aplicativo no Visual Studio.
Se a solução contém projetos para aplicativos da Windows Store e Windows Phone Store, verifique se o projeto que você quer depurar é o projeto de inicialização. No Gerenciador de Soluções, escolha o projeto e Definir como Projeto de Inicialização no menu de contexto.
Imprensa F5.
.png "Aplica-se a somente para o Windows Phone")
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: depurar HTML e CSS.
Configurar a sessão de depuração
Como o script não está compilado, a configuração de compilação e as configurações da plataforma não se aplicam. Se você está depurando um componente C++ ou gerenciado, defina a Configuração para Depurar e escolha sua plataforma de destino da caixa de diálogo Configuração.
Abrir a página de propriedades de depuração do projeto
No Gerenciador de Soluções, selecione o projeto. No menu de atalho, escolha Propriedades.
Expanda o nó Propriedades de Configuração e selecione Depuração
Escolher as opções de configuração de compilação
Na lista Configuração, escolha Depurar ou (Ativo) Depurar.
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 do computador local ou de um computador remoto. Escolha o destino na lista Depurador a iniciar na página de propriedades Depuração do projeto.
No caso de um aplicativo da Windows Store, escolha uma dessas opções da lista de Dispositivo de destino:
Computador Local |
Depura o aplicativo na sessão atual no computador local. Consulte Executar aplicativos da Windows Store na máquina 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 Executar 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 Executar aplicativos da Windows Store em uma máquina remota a partir do Visual Studio. |
Se você escolher Computador Remoto, especifique o nome ou endereço IP do computador remoto de uma destas formas:
Digite o nome ou o endereço IP do computador remoto na caixa Nome do Computador.
Escolha a seta para baixo da caixa Nome do Computador e <Localizar...>. Em seguida, escolha o computador remoto na caixa de diálogo Selecionar Conexão de Depurador Remoto.
.png "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.
No caso de um aplicativo da Windows Store, escolha Dispositivo ou um dos emuladores da lista de Dispositivo de destino.
Escolher o depurador a ser usado
Por padrão, o depurador se anexa ao código JavaScript do aplicativo. Você pode escolher depurar o código C++ nativo e gerenciado 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. |
Nativo com script |
Depura o código C++ nativo e o código JavaScript no aplicativo. |
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 é iniciado do 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 aplicativo que você quer que ocorram quando o aplicativo não está em execução.
Especifique o código a ser atrasado para iniciar de seu 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 o aplicativo para ser executado no modo de depuração, mas inicie-o 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:
Na página Depurar das propriedades do projeto do aplicativo, escolha Não da lista Iniciar aplicativo.
Escolha Iniciar depuração no menu Depurar (Teclado: F5).
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 segundo plano para aplicativos da Windows Store no Visual Studio.
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 segundo plano para aplicativos da Windows Store no Visual Studio.
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.
No menu Depurar, escolha Depurar Pacote do Aplicativo Instalado.
Escolha uma destas opções na lista:
Computador Local
Depura o aplicativo na sessão atual no computador local. Consulte Executar aplicativos da Windows Store na máquina 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 Executar 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 Executar aplicativos da Windows Store em uma máquina remota a partir do Visual Studio.
Escolha o aplicativo na lista Pacotes do Aplicativo Instalados.
Escolha o mecanismo de depuração a ser usado na lista Depurar este tipo de código.
(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 na 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:
Defina o aplicativo para ser executado no modo de depuração. Isso deve ser feito quando o aplicativo não está em execução.
Inicie o aplicativo. Você pode iniciar o aplicativo do menu Iniciar por um contrato de execução ou por outro método.
Anexe o depurador ao aplicativo em execução.
Definir o aplicativo para ser executado no modo de depuração
Instale as Ferramentas Remotas do Visual Studio no dispositivo em que o aplicativo está instalado. Veja Instalação de Ferramentas Remotas.
No menu Iniciar, procure por Debuggable Package Manager e inicie-o.
É exibida uma janela do PowerShell corretamente configurada para o cmdlet AppxDebug.
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.
No prompt do PowerShell, digite Enable-AppxDebug PackageFullName em que o PackageFullName é o identificador PackageFullName do aplicativo.
Anexar o depurador
Dica
Os aplicativos JavaScript são executados em uma instância do processo wwahost.exe.Se outros aplicativos JavaScript estiverem em execução quando você anexa ao aplicativo, será necessário saber a ID do processo numérico (PID) do wwahost.exe em que o aplicativo está executando.
A maneira mais fácil de lidar com essa situação é fechar todos os outros aplicativos JavaScript.Do contrário, você pode abrir o Gerenciador de Tarefas do Windows antes de iniciar o aplicativo e observar as IDs dos processos wwahost.exe.Quando você especifica o processo para anexar na caixa de diálogo Processos disponíveis, o wwahost.exe do aplicativo terá uma ID diferente daquelas que você observou.
Para anexar o depurador:
No menu Depurar, escolha Anexar ao Processo.
É exibida a caixa de diálogo Anexar ao Processo.
Para anexar a um aplicativo em um dispositivo remoto, especifique o dispositivo remoto na caixa Qualificador. Você pode:
Digitar o nome na caixa Qualificador.
Escolha a seta para baixo na caixa Qualificador e escolha o dispositivo de uma lista de dispositivos que você já anexou antes.
Escolha Localizar para selecionar o dispositivo de uma lista de dispositivos na sub-rede local.
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.
Na lista de Processos disponíveis, escolha o processo wwahost.exe apropriado. Use a coluna Título para identificar seu aplicativo.
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.