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
- Confira Instalar as ferramentas para obter instruções de instalação.
- Crie um projeto de realidade misturada no Unity ou no Visual Studio.
- Crie seu projeto do Unity de acordo com nossas instruções
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
- Ligue o HoloLens e coloque o dispositivo.
- Use o gesto de início para iniciar o menu principal.
- Selecione o bloco Configurações para iniciar o aplicativo no ambiente.
- Selecione item de menu Atualização.
- Selecione o item de menu Para desenvolvedores.
- 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.
- 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.
- Vá para Configurações.
- Selecione Atualização e Segurança.
- Selecione Para desenvolvedores.
- 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
Abra o projeto no Visual Studio
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
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
Selecione a configuração de build com base no seu dispositivo.
Escolha a opção de configuração ARM ou ARM64
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 implantação no dispositivo HoloLens 2, escolha a arquitetura ARM64 ou ARM.
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.
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.
- Se você estiver criando e implantando por meio do USB, selecione Dispositivo.
Conexão remota
Para definir sua conexão remota:
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.
Clique no menu suspenso Depurador para iniciar e selecione Computador Remoto.
No campo Nome do Computador, insira o endereço IP do seu dispositivo.
Você pode encontrar o endereço IP em seu HoloLens em Configurações Rede & Opções Avançadas > da Internet>.
É recomendável inserir manualmente seu endereço IP em vez de depender do recurso "Detectado Automaticamente".
Defina o Modo de Autenticação como Universal (protocolo não criptografado).
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.
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.
Observação
Se os erros listados abaixo ocorrerem quando você começar a depurar um aplicativo UWP instalado no HoloLens 2, tente renomear seu pacote ou desinstalar seu aplicativo UWP.
"Não foi possível iniciar a depuração"
"Não há suporte para a operação. Erro desconhecido: 0x80070057"
Como implantar um aplicativo no Emulador do HoloLens (1ª geração)
- Verifique se você instalou o Emulador do HoloLens .
- Selecione uma configuração de build x86 para o aplicativo.
- Selecione Emulador do HoloLens no menu suspenso do destino de implantação
- Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuração
Como implantar um aplicativo no Emulador do HoloLens 2
- Verifique se você instalou o Emulador do HoloLens .
- Selecione uma configuração de build x86 ou x64 para o aplicativo.
- Selecione Emulador do HoloLens 2 no menu suspenso do destino de implantação
- Selecione Depurar > Iniciar depuração para implantar o aplicativo e iniciar a depuração
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:
- Selecione uma configuração de build x86 ou x64 para o aplicativo
- Selecione Computador Local no menu suspenso do destino de implantação
- 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
- Siga as instruções acima para definir um dispositivo ou um emulador como destino
- Acesse Depurar > Gráficos > Iniciar Diagnóstico
- 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
- Siga as instruções acima para definir um dispositivo ou um emulador como destino
- Acesse Depurar > Iniciar Ferramentas de Diagnóstico sem Depuração...
- Selecione as ferramentas que deseja usar
- Selecione Iniciar
- 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.
- Acesse Depurar -> Outros Destinos de Depuração -> Depurar Pacote do Aplicativo Instalado
- Selecione o destino Computador Remoto para o HoloLens ou Computador Local para headsets imersivos.
- Insira o endereço IP do dispositivo
- Escolha o Modo de Autenticação Universal
- A janela mostrará os aplicativos em execução e inativos. Escolha aquele que deseja depurar.
- Escolha o tipo de código para depuração (Gerenciado, Nativo, Misto)
- 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.