Configuration du débogage distant pour un projet Visual Studio

Vous pouvez déboguer un projet de bureau Windows généré localement, puis lancer l'exécutable sur un ordinateur distant.Cette rubrique explique comment modifier les paramètres de votre projet local pour exécuter l'application sur un ordinateur distant.Les projets C++ sont déployés automatiquement sur l'ordinateur distant.Vous devez déployer manuellement les fichiers exécutables du .NET Framework.

[!REMARQUE]

Pour configurer des projets Windows Store pour le débogage sur un appareil distant, consultez Exécuter des applications du Windows Store sur un ordinateur distant à partir de Visual Studio

Ces exemples supposent que Visual Studio Remote Debugging Monitor est déjà installé sur l'ordinateur distant.Consultez Débogage et diagnostics distants.

La rubrique contient les exemples suivants :

Set up a Visual C++ project

Set up a Visual C#/Visual Basic project

Configurer un projet Visual C++

La procédure présentée ici suppose que vous disposez d'un projet MFC, MyMfc, généré sur l'ordinateur local1.Vous voulez exécuter l'application MyMfc.exe sur l'ordinateur remote1 dans le dossier c:\RemoteTemp, puis déboguer à l'aide du débogueur Visual Studio sur l'ordinateur local1.Par ailleurs, vous voulez copier le fichier c:\Data\MyMfcData.txt sur l'ordinateur distant.

[!REMARQUE]

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée.Pour modifier vos paramètres, cliquez sur Importation et exportation de paramètres dans le menu Outils.Pour plus d'informations, consultez Paramètres Visual Studio.

Pour préparer l'ordinateur distant

Pour préparer l'ordinateur Visual Studio

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet C++ et sélectionnez Propriétés.

  2. Dans la boîte de dialogue Pages de propriétés, développez le nœud Propriétés de configuration, puis choisissez Débogage.Dans la liste déroulante Débogueur à lancer, sélectionnez Débogueur Windows distant.

    Page de propriétés de débogage du projet MyMfc

  3. Appliquez les modifications suivantes aux propriétés :

    Paramètre

    Modifier

    Commande distante

    Type c:\remotetemp\mymfc.exe.

    Répertoire de travail

    Remplacez par c:\remotetemp.

    Nom du serveur distant

    Type remote1.

    Connexion

    Vérifiez qu'elle est définie sur À distance avec authentification Windows.

    Type de débogueur

    Remplacez Automatique par Natif uniquement, car vous savez que vous déboguez du code natif.

    Répertoire de déploiement

    Remplacez par c:\remotetemp.

    Fichiers supplémentaires à déployer

    Remplacez par c:\data\mymfcdata.txt.

  4. Dans la barre d'outils, ouvrez le menu déroulant Configuration de la solution, puis choisissez Gestionnaire de configurations.

  5. Pour la configuration Déboguer, activez la case à cocher Déployer.

    Boîte de dialogue Gestionnaire de configuration

  6. Dans le menu Déboguer, cliquez sur Démarrer le débogage et commencez le débogage.

    ConseilConseil

    La commande de débogage déploie automatiquement (copie) la sortie du projet et les fichiers supplémentaires sur l'ordinateur distant.Vous pouvez déployer les fichiers en tant qu'étape distincte.Dans l'Explorateur de solutions, ouvrez le menu contextuel de MyMfc, puis choisissez Déployer.

Pour déployer des fichiers supplémentaires sur l'ordinateur distant

  1. (Facultatif) Créez un dossier de projet pour le fichier supplémentaire.Sélectionnez le projet dans l'Explorateur de solutions.Dans le menu contextuel, choisissez Ajouter, Nouveau dossier.Copiez le fichier de données dans le nouveau dossier.

  2. Ajoutez le fichier à votre projet Visual Studio.Sélectionnez un répertoire de projet dans l'Explorateur de solutions.Dans le menu contextuel, choisissez Ajouter, Ajouter un élément existant et sélectionnez le fichier.

  3. Dans l'Explorateur de solutions, sélectionnez le fichier et choisissez Propriétés.

    Propriétés du fichier de données

  4. Sélectionnez Toujours copier dans la liste Copier dans le répertoire de sortie.

Configurer un projet Visual C#/Visual Basic

Le débogueur ne peut pas déployer votre application de bureau Visual C# ou Visual Basic sur un ordinateur distant.Toutefois, vous pouvez déboguer l'application sur un ordinateur distant en utilisant les procédures suivantes.

Les procédures présentées ici supposent que vous disposiez d'un projet d'application WPF, MyWpf, généré sur l'ordinateur local1.La version Debug de l'application est créée dans le dossier C:\Projects\MyWPF\MyWPF\bin\Debug sous la forme du fichier MyWpf.exe.Vous voulez exécuter l'application sur l'ordinateur remote1, puis effectuer le débogage à l'aide du débogueur Visual Studio sur l'ordinateur local1.

Pour préparer l'ordinateur Visual Studio

  1. Ouvrez le projet MyWpf dans Visual Studio.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet et sélectionnez Propriétés.

  3. Dans la page des propriétés de MyWpf, choisissez Déboguer.

    Page de propriétés du projet de débogage

  4. Assurez-vous que la zone de texte Répertoire de travail est vide.

  5. Choisissez Utiliser l'ordinateur distant et tapez remote1 dans la zone de texte.

  6. (Facultatif) Sous Type de débogueur, sélectionnez Mode mixte pour activer explicitement le débogage à la fois du code managé et du code non managé.

  7. Générez l'application.

Pour préparer l'ordinateur distant

  1. Installez et démarrez le débogueur distant Visual Studio sur remote1.Voir Configurer les outils de contrôle à distance sur le périphérique et Démarrer Remote Debugging Monitor

  2. Créez un dossier sur remote1 dont le chemin d'accès est le même que le dossier Debug sur local1 : C:\Projects\MyWPF\MyWPF\bin\Debug.

  3. Copiez MyWPF.exe depuis local1 vers remote1.

Pour démarrer le débogage sur l'ordinateur distant

  • Dans Visual Studio sur local1, choisissez Déboguer/Démarrer le débogage.