Como usar o Visual Studio para implantação e depuraçãoUsing Visual Studio to deploy and debug

Se você estiver usando o DirectX ou Unity para desenvolver seu aplicativo de realidade misturada, o Visual Studio é sua ferramenta ideal para depuração e implantação.Whether you're using DirectX or Unity to develop your mixed reality app, Visual Studio is your go-to tool for debugging and deployment. Nesta seção, você aprenderá a:In this section, you will learn how to:

  • Implantar aplicativos no HoloLens ou no headset imersivo do Windows Mixed Reality por meio do Visual Studio.Deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Usar o emulador do HoloLens incorporado no Visual Studio.Use the HoloLens emulator built in to Visual Studio.
  • Depurar aplicativos de realidade misturada.Debug mixed reality apps.

Pré-requisitosPrerequisites

  1. Confira Instalar as ferramentas para obter instruções de instalação.See Install the Tools for installation instructions.
  2. Crie um projeto de aplicativo universal do Windows no Visual Studio.Create a new Universal Windows app project in Visual Studio. Para o HoloLens (1ª geração), use o Visual Studio 2017 ou mais recente.For HoloLens (1st gen), use Visual Studio 2017 or newer. Para o HoloLens 2, use o Visual Studio 2019 16.2 ou mais recente.For HoloLens 2, use Visual Studio 2019 16.2 or newer. Há suporte para C# e C++.C# and C++ are supported. (Ou siga as instruções para criar um aplicativo no Unity.)(Or follow the instructions to create an app in Unity.)

Habilitar o modo de desenvolvedorEnabling Developer Mode

Comece habilitando o Modo de Desenvolvedor no dispositivo, para que o Visual Studio possa se conectar a ele.Start by enabling Developer Mode on your device, so Visual Studio can connect to it.

HoloLensHoloLens

  1. Ligue o HoloLens e coloque o dispositivo.Turn on your HoloLens and put on the device.
  2. Use o gesto de início para iniciar o menu principal.Use the start gesture to launch the main menu.
  3. Selecione o bloco Configurações para iniciar o aplicativo no ambiente.Select the Settings tile to launch the app in your environment.
  4. Selecione item de menu Atualização.Select the Update menu item.
  5. Selecione o item de menu Para desenvolvedores.Select the For developers menu item.
  6. Habilite o Modo de Desenvolvedor para implantar aplicativos do Visual Studio em seu HoloLens.Enable Developer Mode to deploy apps from Visual Studio to your HoloLens.
  7. Opcional: Role para baixo e habilite também o Portal de Dispositivos, que permite que você se conecte ao Portal de Dispositivos do Windows no seu HoloLens de um navegador da Web.Optional: Scroll down and also enable Device Portal, which lets you connect to the Windows Device Portal on your HoloLens from a web browser.

Computador WindowsWindows PC

Se você estiver trabalhando com um headset do Windows Mixed Reality conectado ao computador, habilite o Modo de Desenvolvedor no computador.If you're working with a Windows Mixed Reality headset connected to your PC, you must enable Developer Mode on the PC.

  1. Ir para ConfiguraçõesGo to Settings
  2. Selecione Atualização e SegurançaSelect Update and Security
  3. Selecione Para desenvolvedoresSelect For developers
  4. Habilite o Modo de Desenvolvedor, leia o aviso de isenção de responsabilidade da configuração escolhida e, em seguida, selecione Sim para aceitar a alteração.Enable Developer Mode, read the disclaimer for the setting you chose, then select Yes to accept the change.

