Просмотр, сохранение и настройка файлов журнала сборки

После сборки проекта в интерактивной среде разработки Visual Studio (IDE) можно просмотреть информацию о сборке в окне вывода Visual Studio. Выходные данные можно сохранить в файлах журнала, которые можно просмотреть в Visual Studio и других редакторах.

Журналы могут помочь выявить и устранить неполадки в сборке. Вы можете найти точные командные строки, используемые для всех средств сборки, и получить полные диагностические данные обо всем процессе сборки. Visual Studio предоставляет параметры для указания типов сведений, которые вы хотите просмотреть в выходных данных сборки и файлах журнала сборки.

В этой статье описывается, как создавать, настраивать и просматривать файлы журналов сборки в Visual Studio.

Создание и просмотр файлов журнала сборки

Используйте следующие процедуры для создания и просмотра файлов журналов сборки для вашего сценария.

• проект C++:

  Visual Studio сохраняет файлы журналов для вас при сборке проекта. Распространенные расположения для файлов журнала включают Выпуск\<ProjectName>.log, Отладка\<ProjectName>.logи <ProjectName>.txt. Все расположения файлов относятся к корневой папке проекта и зависят от конкретной конфигурации.

  1. Используйте Проводник Windows или Файловый Проводник, чтобы перейти к файлу журнала.

  2. Откройте файл журнала в предпочтительном редакторе.

• проект .NET:

  Для проектов .NET вы указываете Visual Studio сохранить файлы журналов:

  1. В Visual Studio выберите Build>Build Solution.

  2. В окне выходных данных выберите текст и используйте сочетание клавиш Ctrl+S.

  Visual Studio запрашивает расположение для сохранения выходных данных сборки. Затем вы можете открыть файлы журналов из этого расположения в Visual Studio или другом редакторе.

• MSBuild:

  Журналы сборки можно создать, выполнив MSBuild непосредственно из командной строки с помощью параметра командной строки -fileLogger (-fl) . Дополнительные сведения см. в статье Получение журналов сборки с помощью MSBuild.

  С помощью MSBuild можно также создавать двоичные журналы (-binaryLogger или параметр командной строки -bl). Двоичные журналы можно просмотреть в структурированном средстве просмотра журналов. Средство просмотра структурированных журналов предоставляет более широкий пользовательский интерфейс, который может упростить понимание сложных процессов сборки.

Вы можете задать переменные среды, чтобы настроить Visual Studio для записи двоичного журнала в файловую систему. Задайте для MSBuildDebugEngine значение 1 и укажите нужное расположение для MSBUILDDEBUGPATH файла журнала сборки. Переменные должны быть заданы в среде, в которой запускается Visual Studio. Эти параметры влияют на все сборки Visual Studio, поэтому может не быть хорошим вариантом, если требуется только журналы для конкретного вызова сборки.

Для более расширенной поддержки пользовательского интерфейса для ведения журнала сборки в проектах .NET рекомендуется установить расширение Project System Tools. При установленном расширении вы можете включать и выключать двоичное логирование в пользовательском интерфейсе, а также выбирать из списка журналов. Однако из-за того, как он интегрируется с системой сборки Visual Studio, журналы немного отличаются от тех, которые вы получите из окна выходных данных или с переменными среды.

Укажите степень детализации данных для журналов сборки

Можно указать, сколько сведений необходимо включить в файлы журнала сборки. Объем данных в столбцах файла журнала измеряется по уровню подробности средства ведения журнала . Количество строк в файле журнала отражает собранных сообщений. Детализация журнала (значения столбцов) влияет на типы зарегистрированных сообщений (значения строк). Тихая детализация создает минимальное ведение журнала в выходных данных сборки. Diagnostic — это наиболее подробная настройка и создает файлы журналов со всеми возможными данными.

В следующей таблице показано, какие типы сообщений собираются в зависимости от уровня детализации логгера:

Тип сообщения / Подробность	Тихий	Минимальный	Нормальный	Подробный	Диагностика
Ошибки	✅	✅	✅	✅	✅
Предупреждения	✅	✅	✅	✅	✅
Сообщения с высокой важностью		✅	✅	✅	✅
Сообщения нормальной важности			✅	✅	✅
Сообщения с низкой важностью				✅	✅
Другие сведения о движке MSBuild					✅

Вы можете настроить детализацию средства ведения журнала следующими шагами:

1. В Visual Studio выберите Средства>Параметры, чтобы открыть диалоговое окно "Параметры".

2. В диалоговом окне разверните раздел Проекты и решения и выберите вкладку Сборка и Запуск.

3. Используйте раскрывающийся список сборки проекта MSBuild, раскрывающийся список и выберите вариант вывода сборки.

4. Используйте раскрывающийся список на для журнала сборки проекта MSBuild и выберите предпочтительный уровень детализации ведения журнала в.

   Совет

   Если вы хотите видеть командные строки, используемые для компилятора и других инструментов, выберите как минимум уровень подробности .

5. Чтобы применить изменения, нажмите кнопку ОК.

Важный

Чтобы изменения вступили в силу в окне выходных данных , необходимо перестроить проект. Для проектов C++ перестроение проекта также гарантирует, что изменения отражаются в файле <ProjectName>.txt.

Дополнительные сведения см. в диалоговом окне "Параметры ", "Проекты и решения", "Сборка и запуск" и LoggerVerbosity.

Использование двоичных журналов для больших файлов журналов

Двоичные журналы — это необязательная функция для проектов .NET, которая позволяет использовать более широкий интерфейс просмотра журналов, что может упростить поиск информации в больших журналах. Чтобы использовать двоичные журналы, установите Project System Tools 2022. Для получения дополнительной информации см. двоичный журнал https://msbuildlog.com и , а также.

Связанное содержимое

• Сборка и очистка проектов и решений в Visual Studio
• Компиляция и сборка
• Получение журналов сборки с помощью MSBuild