Afficher, enregistrer et configurer les fichiers journaux de compilation

Après avoir généré un projet dans l’environnement de développement interactif Visual Studio (IDE), vous pouvez afficher les informations journalisées sur la génération dans la Fenêtre Sortie Visual Studio. Les données de sortie peuvent être enregistrées dans les fichiers journaux que vous pouvez afficher dans Visual Studio et d’autres éditeurs.

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

Cet article explique comment générer, configurer et afficher des fichiers journaux de génération dans Visual Studio.

Générez et affichez des fichiers journaux de génération

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

• projet C++:

  Visual Studio enregistre les fichiers journaux pour vous lorsque vous générez votre projet. Les emplacements courants pour les fichiers journaux incluent Release\<ProjectName>.log, Debug\<ProjectName>.loget <ProjectName>.txt. Tous les emplacements de fichiers sont relatifs à votre dossier racine de projet et en fonction de votre configuration spécifique.

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

  2. Ouvrez le fichier journal dans votre éditeur préféré.

• projet .NET:

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

  1. Dans Visual Studio, sélectionnez Générer>Générer la 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 génération en exécutant MSBuild directement depuis la ligne de commande en utilisant l’option de ligne de commande -fileLogger (-fl). Pour plus d’informations, consultez Obtenir des journaux de génération avec MSBuild.

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

Vous pouvez définir des variables d’environnement pour configurer Visual Studio pour écrire un journal binaire dans le système de fichiers. Définissez MSBuildDebugEngine sur 1 et définissez MSBUILDDEBUGPATH sur l’emplacement souhaité du fichier journal de build. Les variables doivent être définies dans l’environnement dans lequel Visual Studio est lancé. Ces paramètres affectent toutes les builds Visual Studio. Cela peut donc ne pas être une bonne option si vous souhaitez uniquement des journaux d’activité pour un appel particulier de la build.

Pour une prise en charge plus avancée de l’interface utilisateur pour la journalisation des builds 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, puis choisir parmi la liste des journaux. Toutefois, en raison de la manière dont il s'intègre avec le système de génération de Visual Studio, les journaux diffèrent légèrement de ceux que vous obtiendriez depuis la fenêtre Sortie, ou avec les variables d'environnement.

Spécifiez la verbosité des données pour les journaux de génération

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

Le tableau suivant montre quels types de messages sont collectés en fonction du niveau de verbosité de l’enregistreur :

Type de message/Verbosité	Quiet	Minimal	Normale	Détaillé	Diagnostique
Erreurs	✅	✅	✅	✅	✅
Avertissements	✅	✅	✅	✅	✅
Messages d’importance élevée		✅	✅	✅	✅
Messages d’importance normale			✅	✅	✅
Messages de faible importance				✅	✅
Autres informations MSBuild-engine					✅

Vous pouvez configurer le niveau de verbosité de l’enregistreur en procédant comme suit :

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

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

3. Utilisez la liste déroulante de la verbosité de sortie de génération du projet MSBuild et sélectionnez votre préférence de sortie de génération.

4. Utilisez la liste déroulante de la verbosité de fichier journal de génération du projet MSBuild et sélectionnez votre préférence de niveau de verbosité de l’enregistreur.

   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 reconstruire le projet pour que vos modifications prennent effet dans la fenêtre Sortie. Pour les projets C++, la reconstruction du projet garantit également que les modifications sont reflétées dans le fichier <ProjectName>.txt.

Pour plus d’informations, consultez boîte de dialogue Options, 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’avoir une expérience de navigation de journal plus riche 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 projets et des solutions dans Visual Studio
• Compiler et générer
• Obtenir des journaux de génération avec MSBuild