Como implantar um aplicativo via Wi-Fi – HoloLens (1ª geração)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. Selecione uma configuração de build x86 para o aplicativoSelect an x86 build configuration for your app
    Configuração de build x86 no Visual Studiox86 build configuration in Visual Studio
  2. Selecione Computador Remoto no menu suspenso do destino de implantaçãoSelect Remote Machine in the deployment target drop-down menu
    Destino de implantação de computador remoto no Visual StudioRemote machine deployment target in Visual Studio
  3. Para projetos C++ e JavaScript, acesse Projeto > Propriedades > Propriedades de Configuração > Depuração.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Para projetos C#, uma caixa de diálogo será exibida automaticamente para configurar a conexão.For C# projects, a dialog will automatically appear to configure your connection. a.a. Insira o endereço IP do dispositivo no campo Endereço ou Nome do Computador.Enter the IP address of your device in the Address or Machine Name field. Localize o endereço IP no HoloLens em Configurações > Rede e Internet > Opções Avançadas ou pergunte à Cortana "Qual é meu endereço IP?"Find the IP address on your HoloLens under Settings > Network & Internet > Advanced Options, or you can ask Cortana "What is my IP address?" b.b. Defina o Modo de Autenticação como Universal (Protocolo não criptografado)Set Authentication Mode to Universal (Unencrypted protocol)
    Caixa de diálogo de conexão remota no Visual StudioRemote connection dialog in Visual Studio
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio
  5. Na primeira vez que implantar um aplicativo no HoloLens por meio do computador, você deverá fornecer um PIN.The first time you deploy an app to your HoloLens from your PC, you'lll be prompted for a PIN. Siga as instruções de Como emparelhar o dispositivo abaixo.Follow the Pairing your device instructions below.

Como implantar um aplicativo via Wi-Fi – HoloLens 2Deploying an app over Wi-Fi - HoloLens 2

  1. Selecione uma configuração de build ARM ou ARM64 para o aplicativoSelect an ARM or ARM64 build configuration for your app
    Configuração de build ARM64 no Visual StudioARM64 build configuration in Visual Studio
  2. Selecione Computador Remoto no menu suspenso do destino de implantaçãoSelect Remote Machine in the deployment target drop-down menu
    Destino de implantação de computador remoto no Visual StudioRemote machine deployment target in Visual Studio
  3. Para projetos C++ e JavaScript, acesse Projeto > Propriedades > Propriedades de Configuração > Depuração.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Para projetos C#, uma caixa de diálogo será exibida automaticamente para configurar a conexão.For C# projects, a dialog will automatically appear to configure your connection. a.a. Insira o endereço IP do dispositivo no campo Endereço ou Nome do Computador.Enter the IP address of your device in the Address or Machine Name field. Localize o endereço IP no HoloLens em Configurações > Rede e Internet > Opções Avançadas ou pergunte à Cortana "Qual é meu endereço IP?"Find the IP address on your HoloLens under Settings > Network & Internet > Advanced Options, or you can ask Cortana "What is my IP address?" b.b. Defina o Modo de Autenticação como Universal (Protocolo não criptografado)Set the Authentication Mode to Universal (Unencrypted protocol)
    Caixa de diálogo de conexão remota no Visual StudioRemote connection dialog in Visual Studio
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio
  5. Na primeira vez que implantar um aplicativo no HoloLens por meio do computador, você deverá fornecer um PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Siga as instruções de Como emparelhar o dispositivo abaixo.Follow the Pairing your device instructions below.

Se o endereço IP do HoloLens for alterado, você poderá alterar o endereço IP do computador de destino acessando Projeto > Propriedades > Propriedades de Configuração > DepuraçãoIf your HoloLens IP address changes, you can change the IP address of the target machine by going to Project > Properties > Configuration Properties > Debugging

Como implantar um aplicativo via USB – HoloLens (1ª geração)Deploying an app over USB - HoloLens (1st gen)

  1. Selecione uma configuração de build x86 para o aplicativoSelect an x86 build configuration for your app
    Configuração de build x86 no Visual Studiox86 build configuration in Visual Studio
  2. Selecione Dispositivo no menu suspenso do destino de implantaçãoSelect Device in the deployment target drop-down menu
    Implantação de dispositivo no Visual StudioDevice deployment in Visual Studio
  3. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio
  4. Na primeira vez que implantar um aplicativo no HoloLens por meio do computador, você deverá fornecer um PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Siga as instruções de Como emparelhar o dispositivo abaixo.Follow the Pairing your device instructions below.

