Depurar um pacote de aplicativo UWP instalado no Visual StudioDebug an installed UWP app package in Visual Studio

O Visual Studio pode depurar pacotes de aplicativos UWP (Plataforma Universal do Windows instalados) em computadores com Windows 10 e dispositivos Xbox, HoloLens e IoT.Visual Studio can debug installed Universal Windows Platform (UWP) app packages on Windows 10 computers and Xbox, HoloLens, and IoT devices.

Observação

A depuração do Visual Studio para aplicativos UWP instalados não tem suporte em telefones.Visual Studio debugging for installed UWP apps is not supported on phones.

Para obter mais informações sobre como depurar aplicativos UWP, consulte as postagens no blog sobre depuração de pacotes de aplicativos instalados e criação de aplicativos universais do Windows (UWP).For more information about debugging UWP apps, see the blog posts on debugging installed app packages and building Universal Windows Apps (UWP).

Depurar um aplicativo UWP instalado em um computador localDebug an installed UWP app on a local machine

  1. No Visual Studio, selecione depurar > outros destinos de depuração > depurar pacote do aplicativo instalado.In Visual Studio, select Debug > Other Debug Targets > Debug Installed App Package.

  2. Na caixa de diálogo depurar pacote do aplicativo instalado , em tipo de conexão, selecione computador local.In the Debug Installed App Package dialog, under Connection Type, select Local Machine.

  3. Em pacotes de aplicativos instalados, selecione o aplicativo que você deseja depurar ou digite seu nome na caixa de pesquisa.Under Installed App Packages, select the app you want to debug, or type its name in the search box. Os pacotes de aplicativos instalados sem execução aparecem em não em execução e os aplicativos em execução estão em execução.Non-running installed app packages appear under Not running, and running apps are under Running.

    DebugInstalledAppPackageDebugInstalledAppPackage

  4. Se necessário, altere o tipo de código em depurar este tipo de código e selecione outras opções.If necessary, change the code type under Debug this code type, and select other options.

    • Selecione não Iniciar, mas depurar meu código quando começar a iniciar a depuração quando o aplicativo for iniciado.Select Do not launch, but debug my code when it starts to start debugging when the app starts. Iniciar a depuração quando o aplicativo é iniciado é uma maneira eficaz de depurar caminhos de controle de diferentes métodos de inicialização, como a ativação de protocolo com parâmetros personalizados.Starting debugging when the app launches is an effective way to debug control paths from different launch methods, such as protocol activation with custom parameters.
  5. Selecione Iniciar ou, se o aplicativo estiver em execução, selecione anexar.Select Start, or if the app is running, select Attach.

Observação

Você também pode se conectar a qualquer UWP em execução ou a outro processo de aplicativo selecionando a depuração > anexar para processar no Visual Studio.You can also attach to any running UWP or other app process by selecting Debug > Attach to Process in Visual Studio. Você não precisa do projeto original do Visual Studio para anexar a um processo em execução, mas carregar os símbolos do aplicativo ajudará significativamente ao depurar um processo para o qual você não tenha o código original.You don't need the original Visual Studio project to attach to a running process, but loading the app's symbols will help significantly when debugging a process that you don't have the original code for. Consulte especificar o símbolo e os arquivos de origem no depurador.See Specify symbol and source files in the debugger.

Depurar um aplicativo UWP instalado em um computador ou dispositivo remotoDebug an installed UWP app on a remote computer or device

