# Настраиваем статический анализ Unreal Engine проекта В PVS\-Studio давно есть возможность анализировать Unreal Engine проекты\. Но с момента последней заметки мы много работали над этим режимом\. Поэтому хочу рассказать о том, как быстро настроить наш анализатор для проверки вашего проекта на Unreal Engine\. ![1110_UnrealEngine_project_configuration_ru/image1.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image1.png) Лучше всего рассмотреть проверку Unreal Engine проекта на реальном примере\. В качестве подопытного проекта возьмём Lyra — пример игры, который Epic Games представили вместе с выпуском Unreal Engine 5\.0\. Lyra является многомодульным проектом, который служит для знакомства с возможностями UE5\. Работа с проектом будет проходить на Windows\. Cобирать будем с использованием Unreal Engine 5\.3\.2\. Для анализа возьмём PVS\-Studio 7\.29\. ## Установка PVS\-Studio Сам инсталлятор PVS\-Studio можно найти на [этой странице](https://pvs-studio.ru/ru/pvs-studio/download/)\. Для анализа Unreal Engine проектов способом, приведённым в этой статье, нужна Enterprise лицензия\. Вы можете получить триальную Enterprise лицензию по [этой ссылке](https://pvs-studio.ru/ru/pvs-studio/try-free/)\. Процесс установки довольно прост: достаточно запустить инсталлятор и следовать его инструкциям\. В качестве дополнительных компонентов потребуется только плагин для Visual Studio 2022\. Процесс установки описан в [документации](https://pvs-studio.ru/ru/pvs-studio-quickstart-cppwindows/)\. Запросить и ввести лицензию можно также сразу в инсталляторе\. ## Запуск анализа Процесс анализа UE проектов отличается от анализа других проектов\. При попытке запустить анализ стандартными методами, например, через плагин для Visual Studio, выведется предупреждение о невозможности выполнить анализ\. Такое поведение связано с особенностями организации запуска анализа UE проектов\. Для их сборки используется _UnrealBuildTool_, и анализ запускается именно через него\. Для того, чтобы провести именно статический анализ проекта, а не его сборку, сам проект нужно сконфигурировать\. Для Unreal Engine проектов есть три способа определения конфигурации: 1. Передача флагов напрямую в _UnrealBuildTool_; 1. Задание параметров в _\.target\.cs_ файлах; 1. Включение настроек в файл _BuildConfiguration\.xml_ \(обычно находится в _%appdata%\\Unreal Engine\\UnrealBuildTool_\)\. Каждый вариант имеет свои особенности и подходит под разные сценарии использования\. Первый вариант позволяет задать настройки для конкретной конфигурации и конкретной команды \(**Build/Rebuild**\)\. Второй способ определяет конфигурацию для определённого типа таргетов \(подробнее про таргеты можете узнать [здесь](https://docs.unrealengine.com/5.2/en-US/unreal-engine-build-tool-target-reference/)\)\. А третий вариант можно использовать для глобальных настроек UE проектов\. Для начала анализа используем первый способ, а дальше я расскажу, как можно использовать второй\. Для старта анализа нужно передать в _UnrealBuildTool_ специальный флаг: ```cpp -StaticAnalyzer=PVSStudio ``` В Visual Studio это можно сделать, добавив этот флаг в _NMake_ команду проекта и запустив сборку\. Для этого откройте свойства проекта, выберите _NMake_ и впишите флаг в поле **Build Command Line**\. ![1110_UnrealEngine_project_configuration_ru/image2.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image2.png) Анализ в этом случает заменит собой сборку проекта\. Если добавлять флаг анализатора в команду _Rebuild_, то при каждом её вызове будет происходить анализ всего проекта\. Если модифицировать команду _Build_, то при её запуске будут проверяться только изменённые файлы\. В [полной документации](https://pvs-studio.ru/ru/docs/manual/0043/#ID5219D77B4B) вы можете подробнее узнать о сценарии запуска сборки и анализа проекта\. Запуск через _NMake_ доступен, если открывать Unreal Engine проект через _\.sln_ файл\. В JetBrains Rider существует возможность запускать UE проекты напрямую через _\.uproject_\. В этом случае модификация _NMake_ команд недоступна и используется вариант с указанием параметра **StaticAnalyzer** в _\.target\.cs_ файле\. По умолчанию при анализе UE проекта отчёт не открывается в окне плагина PVS\-Studio\. Чтобы отчёт анализа загрузился в таблицу плагина, перед началом анализа нужно включить настройку **AutoloadUnrealEngineLog**\. Сам отчёт сохраняется в подпапке проекта _Saved/PVS\-Studio_ \(в случае Lyra – _"\\LyraStarterGame\\Saved\\PVS\-Studio\\LyraGame\.pvslog"_\) Запускаем анализ и видим перед собой такую картину: ![1110_UnrealEngine_project_configuration_ru/image3.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image3.png) Анализируются модули, а не исходные файлы проекта\. Плюс к этому в таблице находятся срабатывания, относящиеся не к проекту, а к ядру Unreal Engine\. ![1110_UnrealEngine_project_configuration_ru/image4.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image4.png) Давайте разберёмся, как получить более релевантный проверяемому проекту отчёт\. ## Настраиваем анализ При ненастроенном анализе проверяются автоматически сгенерированные файлы\. Работать с предупреждениями в таких файлах бессмысленно, а анализ занимает дополнительное время\. Поэтому смело можем отключать их проверку\. Для этого в настройках плагин PVS\-Studio есть пункт **Don't Check Files \> PathMasks**\. Добавим туда такую маску: ```cpp *.gen.cpp ``` Ещё одна проблема ненастроенного анализа — анализ исходных файлов ядра Unreal Engine\. Если бы мы разрабатывали плагин для UE или модифицировали само ядро, то такая проверка была бы необходима\. Но сейчас нам интересно проверить только проект\. Поэтому добавим к настройке _PathMasks_ путь до ядра Unreal Engine \(по умолчанию в настройках выключена маска путей, соответствующая стандартному пути к Unreal Engine\. Если вы используете Unreal Engine, собранный из GitHub, добавьте корректную маску\)\. ![1110_UnrealEngine_project_configuration_ru/image5.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image5.png) После перезапуска анализа получаем такой отчёт: ![1110_UnrealEngine_project_configuration_ru/image6.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image6.png) Предупреждений стало меньше, и с ними уже можно удобно работать\. ## Настройка через \.target\.cs Теперь рассмотрим второй способ запуска анализатора PVS\-Studio\. Как и другие настройки, включение анализа можно настроить в _\.target\.cs_ файлах\. Этот способ наиболее удобен в случае, если приходится часто перегенерировать проектные файлы\. В этом сценарии модификация _NMake_ команд не подходит, так как при новой генерации решения они не будут сохранены\. Для интеграции PVS\-Studio в UE нужно добавить в _\.target\.cs_ файл параметр _StaticAnalyzer_ со значением _StaticAnalyzer\.PVSStudio_\. В файле _LyraGame\.Target\.cs_ это будет выглядеть так: ```cpp public class LyraGameTarget : TargetRules { public LyraGameTarget(TargetInfo Target) : base(Target) { Type = TargetType.Game; ExtraModuleNames.AddRange(new string[] { "LyraGame" }); StaticAnalyzer = StaticAnalyzer.PVSStudio; LyraGameTarget.ApplySharedLyraTargetSettings(this); } .... } ``` В _\.target\.cs_ файле можно указать ещё несколько настроек, специфичных для PVS\-Studio, например, включение групп диагностик или тайм\-аут анализа\. Больше о настройках можете прочитать в [документации](https://pvs-studio.ru/ru/docs/manual/0043/#ID6850AE8285)\. Эти же настройки можно указать и в интерфейсе плагина PVS\-Studio\. ![1110_UnrealEngine_project_configuration_ru/image7.png](https://import.viva64.com/docx/blog/1110_UnrealEngine_project_configuration_ru/image7.png) Ещё в _\.target\.cs_ файле можно определить общие настройки _UnrealBuildTool_, которые будут исполняться только при анализе\. Для этого добавьте такое условие: ```cpp if (StaticAnalyzer == StaticAnalyzer.PVSStudio) { //Настройки } ``` Одной из настроек, для которой применим этот сценарий, является отключение механизма _unity build_\. Механизм _unity build_ — это метод ускорения сборки С\+\+ проекта, при котором несколько единиц трансляции объединяются в одну\. По умолчанию этот режим включён в _UnrealBuildTool_\. Так как С\+\+ анализатор PVS\-Studio проверяет именно единицы трансляции, то в логе анализа мы видим, что анализируются не исходные файлы, а объединённые файлы с префиксом _Module_\. Эта настройка позволяет оптимизировать время сборки, однако может помешать анализу\. На анализ поступят файлы большого размера, и может возникнуть ситуация нехватки памяти\. Отключить этот режим только для анализа можно с помощью следующего кода: ```cpp if (StaticAnalyzer == StaticAnalyzer.PVSStudio) { bUseUnityBuild = false; } ``` На этом с настройкой анализа можно закончить\. ## Новые диагностики В PVS\-Studio начинают появляться специфичные для Unreal Engine проектов диагностики\. Например, диагностическое правило [V1100](https://pvs-studio.ru/ru/docs/warnings/v1100/)\. Оно говорит о том, что в классе, не унаследованном от _UObject_, было обнаружено поле в виде указателя на тип, унаследованный от _UObject_\. Сборщик мусора Unreal Engine может уничтожить объект, адресуемый этим указателем\. Другой пример — диагностика [V1102](https://pvs-studio.ru/ru/docs/warnings/v1102/)\. В ней анализатор отмечает сущности, которые не соответствуют [соглашению о именованиях](https://docs.unrealengine.com/5.3/en-US/epic-cplusplus-coding-standard-for-unreal-engine/#namingconventions) для Unreal Engine проектов\. Например, имена классов, наследуемых от _UObject_, следует начинать с префикса _U_, а перечисления следует начинать с префикса _E_\. Соответствие соглашениям требуется для корректной работы Unreal Header Tool\. ## Заключение Настроить работу анализатора PVS\-Studio с Unreal Engine проектом довольно просто\. В будущих релизах Unreal Engine и PVS\-Studio появятся новые возможности по конфигурации анализа\. [Следите](https://pvs-studio.ru/ru/subscribe/) за нашими обновлениями\. Для тех, кто заинтересовался совместным использованием этих продуктов: по этой [ссылке](https://pvs-studio.ru/ru/pvs-studio/try-free/) вы можете скачать анализатор, а [здесь](https://pvs-studio.ru/ru/docs/manual/0043/) узнать больше об интеграции PVS\-Studio c Unreal Engine\.