Share via


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

Vous pouvez modifier les paramètres du projet pour le c ou la configuration de débogage de 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.

Mise en gardeAttention

Les paramètres du projet de débogage dans la catégorie de Propriétés de configuration/débogage pour windows stockent des applications et des composants écrits en C++ sont différents.Consultez Comment : démarrer une session de débogage (Visual C++, Visual C# et Visual Basic) 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 distant windows)

Spécifie le nom d'un ordinateur (autre que le vôtre) sur lequel vous souhaitez déboguer une application ou un nom de serveur Msvsmon.Vous pouvez également sélectionner le paramètre à partir de la boîte de dialogue Processus (pour plus d'informations, consultez Sélection d'un ordinateur distant).Si vous spécifiez le nom de l'ordinateur à cet emplacement, vous devez également indiquer le type de connexion dans Connexion.

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)

Le débogage distant deNotez sans l'authentification peut laisser l'ordinateur distant vulnérable à des violations de 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 Automatique 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 pour le code C++ ampère qui s'exécute sur un appareil de GPU ou sur le rastériseur de référence DirectX.

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

Spécifie le périphérique de GPU à utiliser pour le débogage.Installer les pilotes de périphérique pour les appareils compatibles de GPU ajoute des options supplémentaires.Le paramètre par défaut est « GPU - émulateur de logiciel. »

Comportement de point d'arrêt par défaut de GPU (GPU débogage uniquement)

Spécifie si un événement point d'arrêt doit être déclenché pour chaque thread dans une chaîne de SIMD.Le paramètre par défaut consiste à déclencher l'événement point d'arrêt une seule fois par chaîne.

répertoire de déploiement (Débogueur distant windows)

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 peut être 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 de projet n'est pas copié 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 configuration.Pour plus d’informations, consultez Comment : 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, c'est 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 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 configuration.Pour plus d’informations, consultez Comment : créer et modifier des configurations.

Déployez les bibliothèques runtime du débogage Visual C++ (Débogueur distant windows)

Si la propriété du répertoire de déploiement est définie, spécifie si les bibliothèques runtime du débogage Visual C++ pour la plateforme actuelle doivent être copiées vers le partage réseau.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).

Pour plus d'informations, consultez Fichiers PDB et Fichiers DBG.

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ération des informations 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 /PDBSTRIPPED 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 de)

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 activer 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 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