Como iniciar uma sessão de depuração (Visual C++, visual C# e Visual Basic)

Este tópico descreve como iniciar uma sessão de depuração para os aplicativos Windows Store do Windows 8 escritos em Visual C++, Visual C# ou Visual Basic. Depurar um aplicativo envolve configurar a sessão de depuração e escolher a maneira de iniciar o aplicativo.

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 da sessão de depuração

• (Opcional) Desabilitar loopbacks de rede

• (Opcional) Reinstalar o aplicativo ao iniciar a depuração

• (Opcional) Desativar a requisição de autenticação para iniciar o depurador remoto

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

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: Navegação do depurador (Xaml e C#).

Configurar a sessão de depuraçã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. Faça isso para abrir a página de propriedades de depuração do projeto:

   • Para aplicativos em Visual C# e Visual Basic, escolha Depurar.

     

   • Para aplicativos em Visual C++, 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 (Todas as Plataformas no Visual C++) é 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 dispositivo remoto.

• Para aplicativos do C# e Visual Basic, escolha o destino na lista Dispositivo de destino na página de propriedades Depurar do projeto.

• Para aplicativos do C++, escolha o destino na lista Depurador a iniciar na página de propriedades Depuração:

Escolha uma destas opções:

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.

  • Para aplicativos em C# e Visual Basic, digite o nome ou endereço IP na caixa Máquina remota.

  • Para aplicativos em C++, digite o nome ou endereço IP na caixa Nome do Computador.

• Escolha o computador remoto na caixa de diálogo Selecionar Conexão de Depurador Remoto.

  Para abrir a caixa de diálogo:

  • Para aplicativos em C# e Visual Basic, escolha Localizar.

  • Para aplicativos em C++, clique na seta para baixo da caixa Nome do Computador e escolha <Localizar...>.

  

  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 Visual Studio depura o código gerenciado nos aplicativos em C# e Visual Basic.

Para aplicativos em C# e Visual Basic, você pode optar por depurar o código gerenciado e o código C/C++ nativo. Marque a caixa de seleção Habilitar depuração de código não gerenciado para incluir o código nativo na sessão de depuração.

Por padrão, o Visual Studio depura o código nativo no aplicativo em C++.

Para aplicativos em C++, você pode optar por depurar tipos específicos de código que estão em componentes do aplicativo em vez do código nativo ou além dele. 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.
Somente GPU	O código nativo C++ de depuração que é executado em uma unidade de processamento gráfico (GPU) em uma placa gráfica distinta.

(Opcional) Atrasar o início da 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. Quando você escolhe essa opção, o aplicativo é iniciado no depurador quando é executado na tela inicial ou por um contrato de ativação ou quando é iniciado por outro processo ou método. Você também atrasa o início do aplicativo quando deseja depurar uma tarefa em segundo plano quando o aplicativo em si não está em execução.

Para atrasar a inicialização do aplicativo, você pode fazer o seguinte:

• Para aplicativos do Visual C# e Visual Basic, selecione Não iniciar, mas sim depurar meu código quando iniciar na página de propriedades Depurar.

• Para aplicativos do Visual C++, escolha Sim na lista Iniciar Aplicativo na página de propriedades Depuração.

(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:

• Para aplicativos do Visual C# e Visual Basic, desmarque a caixa de seleção Permitir Loopback de Rede na página de propriedades Depurar.

• Para aplicativos do Visual C++, escolha Não na lista Permitir Loopback de Rede na página de propriedades Depuração.

(Opcional) Reinstalar o aplicativo ao iniciar a depuração

Para diagnosticar problemas com a instalação e configuração inicial do seu aplicativo do Visual C# ou Visual Basic, escolha Desinstalar e reinstalar meu pacote na página de propriedades Depurar para recriar uma instalação original ao iniciar a depuração. Essa opção não está disponível para projetos do Visual C++.

(Opcional) Desativar a requisição de autenticação para iniciar o depurador remoto

Por padrão, você deve fornecer credenciais para executar o depurador remoto.

Observação de segurança
Você também pode optar por executar o depurador remoto no Modo Sem Autenticação, mas isso é altamente desaconselhável. Nesse modo não há nenhuma segurança de rede. Escolha o Modo Sem Autenticação somente se você tiver certeza de que a rede não corre risco de tráfego mal-intencionado ou hostil.

Para remover a requisição de autenticação:

1. Para aplicativos Visual C# e Visual Basic, desmarque a caixa de seleção Usar Autenticação na página de propriedades Depurar.

2. Para aplicativos Visual C++, escolha Não na lista Requer Autenticação 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 (teclado: F5) no menu Depurar, 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 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 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 de propriedades Depuração do aplicativo (Depurar em Visual C++):

  • Para aplicativos em Visual C# e Visual Basic, escolha Não iniciar, mas depurar meu código quando ele começar.

  • Para aplicativos em Visual C++, escolha Sim na 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 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 o depurador a um aplicativo, são necessárias as seguintes etapas:

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 pela tela inicial, 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 Instalando as ferramentas remotas.

2. Na tela inicial, 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

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 do 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

Depurando aplicativos da Windows Store

Guia de início rápido: Navegação do depurador (Xaml e C#)