Afficher, enregistrer et configurer des fichiers journaux de génération

Après avoir créé un projet dans l’environnement de développement interactif (IDE) de Visual Studio, vous pouvez afficher les informations enregistrées sur le build dans la fenêtre Sortie de Visual Studio. Les données de sortie peuvent être enregistrées dans des fichiers journaux que vous pouvez consulter dans Visual Studio et d’autres éditeurs.

Les journaux peuvent vous aider à résoudre les problèmes liés au build. Vous pouvez localiser les lignes de commande exactes utilisées pour tous les outils de build et obtenir des données de diagnostic complètes sur l’ensemble du processus de build. Visual Studio propose des options pour spécifier les types d’informations que vous souhaitez voir dans la sortie de build et les fichiers journaux de build.

Cet article décrit comment générer, configurer et afficher les fichiers journaux de build dans Visual Studio.

Générer et afficher les fichiers journaux de build

Utilisez les procédures suivantes pour générer et afficher les fichiers journaux de build pour votre scénario.

• Projet C++ :

  Visual Studio enregistre les fichiers journaux pour vous lorsque vous créez votre projet. Les emplacements courants pour les fichiers journaux incluent Release\<NomProjet>.log, Debug\<NomProjet>.log et <NomProjet>.txt. Tous les emplacements de fichiers sont relatifs au dossier racine de votre projet et dépendent de votre configuration spécifique.

  1. Utilisez Windows Explorer ou Explorateur de fichiers pour accéder au fichier journal.

  2. Ouvrez le fichier journal dans l’éditeur de votre choix.

• Projet .NET :

  Pour les projets .NET, vous devez indiquer à Visual Studio d’enregistrer les fichiers journaux :

  1. Dans Visual Studio, sélectionnez Build>Build Solution.

  2. Dans la fenêtre Sortie, sélectionnez le texte et utilisez le raccourci clavier Ctrl+S.

  Visual Studio vous invite à entrer un emplacement pour enregistrer la sortie de génération. Vous pouvez ensuite ouvrir les fichiers journaux à partir de cet emplacement dans Visual Studio ou un autre éditeur.

• MSBuild :

  Vous pouvez générer des journaux de build en exécutant MSBuild directement à partir de la ligne de commande en utilisant l’option de ligne de commande -fileLogger (-fl). Pour plus d’informations, veuillez consulter la section Obtenir des journaux de build avec MSBuild.

Spécifier la verbosité des données pour les journaux de build

Vous pouvez spécifier la quantité d’informations à inclure dans les fichiers journaux de build. La quantité de données dans les colonnes du fichier journal est mesurée en tant que verbosité du journal. Le nombre de lignes de fichier journal représente les messages collectés. La verbosité du journal (valeurs des colonnes) affecte les types de messages enregistrés (valeurs des lignes). La verbosité Silencieuse produit une journalisation minimale dans la sortie de build. Diagnostic est le paramètre le plus verbeux et génère des fichiers journaux avec toutes les données possibles.

Le tableau suivant montre les types de messages collectés en fonction de la verbosité du journal :

Type de message/Verbosité	Quiet	Minimal	Normal	Detailed	Diagnostic
Erreurs	✅	✅	✅	✅	✅
Avertissements	✅	✅	✅	✅	✅
Messages d’importance élevée		✅	✅	✅	✅
Messages d’importance normale			✅	✅	✅
Messages d’importance faible				✅	✅
Autres informations du moteur MSBuild					✅

Vous pouvez configurer la verbosité du journal en suivant les étapes suivantes :

1. Dans Visual Studio, sélectionnez Outils>Options pour ouvrir la boîte de dialogue Options.

2. Dans la boîte de dialogue, développez la section Projets et solutions et sélectionnez l’onglet Générer et exécuter.

3. Utilisez la liste déroulante Verbosité de la sortie de build du projet MSBuild et sélectionnez votre préférence de sortie de build.

4. Utilisez la liste déroulante Verbosité du fichier journal de build du projet MSBuild et sélectionnez votre préférence de verbosité du journal.

   Conseil

   Si vous souhaitez voir les lignes de commande utilisées pour le compilateur et d’autres outils, choisissez au moins le niveau de verbosité Détaillé.

5. Pour appliquer vos modifications, sélectionnez OK.

Important

Vous devez recréer le projet pour que vos modifications prennent effet dans la fenêtre Sortie. Pour les projets C++, la recréation du projet garantit également que les modifications sont reflétées dans le fichier <NomProjet>.txt.

Pour plus d’informations, consultez Options (boîte de dialogue), Projets et solutions, Générer et exécuter et LoggerVerbosity.

Utiliser des journaux binaires pour les fichiers journaux volumineux

Les journaux binaires sont une fonctionnalité facultative pour les projets .NET qui vous permet d’obtenir une expérience de navigation plus riche, ce qui peut faciliter la recherche d’informations dans les journaux volumineux. Pour utiliser des journaux binaires, installez les Outils système de projet 2022. Pour plus d’informations, consultez https://msbuildlog.com et Journal binaire.

Contenu connexe

• Générer et nettoyer des solutions et des projets dans Visual Studio
• Compiler et générer
• Obtenir des journaux de génération avec MSBuild