Anzeigen, Speichern und Konfigurieren von Buildprotokolldateien

Nachdem Sie ein Projekt in der Visual Studio Interactive Development Environment (IDE) erstellt haben, können Sie protokollierte Informationen zum Build im Visual Studio-Ausgabefenster anzeigen. Die Ausgabedaten können in Protokolldateien gespeichert werden, die Sie in Visual Studio und anderen Editoren anzeigen können.

Die Protokolle können Ihnen beim Beheben von Problemen im Build helfen. Sie können die genauen Befehlszeilen finden, die für alle Buildtools verwendet werden, und vollständige Diagnosedaten über den gesamten Buildprozess abrufen. Visual Studio bietet Optionen zum Angeben der Arten von Informationen, die in den Buildausgabe- und Buildprotokolldateien angezeigt werden sollen.

In diesem Artikel wird beschrieben, wie Sie Buildprotokolldateien in Visual Studio generieren, konfigurieren und anzeigen.

Erstellen und Anzeigen von Buildprotokolldateien

Verwenden Sie die folgenden Verfahren, um Buildprotokolldateien für Ihr Szenario zu generieren und anzuzeigen.

• C++-Projekt:

  Visual Studio speichert die Protokolldateien für Sie, wenn Sie Ihr Projekt erstellen. Allgemeine Speicherorte für die Protokolldateien sind Release\<ProjectName>.log, Debug\<ProjectName>.logund <ProjectName>.txt. Alle Dateispeicherorte sind relativ zu Ihrem Projektstammordner und basieren auf Ihrer spezifischen Konfiguration.

  1. Verwenden Sie Windows Explorer oder Datei-Explorer, um zur Protokolldatei zu navigieren.

  2. Öffnen Sie die Protokolldatei in Ihrem bevorzugten Editor.

• .NET-Projekt:

  Für .NET-Projekte weisen Sie Visual Studio an, die Protokolldateien zu speichern:

  1. Wählen Sie in Visual Studio Build>Build Solutionaus.

  2. Markieren Sie im Fenster Ausgabe den Text, und verwenden Sie die Tastenkombination STRG+S.

  Visual Studio fordert Sie auf, einen Speicherort zum Speichern der Buildausgabe einzugeben. Anschließend können Sie die Protokolldateien von diesem Speicherort in Visual Studio oder einem anderen Editor öffnen.

• MSBuild:

  Sie können Buildprotokolle generieren, indem Sie MSBuild direkt über die Befehlszeile ausführen, indem Sie die Befehlszeilenoption -fileLogger (-fl) verwenden. Weitere Informationen finden Sie unter Abrufen von Buildprotokollen mit MSBuild.

  Mit MSBuild können Sie auch binärprotokolle generieren (-binaryLogger oder -bl Befehlszeilenoption). Sie können binärprotokolle im Structured Log Vieweranzeigen. Der strukturierte Protokoll-Viewer bietet eine umfangreichere Benutzeroberfläche, die das Verständnis komplexer Buildprozesse erleichtern kann.

Sie können Umgebungsvariablen festlegen, um Visual Studio so zu konfigurieren, dass ein binäres Protokoll in das Dateisystem geschrieben wird. Legen Sie MSBuildDebugEngine auf 1 fest, und legen Sie MSBUILDDEBUGPATH auf den gewünschten Speicherort der Buildprotokolldatei fest. Die Variablen müssen in der Umgebung festgelegt werden, in der Visual Studio gestartet wird. Diese Einstellungen wirken sich auf alle Visual Studio-Builds aus, daher ist dies möglicherweise keine gute Option, wenn Sie nur Protokolle für einen bestimmten Aufruf des Builds verwenden möchten.

Für erweiterte Ui-Unterstützung für die Buildprotokollierung in .NET-Projekten sollten Sie die erweiterung Project System Toolsinstallieren. Wenn die Erweiterung installiert ist, können Sie die binäre Protokollierung in der Benutzeroberfläche aktivieren und deaktivieren und aus einer Liste der Protokolle auswählen. Aufgrund der Integration in das Visual Studio-Buildsystem unterscheiden sich die Protokolle jedoch etwas von denen, die Sie vom Ausgabefenster oder durch die Verwendung von Umgebungsvariablen erhalten würden.

Angeben der Ausführlichkeit von Daten für Buildprotokolle

Sie können angeben, wie viele Informationen in die Buildprotokolldateien aufgenommen werden sollen. Die Datenmenge in den Protokolldateispalten wird als Ausführlichkeit des Loggers gemessen. Die Anzahl der Zeilen in der Protokolldatei stellt die gesammelten Nachrichten dar. Die Ausführlichkeit des Protokolls (Spaltenwerte) wirkt sich auf die Typen der protokollierten Nachrichten (Zeilenwerte) aus. Durch die Ausführlichkeit im stillen Modus wird eine minimale Protokollierung in der Buildausgabe erzeugt. Diagnose- ist die ausführlichste Einstellung und generiert Protokolldateien mit allen möglichen Daten.

Die folgende Tabelle zeigt, welche Arten von Nachrichten basierend auf der Ausführlichkeit des Loggers gesammelt werden:

Nachrichtentyp/Ausführlichkeit	Ruhig	Minimal	Normal	Detailliert	Diagnostik
Irrtümer	✅	✅	✅	✅	✅
Warnungen	✅	✅	✅	✅	✅
Nachrichten mit hoher Wichtigkeit		✅	✅	✅	✅
Nachrichten mit normaler Wichtigkeit			✅	✅	✅
Nachrichten mit niedriger Wichtigkeit				✅	✅
Weitere MSBuild-Engine-Informationen					✅

Sie können die Ausführlichkeit des Loggers mit den folgenden Schritten konfigurieren:

1. Wählen Sie in Visual Studio Extras>Optionen aus, um das Dialogfeld Optionen zu öffnen.

2. Erweitern Sie im Dialogfeld den Abschnitt Projekte und Lösungen, und wählen Sie die Registerkarte Erstellen und Ausführen aus.

3. Verwenden Sie die Dropdownliste Ausführlichkeit der MSBuild-Projektbuildausgabe, und wählen Sie Ihre bevorzugten Einstellungen für die Buildausgabe aus.

4. Verwenden Sie die Dropdownliste Ausführlichkeit der Protokolldatei des MSBuild-Projektbuilds, und wählen Sie Ihre bevorzugten Einstellungen für die Ausführlichkeit des Loggers aus.

   Tipp

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

5. Um Ihre Änderungen anzuwenden, wählen Sie OKaus.

Wichtig

Sie müssen das Projekt neu erstellen, damit die Änderungen im Fenster Ausgabe wirksam werden. Bei C++-Projekten stellt die Projektneustellung außerdem sicher, dass die Änderungen in der <ProjectName->.txt-Datei widerspiegelt werden.

Weitere Informationen finden Sie im Dialogfeld Optionen, Projekte und Lösungen, Erstellen und Ausführen von und LoggerVerbosity.

Verwenden von binären Protokollen für große Protokolldateien

Binäre Protokolle sind ein optionales Feature für .NET-Projekte, mit dem Sie eine umfangreichere Erfahrung beim Durchsuchen von Protokollen haben können, die das Auffinden von Informationen in großen Protokollen vereinfachen können. Um binäre Protokolle zu verwenden, installieren Sie die Project System Tools 2022. Weitere Informationen finden Sie unter https://msbuildlog.com und Binärprotokoll.

Verwandte Inhalte

• Erstellen und Bereinigen von Projekten und Lösungen in Visual Studio
• Kompilieren und Erstellen
• Abrufen von Buildprotokollen mit MSBuild