Na primeira vez que o Visual Studio decorre bugs em um aplicativo UWP instalado em um dispositivo Windows 10 ou em um computador com o Windows 10 do post-Creator remoto, ele instala as ferramentas de depuração remota no dispositivo de destino.The first time Visual Studio debugs an installed UWP app on a Windows 10 device or a remote post-Creator's Update Windows 10 computer, it installs the remote debugging tools on the target device.

  1. Habilite o modo de desenvolvedor no computador do Visual Studio e no computador ou dispositivo remoto.Enable developer mode on the Visual Studio computer and the remote device or computer.

  2. Se você estiver se conectando a um computador remoto executando o Windows 10 do pre-Creator, Instale e inicie manualmente o depurador remoto no computador remoto.If you are connecting to a remote computer running pre-Creator's Update Windows 10, manually install and start the remote debugger on the remote computer.

  3. No computador do Visual Studio, selecione depurar > outros destinos de depuração > depurar pacote do aplicativo instalado.On the Visual Studio computer, select Debug > Other Debug Targets > Debug Installed App Package.

  4. Na caixa de diálogo depurar pacote do aplicativo instalado , em tipo de conexão, selecione computador remoto ou dispositivo.In the Debug Installed App Package dialog, under Connection Type, select Remote Machine or Device.

    Se você selecionar dispositivo, seu computador deverá estar fisicamente conectado a um dispositivo Windows 10.If you select Device, your computer must be physically connected to a Windows 10 device.

    Para um computador remoto, se o endereço do computador não aparecer ao lado de endereço, selecione alterar.For a remote machine, if the computer address doesn't appear next to Address, select Change.

    1. Na caixa de diálogo conexão remota , ao lado de endereço, digite o nome ou o endereço IP do computador ao qual você deseja se conectar.In the Remote Connection dialog box, next to Address, type the name or IP address of the computer you want to connect to.

      ChooseRemoteComputerChooseRemoteComputer

      Se o depurador não puder se conectar a um computador remoto usando o nome do computador, use o endereço IP em vez disso.If the debugger can't connect to a remote computer using the computer name, use the IP address instead. Use o endereço IP para dispositivos Xbox, HoloLens ou IoT.Use the IP address for Xbox, HoloLens, or IoT devices.

    2. Selecione uma opção de autenticação ao lado do modo de autenticação.Select an authentication option next to Authentication Mode.

      Para a maioria dos aplicativos, mantenha o valor padrão, Universal (protocolo não criptografado).For most apps, keep the default value, Universal (Unencrypted Protocol).

    3. Selecione Selecionar.Select Select.

  5. Em pacotes de aplicativos instalados, selecione o aplicativo que você deseja depurar ou digite seu nome na caixa de pesquisa.Under Installed App Packages, select the app you want to debug, or type its name in the search box. Os pacotes de aplicativos instalados sem execução aparecem em não em execução e os aplicativos em execução estão em execução.Non-running installed app packages appear under Not running, and running apps are under Running.

  6. Se necessário, altere o tipo de código em depurar este tipo de código e selecione outras opções.If necessary, change the code type under Debug this code type, and select other options.

    • Selecione não Iniciar, mas depurar meu código quando começar a iniciar a depuração quando o aplicativo for iniciado.Select Do not launch, but debug my code when it starts to start debugging when the app starts. Iniciar a depuração quando o aplicativo é iniciado é uma maneira eficaz de depurar caminhos de controle de diferentes métodos de inicialização, como a ativação de protocolo com parâmetros personalizados.Starting debugging when the app launches is an effective way to debug control paths from different launch methods, such as protocol activation with custom parameters.
  7. Selecione Iniciar ou, se o aplicativo estiver em execução, selecione anexar.Select Start, or if the app is running, select Attach.

Quando você inicia a depuração de um pacote do aplicativo instalado em um dispositivo Xbox, HoloLens ou IoT conectado pela primeira vez, o Visual Studio instala a versão correta do depurador remoto para seu dispositivo de destino.When you start debugging an installed app package on a connected Xbox, HoloLens, or IoT device for the first time, Visual Studio installs the correct version of the remote debugger for your target device. A instalação do depurador remoto pode levar algum tempo e a mensagem iniciando o depurador remoto é exibida enquanto ele está acontecendo.Installing the remote debugger may take some time, and the message Starting remote debugger displays while it is happening.

Observação

Atualmente, um dispositivo Xbox ou HoloLens reinicia o aplicativo com o depurador anexado se ele já estava em execução.Currently, an Xbox or HoloLens device restarts the app with the debugger attached if it was already running.

Para obter mais informações sobre a implantação remota de aplicativos UWP, consulte implantar e depurar aplicativos UWP e depurar aplicativos UWP em computadores remotos.For more information on remote deployment of UWP apps, see Deploy and debug UWP apps and Debug UWP apps on remote machines.

Consulte tambémSee also