Déboguer des applications UWP sur des machines distantes à partir de Visual Studio

S’applique à :ouiVisual Studio nonVisual Studio pour Mac nonVisual Studio Code

Vous pouvez utiliser Visual Studio pour exécuter, déboguer, profiler et tester une application plateforme Windows universelle (UWP) sur un autre ordinateur ou appareil. L’exécution de l’application UWP sur un ordinateur distant est particulièrement utile lorsque l’ordinateur Visual Studio ne prend pas en charge les fonctionnalités spécifiques à UWP telles que l’orientation tactile, géographique ou physique.

Prérequis

Pour déboguer une application UWP sur un appareil distant à partir de Visual Studio :

  • Le projet Visual Studio doit être configuré pour le débogage à distance.
  • L’ordinateur distant et l’ordinateur Visual Studio doivent être connectés via un réseau ou directement via un câble USB ou Ethernet. Le débogage sur Internet n'est pas pris en charge.
  • Vous devez activer le mode développeur sur l’ordinateur Visual Studio et l’ordinateur distant.
  • Les ordinateurs distants doivent exécuter le Outils de contrôle à distance de Visual Studio.

Configurer un projet Visual Studio pour le débogage à distance

Vous utilisez les propriétés du projet pour spécifier l’appareil distant auquel se connecter. Les paramètres diffèrent selon le langage de programmation.

Attention

Par défaut, la page de propriétés définit universal (protocole non chiffré) comme type d’authentification pour Windows 10 et les connexions distantes ultérieures. Vous devrez peut-être définir Aucune authentification pour vous connecter au débogueur distant. Le protocole universel (non chiffré) et aucun protocole d’authentification n’a pas de sécurité réseau, de sorte que les données transmises entre le développement et les machines distantes sont vulnérables. Choisissez ces types d’authentification uniquement pour les réseaux approuvés que vous êtes sûr de ne pas risquer de trafic malveillant ou hostile.

Si vous choisissez l’authentification Windows pour le type d’authentification, vous devez vous connecter à l’ordinateur distant lors du débogage. Le débogueur distant doit également s’exécuter en mode Authentification Windows , avec le même compte d’utilisateur que sur l’ordinateur Visual Studio.

Configurer un projet C# ou Visual Basic pour le débogage à distance

  1. Sélectionnez le projet C# ou Visual Basic dans Visual Studio Explorateur de solutions et sélectionnez l’icône Propriétés, appuyezsur +Alt Entrée ou cliquez avec le bouton droit sur Propriétés.

  2. Sélectionnez l’onglet Débogage.

  3. Sous Appareil cible, sélectionnez Ordinateur distant pour un ordinateur distant ou Appareil pour un appareil Windows Mobile 10 connecté directement.

  4. Pour une machine distante, entrez le nom réseau ou l’adresse IP dans le champ Ordinateur distant , ou sélectionnez Rechercher pour rechercher l’appareil dans la boîte de dialogue Connexions à distance.

    Propriétés du projet managé pour le débogage à distance

Configurer un projet C++ pour le débogage à distance

  1. Sélectionnez le projet C++ dans Visual Studio Explorateur de solutions et sélectionnez l’icône Propriétés, appuyezsur +Alt Entrée ou cliquez avec le bouton droit sur Propriétés.

  2. Sélectionnez l’onglet Débogage .

  3. Sous Débogueur à lancer, sélectionnez Ordinateur distant pour un ordinateur distant ou Appareil pour un appareil Windows Mobile 10 connecté direct.

  4. Pour une machine distante, entrez ou sélectionnez le nom réseau ou l’adresse IP dans le champ Nom de l’ordinateur , ou sélectionnez Rechercher pour rechercher l’appareil dans la boîte de dialogue Connexions à distance.

    Propriétés du projet C++ pour le débogage à distance

Utiliser la boîte de dialogue Connexions à distance

