Utilizar o Visual Studio para implementar e depurar
Quer esteja a utilizar o DirectX ou o Unity para desenvolver a sua aplicação de realidade mista, o Visual Studio é a sua ferramenta de depuração e implementação. Nesta secção, irá aprender a:
- Implemente aplicações no HoloLens ou Windows Mixed Reality headset envolvente através do Visual Studio.
- Utilize o emulador do HoloLens incorporado no Visual Studio.
- Depurar aplicações de realidade mista.
Pré-requisitos
- Consulte Instalar as Ferramentas para obter instruções de instalação.
- Crie um novo projeto de realidade mista no Unity ou no Visual Studio.
- Crie o seu projeto do Unity de acordo com as nossas instruções
Ativar o Modo de Programador
Comece por ativar o Modo de Programador no seu dispositivo para que o Visual Studio se possa ligar ao mesmo.
Modo de programador no HoloLens
- Ligue o HoloLens e coloque o dispositivo.
- Utilize o gesto iniciar para iniciar o menu principal.
- Selecione o mosaico Definições para iniciar a aplicação no seu ambiente.
- Selecione o item de menu Atualizar .
- Selecione o item de menu Para programadores .
- Ative Utilizar funcionalidades de programador para implementar aplicações do Visual Studio no HoloLens. Se o seu dispositivo estiver a executar a versão 21H1 ou mais recente do Windows Holographic, ative também a Deteção de dispositivos.
- Opcional: desloque-se para baixo e ative também o Portal do Dispositivo, que lhe permite ligar ao Portal do Dispositivo Windows no HoloLens a partir de um browser.
Modo de programador num PC Windows
Se estiver a trabalhar com um headset Windows Mixed Reality ligado ao PC, tem de ativar o Modo de Programador no PC.
- Aceda a Definições.
- Selecione Atualização e Segurança.
- Selecione Para programadores.
- Ative o Modo de Programador, leia a exclusão de responsabilidade da definição que escolheu e, em seguida, selecione Sim para aceitar a alteração.
Implementar uma aplicação HoloLens através de Wi-Fi ou USB
Opções de compilação
Abrir o projeto no Visual Studio
Clique no menu pendente Opções de Compilação e, em seguida, efetue um dos seguintes procedimentos:
- Para projetos do Unity, escolha Versão ou Modelo Global
- Para todos os outros projetos, selecione Versão
Seguem-se definições para as opções de compilação:
| Configuração | Explicação |
|---|---|
| Depurar | Todas as otimizações estão desativadas e o gerador de perfis está ativado. Utilizado para depurar scripts. |
| Principal | Todas as otimizações estão ativadas e o gerador de perfis está desativado. Utilizado para submeter aplicações para a Loja. |
| Libertar | Todas as otimizações estão ativadas e o gerador de perfis está ativado. Utilizado para avaliar o desempenho da aplicação. |
Compilar a configuração
Selecione a configuração de compilação com base no seu dispositivo.
Escolha a opção de configuração ARM ou ARM64
Para saber mais sobre as configurações de compilação, veja a tabela "Types of build configurations" (Tipos de configurações de compilação) na documentação do Unity.
Nota
Para a implementação no dispositivo HoloLens 2, selecione o ARM64 ou a arquitetura do ARM.
Se não vir a opção Dispositivo como destino, poderá ter de alterar o projeto de arranque da solução visual Studio do projeto IL2CPP para o projeto UWP. Para tal, na Explorador de Soluções, clique com o botão direito do rato no projeto e, em seguida, selecione Definir como Projeto de Arranque.
Clique no menu pendente de destino de implementação e, em seguida, efetue um dos seguintes procedimentos:
- Se estiver a criar e a implementar através de Wi-Fi, selecione Máquina Remota.
- Se estiver a criar e implementar através de USB, selecione Dispositivo.
Ligação remota
Para definir a ligação remota:
Na barra de menus, selecione Depuração de Propriedades de Configuração das Propriedades >> do Projeto>.
Nota
Para um projeto C#, deverá ser apresentada automaticamente uma caixa de diálogo.
Clique no menu pendente Depurador para iniciar e, em seguida, selecione Máquina Remota.
No campo Nome do Computador , introduza o endereço IP do seu dispositivo.
Pode encontrar o endereço IP no HoloLens em Definições > Rede & Opções Avançadas da Internet>.
Recomendamos que introduza manualmente o seu endereço IP em vez de depender da funcionalidade "Detetado Automaticamente".
Defina o Modo de Autenticação como Universal (Protocolo não encriptado).
Crie, implemente e depure a sua aplicação com base nas suas necessidades:
Para criar, implementar e iniciar a depuração, selecione Depurar > Iniciar depuração.
Para criar e implementar sem depuração, selecione Criar > Solução de Implementação.
Quando implementar uma aplicação no HoloLens a partir do PC pela primeira vez, ser-lhe-á pedido um PIN. Siga as instruções de Emparelhamento do dispositivo abaixo.
Nota
Se os erros listados abaixo ocorrerem quando começar a depurar uma aplicação UWP instalada no HoloLens 2, experimente mudar o nome do pacote ou desinstalar a aplicação UWP.
"Não é possível iniciar a depuração"
"Operação não suportada. Erro desconhecido: 0x80070057"
Implementar uma aplicação no Emulador do HoloLens (1.ª geração)
- Certifique-se de que instalou o Emulador do HoloLens.
- Selecione uma configuração de compilação x86 para a sua aplicação.
- Selecione HoloLens Emulator no menu
pendente destino de implementação Destino do
- Selecione Depurar > Iniciar depuração para implementar a sua aplicação e começar a depurar
Implementar uma aplicação no Emulador do HoloLens 2
- Certifique-se de que instalou o Emulador do HoloLens.
- Selecione uma configuração de compilação x86 ou x64 para a sua aplicação.
- Selecione HoloLens 2 Emulador no menu
pendente Destino do emulador de destino de implementação
- Selecione Depurar > Iniciar depuração para implementar a sua aplicação e começar a depurar
Implementar uma aplicação VR no seu PC Local
Para utilizar um headset Windows Mixed Reality envolvente que se liga ao PC ou ao simulador de Mixed Reality:
- Selecionar uma configuração de compilação x86 ou x64 para a sua aplicação
- Selecione Máquina Local no menu pendente de destino de implementação
- Criar, implementar e depurar a sua aplicação com base nas suas necessidades
- Selecione Depurar > Iniciar depuração para implementar a sua aplicação e iniciar a depuração
- Selecione Compilar > Implementar para compilar e implementar sem depuração
Emparelhar o seu dispositivo
Quando implementar uma aplicação do Visual Studio no HoloLens pela primeira vez, ser-lhe-á pedido um PIN. No HoloLens, gere um PIN ao iniciar a aplicação Definições, aceda a Atualizar > para Programadores e toque em Emparelhar. Quando o PIN for apresentado no HoloLens, escreva-o no Visual Studio. Após a conclusão do emparelhamento, toque em Concluído no HoloLens para dispensar a caixa de diálogo. Este PC está agora emparelhado com o HoloLens e pode implementar aplicações automaticamente. Repita estes passos para cada PC utilizado para implementar aplicações no HoloLens.
Para desemparelhar o HoloLens de todos os computadores emparelhados:
- Inicie a aplicação Definições , aceda a Atualizar > para Programadores e toque em Limpar.
Graphics Debugger for HoloLens (1.ª geração)
As ferramentas de Diagnóstico de Gráficos do Visual Studio são úteis ao escrever e otimizar uma aplicação Holográfica. Veja Diagnóstico do Visual Studio Graphics no MSDN para obter detalhes completos.
Para Iniciar o Depurador gráfico
- Siga as instruções acima para direcionar um dispositivo ou emulador
- Aceda a Depurar > Diagnósticos de Início de Gráficos >
- Quando iniciar o diagnóstico pela primeira vez com um HoloLens, poderá obter um erro de "acesso negado". Reinicie o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.
Criação de perfis
As ferramentas de criação de perfis do Visual Studio permitem-lhe analisar o desempenho e a utilização de recursos da sua aplicação. Isto inclui ferramentas para otimizar a utilização de CPU, memória, gráficos e rede. Veja Executar ferramentas de diagnóstico sem depuração no MSDN para obter detalhes completos.
Para Iniciar as Ferramentas de Criação de Perfis com o HoloLens
- Siga as instruções acima para direcionar um dispositivo ou emulador
- Aceda a Depurar > Ferramentas de Diagnóstico Iniciar Sem Depuração...
- Selecione as ferramentas que pretende utilizar
- Selecione Iniciar
- Quando iniciar o diagnóstico pela primeira vez sem depurar com um HoloLens, poderá obter um erro de "acesso negado". Reinicie o HoloLens para permitir que as permissões atualizadas entrem em vigor e tente novamente.
Depurar uma aplicação instalada ou em execução
Pode utilizar o Visual Studio para depurar uma aplicação Universal do Windows instalada sem implementar a partir de um projeto do Visual Studio. Isto é útil se quiser depurar um pacote de aplicações instalado ou depurar uma aplicação que já esteja em execução.
- Aceda a Depurar –> Outros Destinos de Depuração –> Depurar o Pacote de Aplicações Instalado
- Selecione o destino da Máquina Remota para HoloLens ou Máquina Local para auscultadores envolventes.
- Introduza o endereço IP do dispositivo
- Escolher o Modo de Autenticação Universal
- A janela mostra aplicações em execução e inativas. Escolha o que pretende depurar.
- Escolher o tipo de código a depurar (Gerido, Nativo, Misto)
- Selecione Anexar ou Iniciar
Próximo Ponto de Verificação de Desenvolvimento
Se estiver a seguir o percurso de ponto de verificação de desenvolvimento do Unity que definimos, está no meio da fase de implementação. A partir daqui, pode continuar para o tópico seguinte:
Em alternativa, avance diretamente para a adição de serviços avançados:
Pode sempre voltar aos pontos de verificação de desenvolvimento do Unity em qualquer altura.