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

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

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

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

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

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

• Проект C++:

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

  1. Перейдите к файлу журнала с помощью обозревателя Windows или проводник.

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

• Проект .NET:

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

  1. В Visual Studio выберите "Сборка решения сборки>".

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

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

• MSBuild:

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

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

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

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

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

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

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

Тип сообщений/уровень детализации	Тихий NaN	Минимальные	Обычная	Подробно	Диагностика
ошибки	✅	✅	✅	✅	✅
Предупреждения	✅	✅	✅	✅	✅
Сообщения с высокой важностью		✅	✅	✅	✅
Сообщения о нормальной важности			✅	✅	✅
Сообщения с низкой важностью				✅	✅
Другие сведения о подсистеме 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