Partager via


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

Vous pouvez modifier les paramètres de projet pour une configuration de débogage C ou Visual C++ dans la boîte de dialogue Pages de propriétés, comme indiqué dans Comment : 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.

Avertissement

Les paramètres du projet de débogage dans la catégorie Propriétés de configuration/Débogage pour les applications Windows Store et les composants écrits en C++ sont différents.Voir Démarrer une session de débogage pour une application du Windows Store dans Visual Studio (VB, C#, C++ et XAML) dans le Centre de développement Windows.

Spécifiez le débogueur à utiliser dans la zone de liste Débogueur à lancer. Votre choix affecte la sélection des propriétés affichées.

Chaque paramètre de propriété de débogage est automatiquement écrit et enregistré dans le fichier individuel (.vcxproj.user) de votre solution chaque fois que vous enregistrez votre solution.

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 et 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.

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 distant, le répertoire du projet est 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 (Natif uniquement)

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 pour le 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)

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. Lorsque vous cliquez dans la colonne de paramètres, « Modifier... » apparaît. Cliquez sur ce lien pour modifier des variables d'environnement.

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 (Débogage GPU uniquement)

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 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 également activer la case à cocher Déployer dans la boîte de dialogue Gestionnaire de configurations. Pour plus d'informations, consultez Comment : créer et modifier des configurations.

Fichiers supplémentaires à déployer (débogueur distant Windows)

Si le répertoire de déploiement est défini, il s'agit d'une liste délimitée par des points-virgules pour les 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 supplémentaire n'est copié dans le répertoire de déploiement. Pour activer le déploiement des fichiers, vous devez également activer la case à cocher Déployer dans la boîte de dialogue Gestionnaire de configurations. Pour plus d'informations, consultez Comment : 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. Par conséquent, le débogage est difficile.

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:name)

Spécifiez le nom d'un fichier 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 voulez pas inclure de symboles privés dans le fichier PDB. Cette option crée un second fichier PDB (Program Database) lorsque 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 /MAP (Générer fichier de mappage).

Nom de mappage(/MAP :nom)

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 /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.

Voir aussi

Référence

/ASSEMBLYDEBUG (Ajouter DebuggableAttribute)

Autres ressources

Débogage du code natif

Paramètres et préparation du débogage

Création et gestion de projets Visual C++

Macros pour les propriétés et les commandes de génération