Usando Visual Studio para implantar e depurar

Quer esteja a usar o DirectX ou o Unitity para desenvolver a sua aplicação de realidade mista, Visual Studio é a sua ferramenta de depuração e implementação. Nesta secção, aprenderá a:

  • Coloque aplicações no seu HoloLens ou Windows Mixed Reality auscultadores imersivos através de Visual Studio.
  • Utilize o emulador HoloLens incorporado para Visual Studio.
  • Depurar aplicativos de realidade mista.

Pré-requisitos

  1. Consulte a instalação das ferramentas para obter instruções de instalação.
  2. Crie um novo projeto de aplicações universal Windows em Visual Studio. Para HoloLens (1º género), utilize Visual Studio 2017 ou mais recente. Para HoloLens 2, utilize Visual Studio 2019 16.2 ou mais recente. C# e C++ são suportados. (Ou siga as instruções para criar uma app em Unidade.)

Modo de Programação

Comece por ativar o Modo de Desenvolvimento no seu dispositivo, para Visual Studio possa ligar-se ao mesmo.

HoloLens

  1. Ligue o HoloLens e coloque o dispositivo.
  2. Use o gesto inicial para lançar o menu principal.
  3. Selecione o azulejo Definições para lançar a aplicação no seu ambiente.
  4. Selecione o item do menu 'Atualização'.
  5. Selecione o item do menu para desenvolvedores.
  6. Ative as funcionalidades do desenvolvedor para implementar aplicações de Visual Studio para o seu HoloLens. Se o seu dispositivo estiver em execução Windows versão Holográfica 21H1 ou mais recente, também ativa a descoberta do Dispositivo.
  7. Opcional: Desloque-se para baixo e também ative o Portal do Dispositivo, que permite ligar-se ao Portal do Dispositivo Windows no seu HoloLens a partir de um navegador web.

PC Windows

Se estiver a trabalhar com um auricular Windows Mixed Reality ligado ao seu PC, tem de ativar o Modo de Desenvolvimento no PC.

  1. Vá para Definições
  2. Selecione Atualização e Segurança
  3. Selecione para desenvolvedores
  4. Ativar o Modo de Desenvolvimento,ler o aviso de isenção para a definição que escolheu e, em seguida, selecione Sim para aceitar a alteração.

Implementação de uma aplicação HoloLens ao longo de Wi-Fi

Configure o seu projeto Visual Studio com as seguintes propriedades:

  1. Selecione as opções de compilação de apps
    • Para projetos de unidade, escolha lançamento ou Mestre
    • Para todos os outros projetos, escolha Lançamento

Nota

Pode encontrar definições completas para cada opção de compilação em soluções de exportação e construção Visual Studio.

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

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

ARM64 constrói configuração em Visual Studio

  1. Selecione Máquina Remota no menu de lançamento alvo suspenso

Alvo de implantação de máquina remota em Visual Studio

Em seguida, tem de definir a sua ligação remota. Para projetos C++ e JavaScript, vá a Project Propriedades de > Configuração de Propriedades > Depurando. Se estiver a trabalhar num projeto C#, deve aparecer automaticamente um diálogo.

Nota

Se o diálogo de ligação remota não aparecer no seu projeto C#, pode abri-lo manualmente a partir da Properties Debug.

  1. Introduza o endereço IP do seu dispositivo no campo Endereço ou Nome da Máquina.

    • Pode encontrar o endereço IP no seu HoloLens em Definições Network Internet Advanced &> Options
    • Recomendamos sempre que introduza manualmente o seu endereço IP em vez de depender da função Auto Detected
  2. Desafie o modo de autenticação para universal (protocolo não encriptado)

Diálogo de ligação remota em Visual Studio

  1. Construa, implemente e depure a sua app com base nas suas necessidades
    • Selecione Debug Comece a depurar para implementar a sua app e comece a depurar
    • Selecione Build Deploy para construir e implementar sem depurar

Comece sem depurar em Visual Studio

  1. A primeira vez que implementar uma aplicação para o seu HoloLens a partir do seu PC, será solicitado para um PIN. Siga as instruções de emparelhamento do seu dispositivo abaixo.

Implementação de uma aplicação HoloLens em USB


  1. Selecione as opções de compilação de apps
    • Para projetos de unidade, escolha lançamento ou Mestre
    • Para todos os outros projetos, escolha Lançamento

Nota

Pode encontrar definições completas para cada opção de compilação em soluções de exportação e construção Visual Studio.

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

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

ARM64 constrói configuração em Visual Studio

  1. Selecione Dispositivo no menu de lançamento alvo suspenso

Implantação do dispositivo em Visual Studio

  1. Construa, implemente e depure a sua app com base nas suas necessidades
    • Selecione Debug Comece a depurar para implementar a sua app e comece a depurar
    • Selecione Build Deploy para construir e implementar sem depurar

Comece sem depurar em Visual StudioStart Without Debugging in Visual Studio

  1. A primeira vez que implementar uma aplicação para o seu HoloLens a partir do seu PC, será solicitado para um PIN. Siga as instruções de emparelhamento do seu dispositivo abaixo.

