Wyświetlanie, zapisywanie i konfigurowanie plików dziennika kompilacji

Po skompilowaniu projektu w interaktywnym środowisku projektowym programu Visual Studio można wyświetlić zarejestrowane informacje o kompilacji w oknie Dane wyjściowe programu Visual Studio. Dane wyjściowe można zapisywać w plikach dziennika, które można wyświetlać w programie Visual Studio i innych edytorach.

Dzienniki mogą pomóc w rozwiązywaniu problemów w kompilacji. Możesz zlokalizować dokładne wiersze polecenia używane dla wszystkich narzędzi kompilacji i uzyskać pełne dane diagnostyczne dotyczące całego procesu kompilacji. Program Visual Studio udostępnia opcje określania rodzajów informacji, które mają być widoczne w danych wyjściowych kompilacji i plikach dziennika kompilacji.

W tym artykule opisano sposób generowania, konfigurowania i wyświetlania plików dziennika kompilacji w programie Visual Studio.

Generowanie i wyświetlanie plików dziennika kompilacji

Użyj poniższych procedur, aby wygenerować i wyświetlić pliki dziennika kompilacji dla danego scenariusza.

• Projekt C++:

  Program Visual Studio zapisuje pliki dziennika podczas tworzenia projektu. Typowe lokalizacje plików dziennika to Release\<ProjectName>.log, Debug\<ProjectName>.log, i <ProjectName>.txt. Wszystkie lokalizacje plików są względne względem folderu głównego projektu i na podstawie Twojej specyficznej konfiguracji.

  1. Użyj Eksploratora Windows lub Eksploratora plików , aby przejść do pliku dziennika.

  2. Otwórz plik dziennika w preferowanym edytorze.

• Projekt platformy .NET:

  W przypadku projektów .NET należy poinstruować program Visual Studio, aby zapisać pliki dziennika:

  1. W programie Visual Studio wybierz pozycję Build>Build Solution.

  2. W oknie Dane wyjściowe wybierz tekst i użyj skrótu klawiaturowego Ctrl+S .

  Program Visual Studio poprosi o lokalizację do zapisania wyniku kompilacji. Następnie możesz otworzyć pliki dziennika z tej lokalizacji w programie Visual Studio lub innym edytorze.

• MSBuild:

  Dzienniki kompilacji można wygenerować, uruchamiając program MSBuild bezpośrednio z poziomu wiersza polecenia przy użyciu -fileLogger opcji wiersza polecenia (-fl). Aby uzyskać więcej informacji, zobacz Uzyskiwanie dzienników kompilacji za pomocą programu MSBuild.

  Za pomocą MSBuild można również wygenerować dzienniki binarne (-binaryLogger lub -bl opcje wiersza polecenia). Dzienniki binarne można wyświetlić w podglądzie dzienników strukturalnych. Przeglądarka dzienników strukturalnych udostępnia bogatszy interfejs użytkownika, który może ułatwić zrozumienie złożonych procesów kompilacji.

Zmienne środowiskowe można ustawić, aby skonfigurować program Visual Studio w celu zapisania dziennika binarnego w systemie plików. Ustaw MSBuildDebugEngine na 1 i ustaw MSBUILDDEBUGPATH na żądaną lokalizację pliku dziennika kompilacji. Zmienne muszą być ustawiane w środowisku, w którym jest uruchamiany program Visual Studio. Te ustawienia mają wpływ na wszystkie kompilacje programu Visual Studio, więc może nie być dobrą opcją, jeśli chcesz tylko dzienniki dla konkretnego wywołania kompilacji.

Aby uzyskać bardziej zaawansowaną obsługę interfejsu użytkownika na potrzeby rejestrowania kompilacji w projektach platformy .NET, rozważ zainstalowanie rozszerzenia Project System Tools. Po zainstalowaniu rozszerzenia można włączyć i wyłączyć logowanie binarne w interfejsie użytkownika, a następnie wybrać jedną z list dzienników. Jednak ze względu na sposób integracji z systemem kompilacji programu Visual Studio dzienniki różnią się nieco od tych, które można uzyskać z okna Dane wyjściowe lub ze zmiennymi środowiskowymi.

Określanie szczegółowości danych dla dzienników kompilacji

Możesz określić, ile informacji należy uwzględnić w plikach dziennika kompilacji. Ilość danych w kolumnach pliku dziennika jest mierzona jako szczegółowość rejestratora. Liczba wierszy pliku dziennika reprezentuje zebrane komunikaty. Poziom szczegółowości dziennika (wartości kolumn) wpływa na typy zarejestrowanych komunikatów (wartości wierszy). Cicha szczegółowość logowania powoduje minimalne logowanie w wynikach kompilacji. Diagnostyka to najbardziej pełne ustawienie i generuje pliki dziennika ze wszystkimi możliwymi danymi.

W poniższej tabeli przedstawiono typy komunikatów zbieranych w zależności od stopnia szczegółowości rejestratora.

Typ komunikatu / Szczegółowość	Spokojny	Minimalny	Normal	Szczegółowy	Diagnostic
Errors	✅	✅	✅	✅	✅
Warnings	✅	✅	✅	✅	✅
Komunikaty o wysokiej ważności		✅	✅	✅	✅
Komunikaty o normalnym znaczeniu			✅	✅	✅
Komunikaty o niskiej ważności				✅	✅
Informacje o innych silnikach MSBuild					✅

Można skonfigurować szczegółowość rejestratora, wykonując następujące czynności:

1. Otwórz okienko Narzędzia>Opcje i rozwiń sekcję Wszystkie ustawienia>Projekty i rozwiązania>Budowanie i uruchamianie.

2. Użyj listy rozwijanej szczegółowości danych wyjściowych kompilacji projektu MSBuild i wybierz preferencję danych wyjściowych kompilacji.

3. Użyj listy rozwijanej plik dziennika kompilacji projektu MSBuild i wybierz preferencję szczegółowości rejestratora.

   Wskazówka

   Jeśli chcesz wyświetlić wiersze polecenia używane dla kompilatora i innych narzędzi, wybierz co najmniej poziom Szczegółowy.

Ważne

Należy ponownie skompilować projekt, aby zmiany zaczęły obowiązywać w oknie Dane wyjściowe . W przypadku projektów języka C++ ponowne kompilowanie projektu gwarantuje również, że zmiany zostaną odzwierciedlone w <pliku ProjectName>.txt .

Aby uzyskać więcej informacji, zobacz Opcje okno dialogowe, Projekty i rozwiązania, Kompilowanie i uruchamianie iLoggerVerbosity.

Używanie dzienników binarnych dla dużych plików dziennika

Dzienniki binarne to opcjonalna funkcja dla projektów platformy .NET, która umożliwia korzystanie z bogatszego środowiska przeglądania dzienników, które może ułatwić znajdowanie informacji w dużych dziennikach. Aby użyć dzienników binarnych, zainstaluj narzędzia Project System Tools 2022. Aby uzyskać więcej informacji, zobacz https://msbuildlog.com i Dziennik binarny.

Treści powiązane

• kompilowanie i czyszczenie projektów i rozwiązań w programie Visual Studio
• Kompilowanie i budowanie
• Uzyskiwanie dzienników kompilacji za pomocą programu MSBuild