Partage via

Paramètres du projet pour une configuration de débogage C++

  • Article

Vous pouvez modifier les paramètres de projet d’une configuration de débogage C ou C++ dans la boîte de dialogue Pages de propriétés, comme indiqué dans Guide pratique pour définir les configurations de débogage et de mise en production. Les tableaux suivants indiquent où se trouvent les paramètres du débogueur dans la boîte de dialogue Pages de propriétés.

Note

Les paramètres du projet de débogage dans la catégorie Propriétés de configuration/Débogage sont différents pour les applications UWP et pour les composants écrits en C++. Consultez Démarrer une session de débogage (VB, C#, C++ et XAML).

Chaque paramètre de propriété de débogage est automatiquement écrit et enregistré dans le fichier « par utilisateur » (.vcxproj.user) de votre solution lorsque vous enregistrez votre solution.

Spécifiez le débogueur à utiliser dans la zone de liste Débogueur à lancer, comme décrit dans le tableau suivant. Votre choix affecte les propriétés visibles.

Dossier Propriétés de configuration (catégorie Débogage)

Paramètre Description
Débogueur à lancer Spécifie le débogueur à exécuter, avec les choix suivants :

- Débogueur Windows local
- Débogueur Windows distant
- Débogueur de Navigateur Web
- débogueur de service web
Commande (Débogueur Windows local) Spécifie la commande permettant de démarrer le programme que vous déboguez sur l’ordinateur local.
Commande distante (Débogueur Windows distant) Chemin d'accès pour le fichier .exe sur l'ordinateur distant. Entrez le chemin d'accès tel que vous l'entreriez sur l'ordinateur distant.
Arguments de la commande (débogueur Windows local)

Arguments de la commande distante (Débogueur Windows distant)		 - Spécifie les arguments du programme que vous déboguez. Pour plus d’informations sur les façons de définir des arguments de ligne de commande, consultez Envoyer des arguments de ligne de commande à un programme à déboguer (C++).

Vous pouvez utiliser les opérateurs de redirection suivants dans cette zone :

< file
Lit stdin à partir du fichier.

> file
Écrit stdout dans le fichier.

>> file
Ajoute stdout au fichier.

2>file
Écrit stderr dans le fichier.

2>>file
Ajoute stderr au fichier.

2> &1
Envoie la sortie stderr (2) au même emplacement que stdout (1).

1> &2
Envoie la sortie stdout (1) au même emplacement que stderr (2).

Dans la plupart des cas, ces opérateurs s’appliquent uniquement aux applications console.

Si vous avez besoin de placer des caractères d’échappement dans la commande, vous pouvez utiliser des valeurs ASCII, comme %25 pour remplacer %. Si vous utilisez la commande Démarrer le débogage, les guillemets doubles permettent d'ignorer les commandes précédentes, telles que « < » pour remplacer <.
Répertoire de travail Spécifie le répertoire de travail du programme en cours de débogage, par rapport au répertoire du projet où se trouve votre EXE. Si vous laissez ce champ vide, le répertoire de travail est le répertoire du projet. Pour le débogage à distance, le répertoire du projet se trouve sur le serveur distant.
Attacher (Débogueur Windows local et débogueur Windows distant) Spécifie s'il faut démarrer ou se connecter à l'application. Le paramètre par défaut est Non.
Nom de serveur distant (Débogueur Windows distant) Spécifie le nom d’un ordinateur (autre que le vôtre) sur lequel vous souhaitez déboguer une application.

La macro RemoteMachine Build est définie sur la valeur de cette propriété ; pour plus d’informations, consultez Macros pour les commandes de build et les propriétés.
Connexion (débogueur distant Windows) Vous permet de basculer entre les types de connexion standard et sans authentification pour le débogage à distance. Spécifiez un nom d’ordinateur distant dans la zone Nom du serveur distant. Les types de connexion sont les suivants :

- Télécommande avec authentification Windows
- Distant sans authentification

Remarque débogage à distance sans authentification peut laisser l’ordinateur distant vulnérable aux violations de sécurité. Le mode d’authentification Windows est plus sécurisé.

Pour plus d’informations, consultez Programme d’installation du débogage distant.
URL HTTP (débogueur de service web et débogueur de navigateur web) Spécifie l’URL où se trouve le projet que vous déboguez.
Type de débogueur Spécifie le type de débogueur à utiliser : natif uniquement, managé uniquement, GPU uniquement, mixte, automatique (par défaut) ou script.

- native uniquement est destinée au code C++ non managé.
- Managed Only concerne le code qui s’exécute sous le Common Language Runtime (code managé).
- Le type Mixte appelle les débogueurs aussi bien pour le code managé que pour le code non managé.
- Le type Auto permet de déterminer le type du débogueur en fonction des informations relatives au compilateur et EXE.
- Le Script appelle un débogueur pour les scripts.
- GPU uniquement est destiné au code AMP C++ qui s’exécute sur un appareil GPU ou sur le ratériseur de référence DirectX. Consultez Débogage du code GPU.
Environnement (débogueur Windows local et débogueur Windows distant) Spécifie des variables d’environnement pour le programme que vous déboguez. Utilisez la syntaxe de variable d’environnement standard (par exemple, PATH="%SystemRoot%\..."). Ces variables remplacent l’environnement système ou sont fusionnées avec l’environnement système, selon le paramètre de fusion Merge Environment. Lorsque vous cliquez sur la colonne de droite, un message « Modifier... » s’affiche. Sélectionnez ce lien pour ouvrir l’Éditeur de propriétés et modifier les variables d’environnement. Pour ajouter plusieurs variables d’environnement, utilisez l’éditeur de propriétés et ajoutez une variable par ligne.
Fusion de l’environnement (Débogueur Windows local) Détermine si les variables spécifiées dans la zone Environnement sont fusionnées avec l’environnement défini par le système d’exploitation. Le paramètre par défaut est Oui.
Débogage SQL (tous sauf le débogueur de cluster MPI) Active le débogage des procédures SQL à partir de votre application Visual C++. Le paramètre par défaut est Non.
Type d'accélérateur de débogage (débogage GPU uniquement) Spécifie l’appareil GPU à utiliser pour le débogage. L’installation des pilotes de périphérique pour les périphériques GPU compatibles ajoute des options supplémentaires. Le paramètre par défaut est GPU - Émulateur logiciel.
Comportement du point d’arrêt par défaut GPU (débogage GPU uniquement) Spécifie si un événement de point d’arrêt doit être déclenché pour chaque thread d’un warp SIMD. Le paramètre par défaut consiste à déclencher l’événement de point d’arrêt une seule fois par warp.
Accélérateur par défaut de l’amp Spécifie l’accélérateur AMP par défaut lors du débogage du code GPU. Choisissez Accélérateur logiciel WARP pour déterminer si un problème est causé par le matériel ou par un pilote, au lieu de votre code.
Répertoire de déploiement (Débogueur Windows distant) Spécifie le chemin d'accès sur l'ordinateur distant où le résultat du projet est copié avant le lancement. Le chemin d’accès peut être un partage réseau sur l’ordinateur distant, ou il peut s’agir d’un chemin d’accès à un dossier sur l’ordinateur distant. Le paramètre par défaut est vide, ce qui signifie que la sortie du projet n’est pas copiée dans un partage réseau. Pour activer le déploiement des fichiers, vous devez également cocher la case Déployer dans la boîte de dialogue Configuration Manager. Pour plus d’informations, consultez Guide pratique pour créer et modifier des configurations.
Fichiers supplémentaires à déployer (débogueur distant Windows) Si la propriété Deployment Directory est définie, il s’agit d’une liste délimitée par des points-virgules de dossiers ou de fichiers supplémentaires à copier dans le répertoire de déploiement. Le paramètre par défaut est vide, ce qui signifie qu’aucun dossier ou fichier supplémentaire n’est copié dans le répertoire de déploiement. Pour copier le contenu d’un dossier dans le même dossier dans le répertoire de déploiement, spécifiez un nom de dossier. Pour activer le déploiement des fichiers, vous devez également cocher la case Déployer dans la boîte de dialogue Configuration Manager. Pour plus d’informations, consultez Guide pratique pour créer et modifier des configurations.
Déployer les bibliothèques runtime de débogage Visual C++ (Débogueur Windows distant) Si la propriété Deployment Directory est définie, cela spécifie si les bibliothèques de runtime de débogage Visual C++ pour la plateforme actuelle doivent être copiées dans le partage réseau. Le paramètre par défaut est Oui.

Dossier C/C++ (catégorie général)

Réglage Description
Format des informations de débogage (/Z7, /Zd, Zi, /ZI) Spécifie le type d'informations de débogage à créer pour le projet.

L’option par défaut (/ZI) crée une base de données de programme (PDB) au format Modifier et Continuer compatible. Pour plus d’informations, consultez /Z7, /Zd, /Zi, /ZI (Format des informations de débogage).

Dossier C/C++ (catégorie Optimisation)

Réglage Description
Optimization Spécifie si le compilateur doit optimiser le code qu’il produit. L’optimisation modifie le code exécuté. Le code optimisé ne correspond plus au code source, ce qui rend le débogage plus difficile.

L’option par défaut (Désactivé (/0d)) supprime l’optimisation. Vous pouvez développer avec l’optimisation supprimée, puis l’activer lorsque vous créez la version de production de votre code.

Dossier Éditeur de liens (catégorie Débogage)

Réglage Description
Générer des infos de débogage (/DEBUG) Indique à l’éditeur de liens d’inclure des informations de débogage, dont le format est spécifié par /Z7, /Zd, Zi ou /ZI.
Générer un fichier de base de données programme (/PDB :name) Spécifiez le nom d’un fichier de base de données de programme (PDB) dans cette zone. Vous devez sélectionner ZI ou /Zi pour Format des informations de débogage.
Suppression des symboles privés (/PDBSTRIPPED:nomfichier) Spécifiez le nom d’un fichier PDB dans cette zone si vous ne souhaitez pas inclure de symboles privés dans le fichier PDB. Cette option crée un deuxième fichier PDB lorsque vous générez votre image de programme avec l’une des options du compilateur ou de l’éditeur de liens qui génèrent un fichier PDB, tel que /DEBUG, /Z7, /Zd. Ou /Zi. Ce deuxième fichier PDB omet les symboles que vous ne souhaitez pas expédier à vos clients. Pour plus d’informations, consultez /PDBSTRIPPED (Supprimer les symboles privés).
Générer fichier de map (/MAP) Indique à l’éditeur de liens de générer un fichier map pendant la liaison. Le paramètre par défaut est Non. Pour plus d’informations, consultez /MAP (Générer un fichier mapfile).
Nom de fichier du mappage (/MAP:name) Si vous choisissez Générer un fichier cartographique, vous pouvez spécifier le fichier map dans cette zone. Pour plus d’informations, consultez /MAP (Générer un fichier mapfile).
Exportations de cartes (/MAPINFO : EXPORTS) Inclut les fonctions exportées dans le fichier map. Le paramètre par défaut est Non. Pour plus d’informations, consultez /MAPINFO (Inclure des informations dans le fichier Mapfile).
Assembly pouvant être débogué (/ASSEMBLYDEBUG) Spécifie les paramètres de l’option Linker /ASSEMBLYDEBUG. Les valeurs possibles sont les suivantes :

- Pas d’attribut Debuggable émis.
- Suivi du runtime et désactiver les optimisations (/ASSEMBLYDEBUG). Il s’agit du paramètre par défaut,
- Pas de suivi du runtime et activer les optimisations (/ASSEMBLYDEBUG:DISABLE).
- <hériter des paramètres par défaut du parent ou du projet>.
- Pour plus d’informations, consultez /ASSEMBLYDEBUG (Ajouter DebuggableAttribute).

Vous pouvez modifier ces paramètres dans le dossier Propriétés de configuration (catégorie Debug) par programmation à l’aide de l’interface Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings. Pour plus d’informations, consultez VCDebugSettings.

Autres paramètres de projet

Pour déboguer des types de projet tels que des bibliothèques statiques et des DLL, votre projet Visual Studio doit être en mesure de trouver les fichiers appropriés. Lorsque le code source est disponible, vous pouvez ajouter des bibliothèques statiques et des DLL en tant que projets distincts à la même solution pour faciliter le débogage. Pour plus d’informations sur la création de ces types de projets, consultez Création et utilisation d’une bibliothèque de liens dynamiques (DLL) et Création d’une bibliothèque statique. Avec le code source disponible, vous pouvez également créer un projet Visual Studio en choisissant Fichier>Nouveau projet>à partir du code existant.

Pour déboguer des DLL externes à votre projet, consultez Débogage de projets DLL. Si vous devez déboguer votre propre projet DLL, mais n’avez pas accès au projet pour l’application appelante, consultez Guide pratique pour déboguer à partir d’un projet DLL.

Voir aussi