Como usar o Visual Studio para implantação e depuração

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. Nesta seção, você aprenderá a:

  • Implantar aplicativos no HoloLens ou no headset imersivo do Windows Mixed Reality por meio do Visual Studio.
  • Usar o emulador do HoloLens incorporado no Visual Studio.
  • Depurar aplicativos de realidade misturada.

Pré-requisitos

  1. Confira Instalar as ferramentas para obter instruções de instalação.
  2. Crie um projeto de realidade misturada no Unity ou no Visual Studio.

Habilitar o modo de desenvolvedor

Comece habilitando o Modo de Desenvolvedor no dispositivo, para que o Visual Studio possa se conectar a ele.

Modo de desenvolvedor no HoloLens

  1. Ligue o HoloLens e coloque o dispositivo.
  2. Use o gesto de início para iniciar o menu principal.
  3. Selecione o bloco Configurações para iniciar o aplicativo no ambiente.
  4. Selecione item de menu Atualização.
  5. Selecione o item de menu Para desenvolvedores.
  6. Habilite o Usar os recursos de desenvolvedor para implantar aplicativos do Visual Studio em seu HoloLens. Se o dispositivo estiver executando Windows Holographic versão 21H1 ou mais recente, habilite também a Descoberta de dispositivo.
  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.

Modo de desenvolvedor em um PC Windows

Se você estiver trabalhando com um headset do Windows Mixed Reality conectado ao computador, habilite o Modo de Desenvolvedor no computador.

  1. Vá para Configurações.
  2. Selecione Atualização e Segurança.
  3. Selecione Para desenvolvedores.
  4. Habilite o Modo de Desenvolvedor, leia o aviso de isenção de responsabilidade da configuração escolhida e selecione Sim para aceitar a alteração.

Como implantar um aplicativo HoloLens via Wi-Fi ou USB

Opções de compilação

  1. Abra o projeto no Visual Studio

  2. Clique no menu suspenso Opções de Compilação e siga um dos seguintes procedimentos:

    • Para projetos do Unity, escolha Versão ou Mestre
    • Para todos os outros projetos, escolha Versão

    Screen shot showing compilation options in Visual Studio

    Veja abaixo as definições para as opções de compilação:

Configuração Explicação
Depurar Todas as otimizações estão desativadas e o criador de perfil está habilitado. Usado para depurar scripts.
Principal Todas as otimizações estão ativadas e o criador de perfil está desabilitado. Usado para enviar aplicativos para a Store.
Versão Todas as otimizações estão ativadas e o criador de perfil está habilitado. Usado para avaliar o desempenho do aplicativo.

Configuração de compilação

  1. Selecione a configuração de build com base no seu dispositivo.

    Escolha a opção de configuração ARM ou ARM64

    ARM64 build configuration in Visual Studio

    Para saber mais sobre as configurações de build, confira a tabela "Tipos de configurações de build" na documentação do Unity.

    Observação

    Para o HoloLens, você normalmente fará a criação para a arquitetura ARM. No entanto, há um problema conhecido no Unity 2019.3 que causa erros ao selecionar o ARM como a arquitetura de build no Visual Studio. A solução alternativa recomendada é criar para o ARM64. Se essa não for uma opção, em um projeto do Unity, siga esta etapa antes de gerar seu build do Unity: acesse Editar>Configurações do Projeto>Player>Outras Configurações e desabilite os Trabalhos Gráficos.

    Se o Dispositivo não for exibido como uma opção de destino, talvez seja necessário alterar o projeto de inicialização para a solução do Visual Studio do projeto IL2CPP para o projeto UWP. Para fazer isso, no Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Definir como Projeto de Inicialização.

  2. Clique na lista suspensa destino de implantação e siga um dos seguintes procedimentos:

    • Se você estiver criando e implantando por meio do Wi-Fi, selecione Computador Remoto.

    Select

    • Se você estiver criando e implantando por meio do USB, selecione Dispositivo.

    Select

Conexão remota

Para definir sua conexão remota:

  1. Na barra de menus, selecione Projeto > Propriedades > Propriedades de Configuração > Depuração.

    Observação

    Em um projeto C#, uma caixa de diálogo deverá aparecer automaticamente.

  2. Clique no menu suspenso Depurador para iniciar e selecione Computador Remoto.

  3. No campo Nome do Computador, insira o endereço IP do seu dispositivo.

    Remote connection dialog in Visual Studio

    • Você pode encontrar o endereço IP no HoloLens em Configurações > Rede e Internet > Opções Avançadas.

    • É recomendável inserir manualmente seu endereço IP em vez de depender do recurso "Detectado Automaticamente".

  4. Defina o Modo de Autenticação como Universal (protocolo não criptografado).

  5. Crie, implante e depure o aplicativo com base nas suas necessidades:

    • Para criar, implantar e iniciar a depuração, selecione Depurar > Iniciar depuração.

    • Para criar e implantar sem depuração, selecione Criar > Implantar Solução.

  6. Na primeira vez que implantar um aplicativo no HoloLens por meio do computador, você deverá fornecer um PIN. Siga as instruções de Como emparelhar o dispositivo abaixo.