Dans la boîte de dialogue Connexions à distance , vous pouvez rechercher un nom d’ordinateur distant ou une adresse IP spécifique, ou détecter automatiquement les connexions en sélectionnant l’icône d’actualisation de flèche arrondie. La boîte de dialogue recherche uniquement les appareils sur le sous-réseau local qui exécutent actuellement le débogueur distant. Tous les appareils ne peuvent pas être détectés dans la boîte de dialogue Connexions à distance .

Boîte de dialogue Connexion à distance boîte de

Conseil

Si vous ne pouvez pas vous connecter à un appareil distant par nom, essayez d’utiliser son adresse IP. Pour déterminer l’adresse IP, sur l’appareil distant, entrez ipconfig dans une fenêtre de commande. L’adresse IP s’affiche en tant qu’adresse IPv4.

Télécharger et installer les outils de contrôle à distance de Visual Studio

Pour que Visual Studio débogue des applications sur un ordinateur distant, l’ordinateur distant doit exécuter le Outils de contrôle à distance de Visual Studio.

  • Les appareils Windows Mobile 10 ne nécessitent pas ou ne prennent pas en charge les outils distants.
  • Windows 11 PC et Windows 10 PC exécutant la mise à jour de Creator (version 1703) et ultérieure, Windows 10 les appareils Xbox, IoT et HoloLens installent automatiquement les outils distants lorsque vous déployez l’application.
  • Sur les pc de mise à jour de pré-Créateur Windows 10, vous devez télécharger, installer et exécuter manuellement les outils distants sur l’ordinateur distant avant de commencer le débogage.

Pour télécharger et installer les outils distants :

Sur l’appareil ou le serveur distant sur lequel vous souhaitez déboguer, plutôt que sur l’ordinateur Visual Studio, téléchargez et installez la version correcte des outils distants à partir des liens figurant dans le tableau suivant.

  • Téléchargez les outils distants les plus récents pour votre version de Visual Studio. La dernière version des outils distants est compatible avec les versions antérieures de Visual Studio, mais les versions antérieures des outils distants ne sont pas compatibles avec les versions ultérieures de Visual Studio. (Par exemple, si vous utilisez Visual Studio 2019, téléchargez la dernière mise à jour des outils distants pour Visual Studio 2019. Dans ce scénario, ne téléchargez pas les outils distants pour Visual Studio 2022.)
  • Téléchargez les outils distants avec la même architecture que la machine sur laquelle vous les installez. Par exemple, si vous souhaitez déboguer une application 32 bits sur un ordinateur distant exécutant un système d’exploitation 64 bits, installez les outils distants 64 bits.
Version Lien Remarques
Visual Studio 2022 outils de contrôle à distance. Compatible avec toutes les versions de Visual Studio 2022. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2019 outils de contrôle à distance. Compatible avec toutes les versions de Visual Studio 2019. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2017 outils de contrôle à distance. Compatible avec toutes les versions de Visual Studio 2017. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2015 outils de contrôle à distance. Les outils distants pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme gratuit Visual Studio Dev Essentials ou connectez-vous avec votre ID d’abonnement Visual Studio. Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2013 outils de contrôle à distance. Page de téléchargement dans Visual Studio 2013 documentation
Visual Studio 2012 outils de contrôle à distance. Page de téléchargement dans la documentation Visual Studio 2012
Version Lien Remarques
Visual Studio 2019 outils de contrôle à distance. Compatible avec toutes les versions de Visual Studio 2019. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants. Pour la version la plus récente des outils distants, ouvrez la documentation Visual Studio 2022.
Visual Studio 2017 outils de contrôle à distance. Compatible avec toutes les versions de Visual Studio 2017. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2015 outils de contrôle à distance. Les outils distants pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme gratuit Visual Studio Dev Essentials ou connectez-vous avec votre ID d’abonnement Visual Studio. Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2013 outils de contrôle à distance. Page de téléchargement dans Visual Studio 2013 documentation
Visual Studio 2012 outils de contrôle à distance. Page de téléchargement dans la documentation Visual Studio 2012

