Anzeigen, Speichern und Konfigurieren von Buildprotokolldateien

  • Artikel

Nachdem Sie ein Projekt in der Visual Studio-IDE erstellt haben, werden Informationen zu diesem Build im Fenster Ausgabe angezeigt. Anhand dieser Informationen können Sie einen Buildfehler beheben, die genauen Befehlszeilen für alle Buildtools anzeigen oder vollständige Diagnoseinformationen über den gesamten Buildprozess abrufen.

  • Bei C++-Projekten können Sie die gleichen Informationen in einer Protokolldatei anzeigen, die beim Erstellen eines Projekts erstellt und gespeichert wird.

  • Bei .NET-Projekten können Sie in das Buildausgabefenster klicken und STRG+S drücken. Visual Studio fordert Sie auf, einen Speicherort auszuwählen, an dem die Informationen aus dem Ausgabefenster in einer Protokolldatei gespeichert werden sollen.

Sie können die IDE ebenfalls verwenden, um anzugeben, welche Informationen zu jedem Build angezeigt werden sollen.

Wenn Sie ein Projekt mithilfe von MSBuild erstellen, können Sie eine Protokolldatei erstellen, um Informationen zum Build zu speichern. Weitere Informationen finden Sie unter Erhalten von Buildprotokollen.

Anzeigen der Buildprotokolldatei für ein C++-Projekt

  1. Öffnen Sie die folgende Datei über den Windows-Explorer oder den Datei-Explorer (relativ zum Projektstammordner): Release\{Projektname}.Log oder Debug\{Projektname}.log

Erstellen einer Buildprotokolldatei für ein Projekt mit verwaltetem Code

  1. Wählen Sie auf der Menüleiste Erstellen>Projektmappe erstellen aus.

  2. Klicken Sie im Ausgabefenster auf eine beliebige Stelle im Text.

  3. Drücken Sie STRG+S.

    Visual Studio fordert Sie auf, einen Speicherort auszuwählen, an dem die Buildausgabe gespeichert werden soll.

Sie können auch Protokolle generieren, indem Sie MSBuild direkt von der Befehlszeile ausführen. Verwenden Sie dabei die Befehlszeilenoption -fileLogger (-fl). Informationen dazu finden Sie unter Erhalten von Buildprotokollen mit MSBuild.

Ändern der Informationsmenge im Buildprotokoll

  1. Klicken Sie in der Menüleiste auf Extras>Optionen.

  2. Klicken Sie auf der Seite Projekte und Projektmappen auf Erstellen und Ausführen.

  3. Wählen Sie einen der folgenden Werte aus der Liste Ausführlichkeit der MSBuild-Projektbuildausgabe aus, und klicken Sie dann auf die Schaltfläche OK.

In der folgenden Tabelle wird gezeigt, wie sich die Ausführlichkeit der Protokolle (Spaltenwerte) darauf auswirkt, welche Nachrichtentypen (Zeilenwerte) protokolliert werden.

Nachrichtentyp/Ausführlichkeit Quiet Minimal Normal Detailliert Diagnose
Fehler ✅ ✅ ✅ ✅ ✅
Warnungen ✅ ✅ ✅ ✅ ✅
Nachrichten mit hoher Priorität ✅ ✅ ✅ ✅
Nachrichten mit normaler Priorität ✅ ✅ ✅
Nachrichten mit niedriger Priorität ✅ ✅
Zusätzliche Informationen zur MSBuild-Engine ✅

Wenn Sie die für den Compiler und andere Tools verwendeten Befehlszeilen anzeigen möchten, wählen Sie mindestens die Ausführlichkeitsebene Detailliert aus.

Weitere Informationen finden Sie unter Optionen (Dialogfeld), Projekte und Projektmappen, Erstellen und Ausführen und LoggerVerbosity.

Wichtig

Sie müssen das Projekt neu erstellen, damit Ihre Änderungen im Fenster Ausgabe (alle Projekte) und in der Datei <Projektname>.txt (nur C++-Projekte) übernommen werden.

Verwenden von Binärprotokollen, um das Durchsuchen großer Protokolldateien zu vereinfachen

Binärprotokolle sind ein optionales Feature für .NET-Projekte, mit dem das Suchen von Informationen in umfangreichen Protokollen benutzerfreundlicher und einfacher wird. Um Binärprotokolle zu verwenden, installieren Sie die Projektsystemtools. Weitere Informationen finden Sie unter https://msbuildlog.com und Binärprotokoll.

Binärprotokolle sind ein optionales Feature für .NET-Projekte, mit dem das Suchen von Informationen in umfangreichen Protokollen benutzerfreundlicher und einfacher wird. Um Binärprotokolle zu verwenden, installieren Sie Project System Tools 2022. Weitere Informationen finden Sie unter https://msbuildlog.com und Binärprotokoll.

Zugehöriger Inhalt