Utilisation de Visual Studio pour le déploiement et le débogage

Que vous utilisiez DirectX ou Unity pour développer votre application de réalité mixte, Visual Studio est votre outil de prédilection pour la déboguer et la déployer. Dans cette section, vous allez découvrir comment :

  • Déployer des applications sur votre HoloLens ou un casque immersif Windows Mixed Reality à l’aide de Visual Studio.
  • Utiliser l’émulateur HoloLens intégré à Visual Studio.
  • Déboguer des applications de réalité mixte.

Prérequis

  1. Consultez Installer les outils pour obtenir des instructions d’installation.
  2. Créez un projet d’application Windows universelle dans Visual Studio. Pour HoloLens (1re génération), utilisez Visual Studio 2017 ou une version plus récente. Pour HoloLens 2, utilisez Visual Studio 2019 16.2 ou ultérieur. Les langages C# et C++ sont pris en charge. (Ou suivez les instructions pour créer une application dans Unity.)

Activation du mode développeur

Commencez par activer le mode développeur sur votre appareil afin que Visual Studio puisse s’y connecter.

HoloLens

  1. Mettez HoloLens sous tension et allumez l’appareil.
  2. Utilisez le mouvement associé au menu Démarrer pour lancer le menu principal.
  3. Sélectionnez la vignette Settings pour lancer l’application dans votre environnement.
  4. Sélectionnez l’élément de menu Mettre à jour.
  5. Sélectionnez l’élément de menu Pour les développeurs.
  6. Activez Utiliser les fonctionnalités de développement pour déployer des applications à partir de Visual Studio sur votre HoloLens. Si votre appareil exécute Windows Holographique, version 21H1 ou une version plus récente, activez également Découverte d’appareil.
  7. Facultatif : Faites défiler et activez également Portail d’appareil, ce qui vous permet de vous connecter au Portail d’appareil Windows sur votre HoloLens à partir d’un navigateur web.

PC Windows

Si vous travaillez avec un casque Windows Mixed Reality connecté à votre PC, vous devez activer le Mode développeur sur ce PC.

  1. Accédez à Paramètres
  2. Sélectionnez Mise à jour et sécurité
  3. Sélectionnez Pour les développeurs
  4. Activez le Mode développeur, lisez la clause d’exclusion de responsabilité pour le paramètre que vous avez choisi, puis sélectionnez Oui pour accepter la modification.

Déploiement d’une application HoloLens via une connexion Wi-Fi

Configurez votre projet Visual Studio avec les propriétés suivantes :

  1. Sélectionner vos options de compilation d’applications
    • Pour les projets Unity, choisissez Release ou Master
    • Pour tous les autres projets, choisissez Release

Notes

Vous trouverez les définitions complètes de chaque option de compilation dans Exportation et génération de solutions Visual Studio.

  1. Sélectionner votre configuration de build en fonction de votre appareil

Choisissez l’option de configuration ARM ou ARM64

Configuration de build ARM64 dans Visual Studio

  1. Sélectionnez Machine distante dans le menu déroulant de la cible de déploiement

Cible de déploiement de machine distante dans Visual Studio

Ensuite, vous devez définir votre connexion à distance. pour les projets C++ et JavaScript, accédez à Project propriétés > Configuration propriétés > débogage. Si vous travaillez sur un projet C#, une boîte de dialogue doit s’afficher automatiquement.

Notes

Si la boîte de dialogue Connexion à distance n’apparaît pas dans votre projet C#, vous pouvez l’ouvrir manuellement à partir de propriétés Déboguer.

  1. Entrez l’adresse IP de votre appareil dans le champ Adresse ou Nom de la machine.

    • vous pouvez trouver l’adresse IP sur votre HoloLens sous Paramètres & Options Internet réseau > avancées
    • Nous recommandons toujours d’entrer manuellement votre adresse IP plutôt que de dépendre de la fonctionnalité Détection automatique.
  2. Définissez le Mode d’authentification sur Universel (protocole non chiffré)

Boîte de dialogue Connexion à distance dans Visual Studio

  1. Créer, déployer et déboguer votre application en fonction de vos besoins
    • Sélectionnez Déboguer Démarrer le débogage pour déployer votre application et démarrer le débogage
    • Sélectionnez Générer déployer pour générer et déployer sans débogage

Exécuter sans débogage dans Visual Studio

  1. La première fois que vous déployez une application sur votre HoloLens à partir de votre PC, vous êtes invité à entrer un code PIN. Suivez les instructions de la section Appairer votre appareil, plus loin dans cet article.

Déploiement d’une application HoloLens via une connexion USB


  1. Sélectionner vos options de compilation d’applications
    • Pour les projets Unity, choisissez Release ou Master
    • Pour tous les autres projets, choisissez Release

Notes

Vous trouverez les définitions complètes de chaque option de compilation dans Exportation et génération de solutions Visual Studio.

  1. Sélectionner votre configuration de build en fonction de votre appareil

Choisissez l’option de configuration ARM ou ARM64

Configuration de build ARM64 dans Visual Studio

  1. Sélectionnez Appareil dans le menu déroulant de la cible de déploiement

Déploiement d’appareils dans Visual Studio

  1. Créer, déployer et déboguer votre application en fonction de vos besoins
    • Sélectionnez Déboguer Démarrer le débogage pour déployer votre application et démarrer le débogage
    • Sélectionnez Générer déployer pour générer et déployer sans débogage