Vous pouvez exécuter le débogueur distant en copiant msvsmon.exe sur l’ordinateur distant, plutôt que d’installer les outils distants. Toutefois, l’Assistant Configuration du débogueur distant (rdbgwiz.exe) est disponible uniquement lorsque vous installez les outils distants. Vous devrez peut-être utiliser l’Assistant pour la configuration si vous souhaitez exécuter le débogueur distant en tant que service. Pour plus d’informations, consultez (Facultatif) Configurer le débogueur distant en tant que service.

Notes

  • Pour déboguer des applications Windows 10 ou ultérieures sur des appareils ARM, utilisez ARM64, qui est disponible avec la dernière version des outils distants.
  • Pour déboguer Windows 10 applications sur des appareils Windows RT, utilisez ARM, qui est disponible uniquement dans le téléchargement des outils distants Visual Studio 2015.

Configurer les outils distants

  1. Sur l’ordinateur distant, recherchez et démarrez le débogueur distant à partir du menu Démarrer .

    Si vous n’avez pas d’autorisations d’administration sur l’ordinateur distant, cliquez avec le bouton droit sur l’application Débogueur distant et sélectionnez Exécuter en tant qu’administrateur. Sinon, il suffit de le démarrer normalement.

    Si vous envisagez d’attacher un processus qui s’exécute en tant qu’administrateur ou s’exécute sous un autre compte d’utilisateur (par exemple IIS), cliquez avec le bouton droit sur l’application débogueur distant et sélectionnez Exécuter en tant qu’administrateur. Pour plus d’informations, consultez Exécuter le débogueur distant en tant qu’administrateur.

  2. La première fois que vous démarrez le débogueur distant (ou avant de l’avoir configuré), la boîte de dialogue Configuration du débogage à distance s’affiche.

    Configuration du débogueur

  3. Si l’API Services Web Windows n’est pas installée, ce qui se produit uniquement sur Windows Server 2008 R2, sélectionnez le bouton Installer .

  4. Sélectionnez au moins un type de réseau sur lequel vous souhaitez utiliser les outils distants. Si les ordinateurs sont connectés à un domaine, vous devez choisir le premier élément. Si les ordinateurs sont connectés via un groupe de travail ou un groupe d’accueil, choisissez le deuxième ou le troisième élément approprié.

  5. Sélectionnez Configurer le débogage à distance pour configurer le pare-feu et démarrer le débogueur distant.

  6. Une fois la configuration terminée, la fenêtre débogueur distant s’affiche.

    Fenêtre Débogueur distant

    Fenêtre Débogueur distant

    Le débogueur distant attend maintenant une connexion. Utilisez le nom du serveur et le numéro de port indiqués pour définir la configuration de la connexion à distance dans Visual Studio.

Pour arrêter le débogueur distant, sélectionnezQuitter le fichier>. Vous pouvez le redémarrer à partir du menu Démarrer ou à partir de la ligne de commande :

<Remote debugger installation directory>\msvsmon.exe

Déboguer des applications UWP à distance

Le débogage à distance fonctionne de la même façon que le débogage local.

  1. Sur les versions de mise à jour de pré-Créateur de Windows 10, vérifiez que le Moniteur de débogage à distance (msvsmon.exe) s’exécute sur l’appareil distant.

  2. Sur l’ordinateur Visual Studio, assurez-vous que la cible de débogage correcte (Ordinateur distant ou appareil) s’affiche en regard de la flèche verte de la barre d’outils.

  3. Démarrez le débogage en sélectionnant>Démarrer le débogage, en appuyant sur F5 ou en sélectionnant la flèche verte dans la barre d’outils.

    Le projet recompile, puis déploie et démarre sur l’appareil distant. Le débogueur interrompt l’exécution au niveau des points d’arrêt, et vous pouvez passer au code, au-dessus et à l’extérieur du code.

  4. Si nécessaire, sélectionnez Arrêter>le débogage ou appuyez sur Maj+F5 pour arrêter le débogage et fermer l’application distante.

Voir aussi