Paramètres de projet pour une configuration Debug C++

Article
03/18/2023

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

Remarque

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 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 individuel (.vcxproj.user) de votre solution quand 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 la sélection des propriétés affichées.

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 de démarrage du 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 de la commande spécifiée précédemment. 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 de stderr (2) au même emplacement que stdout (1). 1> &2 Envoie la sortie de stdout (1) au même emplacement que stderr (2). Dans la plupart des cas, ces opérateurs ne peuvent être utilisés que pour les 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 échappent aux commandes précédentes, comme « < » 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 de projet où se trouve votre fichier .EXE. Si vous laissez cette zone 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 attacher 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 voulez déboguer une application. La macro de génération RemoteMachine a la valeur de cette propriété ; pour plus d’informations, consultez Macros pour les propriétés et les commandes de génération.
Connexion (débogueur distant Windows)	Vous permet de commuter entre les types de connexion standard et sans authentification pour le débogage distant. Spécifiez un nom d’ordinateur distant dans la zone Nom de serveur distant. Les types de connexions incluent les éléments suivants : - À distance avec authentification Windows - À distance sans authentification Remarque Le débogage distant sans authentification peut rendre l’ordinateur distant vulnérable face aux atteintes à la sécurité. Le mode 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ù le projet que vous déboguez est localisé.
Type de débogueur	Spécifie le type de débogueur à utiliser : Natif uniquement, Managé uniquement, GPU uniquement, Mixte, Auto (par défaut) ou Script. - Le type Natif uniquement est destiné au code C++ non managé. - Le type Managé uniquement est destiné au code s’exécutant sous le Common Language Runtime (code managé). - Le type Mixte appelle les débogueurs aussi bien pour le code managé que le code non managé. - Le type Auto permet de déterminer le type du débogueur en fonction des informations relatives au compilateur et au fichier .EXE. - Script appelle un débogueur pour les scripts. - GPU uniquement est destiné au code C++ AMP qui s’exécute sur un périphérique GPU ou sur le rastériseur de référence DirectX. Consultez Débogage du code GPU.
Environnement (débogueur Windows local et débogueur Windows distant)	Spécifie les variables d'environnement du programme que vous déboguez. Utilisez la syntaxe de variable d’environnement standard (par exemple `PATH="%SystemRoot%\..."`). Ces variables se substituent à l’environnement système ou fusionnent avec lui, selon le paramètre Fusion de l’environnement. Quand vous cliquez dans la colonne de droite, « Modifier... » s’affiche. Sélectionnez ce lien pour ouvrir l’Éditeur de propriétés et modifier des 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 doivent fusionner 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 de 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 le périphérique GPU à utiliser pour le débogage. L'installation des pilotes de périphériques GPU compatibles ajoutera des options supplémentaires. Le paramètre par défaut est GPU - Émulateur de 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 dans une chaîne SIMD. Le paramètre par défaut consiste à déclencher l'événement de point d'arrêt une seule fois par distorsion.
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ù la sortie de projet sera copiée 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 cocher la case Déployer dans la boîte de dialogue Gestionnaire de configurations. 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é du répertoire de déploiement est définie, il s’agit d’une liste délimitée par des points-virgules des fichiers supplémentaires à copier vers le répertoire de déploiement. Le paramètre par défaut est vide, ce qui signifie qu’aucun fichier ni dossier 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 cocher la case Déployer dans la boîte de dialogue Gestionnaire de configurations. 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é du répertoire de déploiement est définie, elle spécifie si les bibliothèques d'exécution du débogage Visual C++ pour la plateforme actuelle doivent être copiées au partage réseau ou non. Le paramètre par défaut est Oui.

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

Paramètre	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 du programme (PDB) pour Modifier & Continuer. Pour plus d’informations, consultez /Z7, /Zd, /Zi, /ZI (Format des informations de débogage).

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

Paramètre	Description
Optimisation	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 complique le débogage. L’option par défaut (Désactivé (/0d)) supprime l’optimisation. Vous pouvez développer avec l'optimisation supprimée, puis l'activez lors de la création de la version de production de votre code.

Paramètre

Description

Optimisation

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 complique le débogage.

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

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

Paramètre	Description
Générer des infos de débogage (/DEBUG)	Indique à l’Éditeur de liens d’inclure les informations de débogage, qui auront le format spécifié par /Z7, /Zd, Zi ou /ZI.
Génération d’un fichier de base de données du programme (/PDB:nom)	Spécifiez le nom d’un fichier PDB (base de données du programme) 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 voulez pas inclure de symboles privés dans le fichier PDB. Cette option crée un second fichier PDB quand vous générez votre image de programme avec toute option du compilateur ou de l’éditeur de liens générant un fichier PDB, comme /DEBUG, /Z7, /Zd. Ou /Zi. Ce second fichier PDB omet les symboles que vous ne souhaitez pas envoyer à vos clients. Pour plus d’informations, consultez /PDBSTRIPPED (Supprimer les symboles privés).
Génération d’un fichier de mappage (/MAP)	Indique à l'Éditeur de liens de générer un fichier de mappage durant l'édition des liens. Le paramètre par défaut est Non. Pour plus d’informations, consultez l’article /MAP (Générer fichier de mappage).
Nom de fichier du mappage (/MAP:name)	Si vous choisissez Génération d'un fichier de mappage, vous pouvez spécifier le fichier de mappage dans cette zone. Pour plus d’informations, consultez l’article /MAP (Générer fichier de mappage).
Mappage des exportations (/MAPINFO:EXPORTS)	Inclut les fonctions exportées dans le fichier de mappage. Le paramètre par défaut est Non. Pour plus d’informations, consultez /MAPINFO (Inclure des informations dans le fichier de mappage).
Assembly pouvant être débogué (/ASSEMBLYDEBUG)	Spécifie les paramètres de l'option /ASSEMBLYDEBUG de l'Éditeur de liens. Les valeurs possibles sont les suivantes : - Pas d’attribut Debuggable émis. - Suivi du runtime et désactiver les optimisations (/ASSEMBLYDEBUG). Il s'agit de l'option 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 par programme ces paramètres dans le dossier Propriétés de configuration (catégorie Debug) à l’aide de l’interface Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings. Pour plus d’informations, consultez VCDebugSettings.

Autres paramètres du projet

Pour déboguer des types de projet comme les bibliothèques statiques et les DLL, votre projet Visual Studio doit être en mesure de trouver les fichiers corrects. Quand le code source est disponible, vous pouvez ajouter des bibliothèques statiques et des DLL en tant que projets distincts dans la même solution afin de faciliter le débogage. Pour plus d’informations sur la création de ces types de projet, consultez Création et utilisation d’une bibliothèque de liens dynamiques (DLL) et Création et utilisation 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 de 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 que vous n’avez pas accès au projet pour l’application appelante, consultez Guide pratique pour déboguer à partir d’un projet DLL.