Exécuter sans débogage dans Visual StudioStart Without Debugging in Visual Studio

  1. La première fois que vous déployez une application sur votre HoloLens à partir de votre PC, vous êtes invité à entrer un code PIN. Suivez les instructions de la section Appairer votre appareil, plus loin dans cet article.

Déploiement d’une application sur l’émulateur HoloLens (1re génération)

  1. Vérifiez que l’émulateur HoloLens est installé .
  2. Sélectionnez une configuration de build x86 pour votre application. Sélectionnez une configuration de build x86 dans Visual StudioSelect an x86 build configuration in Visual Studio
  3. sélectionnez HoloLens Emulator dans le menu déroulant cible de déploiement Emulator cible dans Visual StudioEmulator target in Visual Studio
  4. Sélectionnez Déboguer Démarrer le débogage pour déployer votre application et démarrer le débogage


Déploiement d’une application sur l’émulateur HoloLens 2

  1. Vérifiez que l’émulateur HoloLens est installé .
  2. Sélectionnez une configuration de build x86 ou x64 pour votre application. Configuration des paramètres de build x86 dans Visual Studio
  3. sélectionnez HoloLens 2 Emulator dans le menu déroulant cible de déploiement Emulator cible dans Visual Studio applicationEmulator target in Visual Studio application
  4. Sélectionnez Déboguer Démarrer le débogage pour déployer votre application et démarrer le débogage


Déploiement d’une application VR sur votre PC local

Pour utiliser un casque immersif Windows Mixed Reality qui se connecte à votre PC ou au simulateur Mixed Reality :

  1. Sélectionnez une configuration de build x86 ou x64 pour votre application
  2. Sélectionnez Machine locale dans le menu déroulant de la cible de déploiement
  3. Créer, déployer et déboguer votre application en fonction de vos besoins
    • Sélectionnez Déboguer Démarrer le débogage pour déployer votre application et démarrer le débogage
    • Sélectionnez Générer déployer pour générer et déployer sans débogage

Appairage de votre appareil

La première fois que vous déployez une application sur votre HoloLens à partir de Visual Studio, vous êtes invité à entrer un code PIN. sur la HoloLens, générez un code PIN en lançant l’application Paramètres, accédez à la mise à jour pour les développeurset appuyez sur paire. Tapez le code PIN qui apparaît sur votre HoloLens dans Visual Studio. Une fois l’appairage terminé, appuyez sur Terminé sur votre HoloLens pour fermer la boîte de dialogue. Ce PC étant maintenant appairé avec votre HoloLens, vous pouvez y déployer des applications automatiquement. Répétez ces étapes pour chaque PC utilisé pour déployer des applications sur votre HoloLens.

Pour découpler votre HoloLens de tous les ordinateurs appairés :

  • lancez l’application Paramètres , accédez à la mise à jour pour les développeurset appuyez sur Clear.

Débogueur Graphics pour HoloLens (1re génération)

Les outils Graphics Diagnostics de Visual Studio sont utiles quand vous écrivez et optimisez une application holographique. Pour plus d’informations, consultez Visual Studio Graphics Diagnostics sur MSDN.

Pour démarrer le débogueur Graphics

  1. Suivez les instructions données plus haut pour cibler un appareil ou un émulateur
  2. Aller à Déboguer Graphics > Démarrer les diagnostics
  3. La première fois que vous démarrez les diagnostics avec un HoloLens, vous pouvez obtenir une erreur « Accès refusé ». Redémarrez votre HoloLens pour que les autorisations mises à jour prennent effet, puis réessayez.

Profilage

Les outils de profilage dans Visual Studio vous permettent d’analyser l’utilisation des ressources et les performances de votre application. Ces outils comprennent des outils pour optimiser l’utilisation du processeur, de la mémoire, des graphiques et du réseau. Pour plus d’informations, consultez Exécuter les outils de diagnostic sans débogage sur MSDN.

Pour démarrer les outils de profilage avec HoloLens

  1. Suivez les instructions données plus haut pour cibler un appareil ou un émulateur
  2. Accédez à Déboguer Démarrer outils de diagnostic sans débogage...
  3. Sélectionnez les outils que vous souhaitez utiliser
  4. Sélectionnez Démarrer
  5. La première fois que vous démarrez les diagnostics sans débogage avec un HoloLens, vous pouvez obtenir une erreur « Accès refusé ». Redémarrez votre HoloLens pour que les autorisations mises à jour prennent effet, puis réessayez.

Débogage d’une application installée ou en cours d’exécution

Vous pouvez utiliser Visual Studio pour déboguer une application Windows universelle installée sans déploiement à partir d’un projet Visual Studio. Cela est utile si vous souhaitez déboguer un package d’application installé ou une application en cours d’exécution.

  1. Aller à Déboguer- autres cibles de débogage- > déboguer le package d’application installé
  2. Sélectionnez la cible Machine distante pour HoloLens ou Machine locale pour les casques immersifs
  3. Entrez l’adresse IP de votre appareil
  4. Choisissez le mode d’authentification Universel
  5. La fenêtre affiche les applications en cours d’exécution et les applications inactives. Sélectionnez celle que vous voulez déboguer.
  6. Choisissez le type de code à déboguer (managé, natif, mixte)
  7. Sélectionnez Attacher ou Démarrer

Point de contrôle de développement suivant

Si vous suivez le parcours de points de contrôle de développement Unreal que nous avons élaboré, vous êtes actuellement au cœur de la phase de déploiement. À partir d’ici, vous pouvez passer au sujet suivant :

Ou accéder directement à l’ajout de services avancés :

Vous pouvez revenir aux points de contrôle de développement Unity à tout moment.

Voir aussi