Como implantar um aplicativo via USB – HoloLens 2Deploying an app over USB - HoloLens 2

  1. Selecione uma configuração de build ARM ou ARM64 para o aplicativoSelect an ARM or ARM64 build configuration for your app
    Configuração de build ARM64 no Visual StudioARM64 build configuration in Visual Studio
  2. Selecione Dispositivo no menu suspenso do destino de implantaçãoSelect Device in the deployment target drop-down menu
    Implantação de dispositivo no Visual StudioDevice deployment in Visual Studio
  3. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio
  4. Na primeira vez que implantar um aplicativo no HoloLens por meio do computador, você deverá fornecer um PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Siga as instruções de Como emparelhar o dispositivo abaixo.Follow the Pairing your device instructions below.

Como implantar um aplicativo no computador local – headset imersivoDeploying an app to your Local PC - immersive headset

Para usar um headset imersivo do Windows Mixed Reality que se conecta ao computador ou o simulador de realidade misturada:To use a Windows Mixed Reality immersive headset that connects to your PC or the Mixed Reality simulator:

  1. Selecione uma configuração de build x86 ou x64 para o aplicativoSelect an x86 or x64 build configuration for your app
  2. Selecione Computador Local no menu suspenso do destino de implantaçãoSelect Local Machine in the deployment target drop-down menu
  3. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging

Como emparelhar o dispositivoPairing your device

Na primeira vez que implantar um aplicativo no HoloLens por meio do Visual Studio, você deverá fornecer um PIN.The first time you deploy an app from Visual Studio to your HoloLens, you'll be prompted for a PIN. No HoloLens, gere um PIN iniciando o aplicativo Configurações, acesse Atualizar > Para Desenvolvedores e toque em Emparelhar.On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers, and tap on Pair. Quando o PIN for exibido no seu HoloLens, digite-o no Visual Studio.When the PIN is displayed on your HoloLens, type it into Visual Studio. Após a conclusão do emparelhamento, toque em Concluído no HoloLens para ignorar a caixa de diálogo.After pairing is complete, tap Done on your HoloLens to dismiss the dialog. Este computador agora está emparelhado com o HoloLens, e você pode implantar aplicativos automaticamente.This PC is now paired with the HoloLens and you can deploy apps automatically. Repita essas etapas para todos os computadores usados para implantar aplicativos no HoloLens.Repeat these steps for every PC that's used to deploy apps to your HoloLens.

Para desemparelhar seu HoloLens de todos os computadores emparelhados:To unpair your HoloLens from all paired computers:

  • Inicie o aplicativo Configurações, acesse Atualização > Para Desenvolvedores e toque em Desmarcar.Launch the Settings app, go to Update > For Developers, and tap on Clear.

Como implantar um aplicativo no Emulador do HoloLens (1ª geração)Deploying an app to the HoloLens (1st gen) Emulator

  1. Verifique se você instalou o Emulador do HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Selecione uma configuração de build x86 para o aplicativo.Select an x86 build configuration for your app.
    Configuração de build x86 no Visual Studiox86 build configuration in Visual Studio
  3. Selecione Emulador do HoloLens no menu suspenso do destino de implantaçãoSelect HoloLens Emulator in the deployment target drop-down menu
    Destino do emulador no Visual StudioEmulator target in Visual Studio
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio

Como implantar um aplicativo no Emulador do HoloLens 2Deploying an app to the HoloLens 2 Emulator

  1. Verifique se você instalou o Emulador do HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Selecione uma configuração de build x86 ou x64 para o aplicativo.Select an x86 or x64 build configuration for your app.
    Configuração de build x86 no Visual Studiox86 build configuration in Visual Studio
  3. Selecione Emulador do HoloLens 2 no menu suspenso do destino de implantaçãoSelect HoloLens 2 Emulator in the deployment target drop-down menu
    Destino do emulador no Visual StudioEmulator target in Visual Studio
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuraçãoSelect Debug > Start debugging to deploy your app and start debugging
    Iniciar sem Depuração no Visual StudioStart Without Debugging in Visual Studio

Depurador de Gráficos do HoloLens (1ª geração)Graphics Debugger for HoloLens (1st gen)

As ferramentas Diagnóstico de Gráficos do Visual Studio são úteis quando você quer escrever e otimizar um aplicativo holográfico.The Visual Studio Graphics Diagnostics tools are helpful when writing and optimizing a Holographic app. Confira Diagnóstico de Gráficos do Visual Studio no MSDN para obter detalhes completos.See Visual Studio Graphics Diagnostics on MSDN for full details.