Como implantar um aplicativo no Emulador do HoloLens (1ª geração)

  1. Verifique se você instalou o Emulador do HoloLens .
  2. Selecione uma configuração de build x86 para o aplicativo. Select an x86 build configuration in Visual Studio
  3. Selecione Emulador do HoloLens no menu suspenso do destino de implantação
    Emulator target in Visual Studio
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuração
    Start Without Debugging in Visual Studio

Como implantar um aplicativo no Emulador do HoloLens 2

  1. Verifique se você instalou o Emulador do HoloLens .
  2. Selecione uma configuração de build x86 ou x64 para o aplicativo.
    x86 build setting configuration in Visual Studio
  3. Selecione Emulador do HoloLens 2 no menu suspenso do destino de implantação
    Emulator target in Visual Studio application
  4. Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuração
    Start Without Debugging in Visual Studio

Como implantar um aplicativo de VR no seu computador local

Para usar um headset imersivo do Windows Mixed Reality que se conecta ao computador ou o simulador de realidade misturada:

  1. Selecione uma configuração de build x86 ou x64 para o aplicativo
  2. Selecione Computador Local no menu suspenso do destino de implantação
  3. Compile, implante e depure o aplicativo com base em suas necessidades
    • Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuração
    • Selecione Compilar > Implantar para compilar e implantar sem depuração

Como emparelhar o dispositivo

Na primeira vez que implantar um aplicativo no HoloLens por meio do Visual Studio, você deverá fornecer um PIN. No HoloLens, gere um PIN iniciando o aplicativo Configurações, acesse Atualizar > Para Desenvolvedores e toque em Emparelhar. Quando o PIN for exibido no seu HoloLens, digite-o no Visual Studio. Após a conclusão do emparelhamento, toque em Concluído no HoloLens para ignorar a caixa de diálogo. Este computador agora está emparelhado com o HoloLens, e você pode implantar aplicativos automaticamente. Repita essas etapas para todos os computadores usados para implantar aplicativos no HoloLens.

Para desemparelhar seu HoloLens de todos os computadores emparelhados:

  • Inicie o aplicativo Configurações, acesse Atualização > Para Desenvolvedores e toque em Limpar.

Depurador de Gráficos do HoloLens (1ª geração)

As ferramentas Diagnóstico de Gráficos do Visual Studio são úteis quando você quer escrever e otimizar um aplicativo holográfico. Confira Diagnóstico de Gráficos do Visual Studio no MSDN para obter detalhes completos.

Para iniciar o Depurador de Gráficos

  1. Siga as instruções acima para definir um dispositivo ou um emulador como destino
  2. Acesse Depurar > Gráficos > Iniciar Diagnóstico
  3. Na primeira vez que você iniciar o diagnóstico com um HoloLens, talvez você receba um erro de "acesso negado". Reinicialize o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.

Criação de perfil

As ferramentas de criação de perfil do Visual Studio permitem que você analise o desempenho e o uso de recursos do seu aplicativo. Isso inclui ferramentas para otimizar a CPU, a memória, os elementos gráficos e o uso da rede. Confira Executar ferramentas de diagnóstico sem depuração no MSDN para obter detalhes completos.

Para iniciar as ferramentas de criação de perfil com o HoloLens

  1. Siga as instruções acima para definir um dispositivo ou um emulador como destino
  2. Acesse Depurar > Iniciar Ferramentas de Diagnóstico sem Depuração...
  3. Selecione as ferramentas que deseja usar
  4. Selecione Iniciar
  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". Reinicialize o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.

Como depurar um aplicativo instalado ou em execução

Use o Visual Studio para depurar um aplicativo universal do Windows instalado sem a implantação por meio de um projeto do Visual Studio. Isso será útil se você quiser depurar um pacote do aplicativo instalado ou um aplicativo que já esteja em execução.

  1. Acesse Depurar -> Outros Destinos de Depuração -> Depurar Pacote do Aplicativo Instalado
  2. Selecione o destino Computador Remoto para o HoloLens ou Computador Local para headsets imersivos.
  3. Insira o endereço IP do dispositivo
  4. Escolha o Modo de Autenticação Universal
  5. A janela mostrará os aplicativos em execução e inativos. Escolha aquele que deseja depurar.
  6. Escolha o tipo de código para depuração (Gerenciado, Nativo, Misto)
  7. Selecione Anexar ou Iniciar

Próximo ponto de verificação de desenvolvimento

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. Deste ponto, você pode prosseguir para o próximo tópico:

Ou vá diretamente para a adição de serviços avançados:

Você sempre pode voltar para os pontos de verificação de desenvolvimento do Unity a qualquer momento.

Veja também