Implementando uma aplicação para o HoloLens (1ª geração) Emulator

  1. Certifique-se de que instalou o HoloLens Emulator.
  2. Selecione uma configuração de construção x86 para a sua aplicação. Selecione uma configuração de construção x86 em Visual StudioSelect an x86 build configuration in Visual Studio
  3. Selecione HoloLens Emulator no menu de lançamento do Emulator alvo em Visual StudioEmulator target in Visual Studio
  4. Selecione Debug Comece a depurar para implementar a sua app e comece a depurar


Implementação de uma app para o HoloLens 2 Emulator

  1. Certifique-se de que instalou o HoloLens Emulator.
  2. Selecione uma configuração de construção x86 ou x64 para a sua aplicação. x86 configuração de configuração de configuração de construção em Visual Studio
  3. Selecione HoloLens 2 Emulator no menu de lançamento Emulator alvo na aplicação Visual StudioEmulator target in Visual Studio application
  4. Selecione Debug Comece a depurar para implementar a sua app e comece a depurar


Implementação de uma aplicação VR para o seu PC Local

Para utilizar um auricular Windows Mixed Reality imersivo que se conecta ao seu PC ou ao simulador de Realidade Mista:

  1. Selecione uma configuração de construção x86 ou x64 para a sua aplicação
  2. Selecione a Máquina Local no menu de lançamento alvo suspenso
  3. Construa, implemente e depure a sua app com base nas suas necessidades
    • Selecione Debug Comece a depurar para implementar a sua app e comece a depurar
    • Selecione Build Deploy para construir e implementar sem depurar

Emparelhar o seu dispositivo

A primeira vez que implementar uma aplicação de Visual Studio para o seu HoloLens, será solicitado para um PIN. No HoloLens, gere um PIN lançando a aplicação Definições, vá ao Update For Developerse toque em Pair. Quando o PIN estiver visualizado no seu HoloLens, escreva-o em Visual Studio. Depois de o emparelhamento estar completo, toque no seu HoloLens para dispensar o diálogo. Este PC está agora emparelhado com o HoloLens e pode implementar aplicações automaticamente. Repita estes passos para cada PC que seja usado para implementar aplicações para o seu HoloLens.

Para não HoloLens de todos os computadores emparelhados:

  • Lançar a aplicação Definições, ir ao Update For Developerse tocar em Clear.

Gráficos Debugger para HoloLens (1ª gen)

As ferramentas de diagnóstico gráfico Visual Studio são úteis na escrita e otimização de uma aplicação holográfica. Consulte Visual Studio Diagnósticos gráficos na MSDN para obter todos os detalhes.

Para iniciar o Debugger Gráficos

  1. Siga as instruções acima para direcionar um dispositivo ou emulador
  2. Ir a Debug Graphics > Iniciar Diagnósticos
  3. A primeira vez que iniciar diagnósticos com um HoloLens, poderá obter um erro de "acesso negado". Reinicie a sua HoloLens para que as permissões atualizadas produzam efeitos e tente novamente.

Criação de perfis

As ferramentas de perfis Visual Studio permitem-lhe analisar o desempenho da sua aplicação e a utilização de recursos. Isto inclui ferramentas para otimizar CPU, memória, gráficos e uso de rede. Consulte ferramentas de diagnóstico executar sem depurar a MSDN para obter todos os detalhes.

Para iniciar as ferramentas de perfis com HoloLens

  1. Siga as instruções acima para direcionar um dispositivo ou emulador
  2. Vá a Debug Iniciar Ferramentas de Diagnóstico Sem Depurar...
  3. Selecione as ferramentas que pretende utilizar
  4. Selecione Iniciar
  5. A primeira vez que iniciar diagnósticos sem depurar com um HoloLens, poderá obter um erro de "acesso negado". Reinicie a sua HoloLens para que as permissões atualizadas produzam efeitos e tente novamente.

Depurar uma aplicação instalada ou em execução

Você pode usar Visual Studio para depurar uma aplicação de Windows Universal instalada sem ser implantado a partir de um projeto Visual Studio. Isto é útil se quiser depurar um pacote de aplicações instalado ou depurar uma aplicação que já está em execução.

  1. Ir para Debug - Outros Alvos de Debug - > Pacote de aplicações instalado de Debug
  2. Selecione o alvo da Máquina Remota para HoloLens ou Máquina Local para auscultadores imersivos.
  3. Insira o endereço IP do seu dispositivo
  4. Escolha o Modo de Autenticação Universal
  5. A janela mostra aplicações em execução e inativas. Escolha o que quiser depurar.
  6. Escolha o tipo de código para depurar (Gerido, Nativo, Misto)
  7. Selecione Anexar ou Iniciar

Próximo checkpoint de desenvolvimento

Se estás a seguir a jornada de controlo de desenvolvimento da Unidade que estabelecemos, estás no meio da fase de implantação. A partir daqui, pode continuar para o próximo tópico:

Ou saltar diretamente para adicionar serviços avançados:

Pode sempre voltar aos postos de controlo de desenvolvimento da Unidade a qualquer momento.

Ver também