Para iniciar o Depurador de GráficosTo Start the Graphics Debugger

  1. Siga as instruções acima para definir um dispositivo ou um emulador como destinoFollow the instructions above to target a device or emulator
  2. Acesse Depurar > Gráficos > Iniciar DiagnósticoGo to Debug > Graphics > Start Diagnostics
  3. Na primeira vez que você iniciar o diagnóstico com um HoloLens, talvez você receba um erro de "acesso negado".The first time you start diagnostics with a HoloLens, you may get an "access denied" error. Reinicialize o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.Reboot your HoloLens to let the updated permissions take effect and try again.

Criação de perfilProfiling

As ferramentas de criação de perfil do Visual Studio permitem que você analise o desempenho e o uso de recursos do seu aplicativo.The Visual Studio profiling tools allow you to analyze your app's performance and resource use. Isso inclui ferramentas para otimizar a CPU, a memória, os elementos gráficos e o uso da rede.This includes tools to optimize CPU, memory, graphics, and network use. Confira Executar ferramentas de diagnóstico sem depuração no MSDN para obter detalhes completos.See Run diagnostic tools without debugging on MSDN for full details.

Para iniciar as ferramentas de criação de perfil com o HoloLensTo Start the Profiling Tools with HoloLens

  1. Siga as instruções acima para definir um dispositivo ou um emulador como destinoFollow the instructions above to target a device or emulator
  2. Acesse Depurar > Iniciar Ferramentas de Diagnóstico sem Depuração...Go to Debug > Start Diagnostic Tools Without Debugging...
  3. Selecione as ferramentas que deseja usarSelect the tools you want to use
  4. Selecione IniciarSelect Start
  5. Na primeira vez que você iniciar o diagnóstico sem fazer a depuração com um HoloLens, talvez você receba um erro de "acesso negado".The first time you start diagnostics without debugging with a HoloLens, you may get an "access denied" error. Reinicialize o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.Reboot your HoloLens to let the updated permissions take effect and try again.

Como depurar um aplicativo instalado ou em execuçãoDebugging an installed or running app

Use o Visual Studio para depurar um aplicativo universal do Windows instalado sem a implantação por meio de um projeto do Visual Studio.You can use Visual Studio to debug an installed Universal Windows app without deploying from a Visual Studio project. Isso será útil se você quiser depurar um pacote do aplicativo instalado ou um aplicativo que já esteja em execução.This is useful if you want to debug an installed app package or debug an app that's already running.

  1. Acesse Depurar -> Outros Destinos de Depuração-> Depurar Pacote do Aplicativo InstaladoGo to Debug -> Other Debug Targets -> Debug Installed App Package
  2. Selecione o destino Computador Remoto para o HoloLens ou Computador Local para headsets imersivos.Select the Remote Machine target for HoloLens or Local Machine for immersive headsets.
  3. Insira o endereço IP do dispositivoEnter your device’s IP address
  4. Escolha o Modo de Autenticação UniversalChoose the Universal Authentication Mode
  5. A janela mostrará os aplicativos em execução e inativos.The window shows both running and inactive apps. Escolha aquele que deseja depurar.Pick the one what you’d like to debug.
  6. Escolha o tipo de código para depuração (Gerenciado, Nativo, Misto)Choose the type of code to debug (Managed, Native, Mixed)
  7. Selecione Anexar ou IniciarSelect Attach or Start

Próximo ponto de verificação de desenvolvimentoNext Development Checkpoint

Se você está seguindo o percurso do ponto de verificação de desenvolvimento do Unity, você está no meio do estágio de implantação.If you're following the Unity development checkpoint journey we've laid out, you're in the midst of the deployment stage. Deste ponto, você pode prosseguir para o próximo tópico:From here, you can continue to the next topic:

Ou vá diretamente para a adição de serviços avançados:Or jump directly to adding advanced services:

Você sempre pode voltar para os pontos de verificação de desenvolvimento do Unity a qualquer momento.You can always go back to the Unity development checkpoints at any time.

Veja tambémSee also