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

  • Article

Après avoir généré un projet dans l’IDE de Visual Studio, vous pouvez consulter les informations sur cette génération dans la fenêtre Sortie. Avec ces informations, vous pouvez résoudre un échec de génération, voir les lignes de commande exactes utilisées pour tous les outils de génération ou obtenir des informations de diagnostic complètes sur l’ensemble du processus de génération.

  • Pour les projets C++, vous pouvez également voir les mêmes informations dans un fichier journal créé et enregistré quand vous générez un projet.

  • Pour les projets .NET, vous pouvez cliquer dans la fenêtre de sortie de build et appuyer sur Ctrl+S. Visual Studio vous invite à entrer un emplacement pour enregistrer les informations de la fenêtre Sortie dans un fichier journal.

Vous pouvez également utiliser l’IDE pour spécifier les types d’informations à afficher pour chaque génération.

Si vous générez un projet à l’aide de MSBuild, vous pouvez créer un fichier journal pour y enregistrer les informations de build. Pour plus d’informations, consultez Obtenir des journaux de génération.

Pour afficher le fichier journal de génération d’un projet C++

  1. Dans l’Explorateur Windows ou l’Explorateur de fichiers, ouvrez le fichier suivant (chemin relatif par rapport au dossier racine du projet) : Release\{NomProjet}.Log ou Debug\{NomProjet}.log

Pour créer un fichier journal de génération d’un projet de code managé

  1. Dans la barre de menus, choisissez Générer>Générer la solution.

  2. Dans la fenêtre Sortie, cliquez quelque part dans le texte.

  3. Appuyez sur Ctrl+Tab.

    Visual Studio vous invite à entrer un emplacement pour enregistrer la sortie de génération.

Vous pouvez également générer des journaux en exécutant MSBuild directement à partir de la ligne de commande, à l’aide de l’option de ligne de commande -fileLogger (-fl). Consultez Obtenir des journaux de génération avec MSBuild.

Pour modifier la quantité d’informations contenues dans le journal de génération

  1. Dans la barre de menus, choisissez Outils>Options.

  2. Dans la page Projets et solutions, choisissez la page Générer et exécuter.

  3. Dans la liste Verbosité de la sortie de build du projet MSBuild, choisissez l’une des valeurs suivantes, puis sélectionnez le bouton OK.

Le tableau suivant montre comment le niveau de détail du journal (valeurs de colonne) affecte les types de messages (valeurs de ligne) qui sont enregistrés.

Type de message/Verbosité Quiet Minimal Normal Detailed Diagnostic
Erreurs ✅ ✅ ✅ ✅ ✅
Avertissements ✅ ✅ ✅ ✅ ✅
Messages avec une importance haute ✅ ✅ ✅ ✅
Messages d’importance normale ✅ ✅ ✅
Messages de faible importance ✅ ✅
Informations supplémentaires du moteur MSBuild ✅

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

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

Important

Vous devez regénérer le projet pour que vos modifications soient appliquées dans la fenêtre Sortie (tous les projets) et dans le fichier <NomProjet>.txt (projets C++ uniquement).

Utiliser des journaux binaires pour faciliter la navigation dans 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. Pour plus d’informations, consultez https://msbuildlog.com et Journal binaire.

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