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.

  Avec MSBuild, vous pouvez également générer des journaux binaires (option de ligne de commande -binaryLogger ou -bl). Vous pouvez visualiser les journaux binaires dans le Visualisateur de journaux structurés. La visionneuse de journaux structurés offre une interface utilisateur plus riche qui peut faciliter la compréhension de processus de construction complexes.

Vous pouvez définir des variables d'environnement pour configurer Visual Studio afin qu'il écrive un journal binaire dans le système de fichiers. Réglez MSBuildDebugEngine sur 1 et réglez MSBUILDDEBUGPATH sur l'emplacement souhaité du fichier journal de construction. Les variables doivent être définies dans l'environnement dans lequel Visual Studio est lancé. Ces paramètres affectent tous les processus de construction de Visual Studio, ce qui n'est pas forcément une bonne option si vous ne voulez des journaux que pour une invocation particulière du processus de construction.

Pour une prise en charge plus avancée de l'interface utilisateur pour la journalisation de la construction dans les projets .NET, envisagez d'installer l'extension Project System Tools. Une fois l'extension installée, vous pouvez activer et désactiver la journalisation binaire dans l'interface utilisateur et choisir parmi une liste de journaux. Cependant, en raison de la façon dont il s'intègre au système de construction de Visual Studio, les journaux sont un peu différents de ceux que vous obtiendriez à partir de la fenêtre de sortie, ou avec les variables d'environnement.

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