Generate project files

Автоматически сгенерировать файлы проекта можно двумя способами.

Unreal Version Selector

При смене версии движка через контекстное меню, вызывается программа Unreal Version Selector:

Находится программа в директории Epic Launcher:

c:\Program Files (x86)\Epic Games\Launcher\Engine\Binaries\Win64\UnrealVersionSelector.exe

При вызове Unreal Version Selector меняется версия движка у проекта и дополнительно происходит генерирование файлов проекта. Version Selector можно вызвать через командную строку с параметрами:

Параметр	Описание
switchversionsilent	переключение версии без вызова окна селектора
switchversion	переключение версии с вызовом окна селектора

В случае switchversionsilent необходимо передать два дополнительных параметра: путь до файла проекта .uproject и до движка. Для switchversion достаточно пути до .uproject

Примеры bat файлов

"c:\Program Files (x86)\Epic Games\Launcher\Engine\Binaries\Win64\UnrealVersionSelector.exe" -switchversionsilent "c:\_Projects\_Jenkins\TPS\TPS.uproject" "c:\Epic Games\UE Binary\UE_4.26"

"c:\Program Files (x86)\Epic Games\Launcher\Engine\Binaries\Win64\UnrealVersionSelector.exe" -switchversion "c:\_Projects\_Jenkins\TPS\TPS.uproject"

Unreal Build Tool

Unreal Version Selector после переключения версии движка вызывает Unreal Build Tool (UBT), которая умеет генерировать файлы проекта. Данная программа используется для различных процессов автоматизации, сборки, построений. Также она отвечает за генерацию проектных файлов. Ее можно вызвать отдельно, если нет необходимости менять версию движка. Находится программа в корне движка:

c:\Epic Games\UE Binary\UE_4.26\Engine\Binaries\DotNET\UnrealBuildTool.exe

При вызове UBT версия движка не меняется, генерируются только файлы проекта.

Параметр	Описание
projectfiles	генерация файлов проекта
progress	отображение прогресса генерации файлов в консоли
project	путь до проекта

Пример bat файла

"c:\Epic Games\UE Binary\UE_4.26\Engine\Binaries\DotNET\UnrealBuildTool.exe" -projectfiles -progress -project="c:\_Projects\_Jenkins\TPS\TPS.uproject"

UE5

В 5 версии движка имеется (временная) проблема с генерацией файлов проекта через контекстное меню. Путь до UBT был изменен (добавилась дополнительная поддиректория UnrealBuildTool):

C:\Epic Games\UE Binary\UE_5.0EA\Engine\Binaries\DotNET\UnrealBuildTool\UnrealBuildTool.exe

В результате этого, Unreal Version Selector пытается найти UBT по неправильному пути и, как следствие, генерация файлов в 5 версии на данный момент не работает. Выводится окно ошибки:

Поэтому UBT нужно вызвать самостоятельно:

"Epic Games\UE Binary\UE_5.0EA\Engine\Binaries\DotNET\UnrealBuildTool\UnrealBuildTool.exe" -projectfiles -progress -project="c:\_Projects\_Jenkins\TPS\TPS.uproject"

Данная проблема будет исправлена с обновлением Epic Launcher. Как ее исправить с помощью исходников, можно посмотреть в видео уроках внизу страницы.

Notes

Данную команду можно вызвать как из командной строки, так и создать специальный .bat файл gen_project_files.bat и поместить в файл код для генерации.

Все пути рекомендую обрамлять в кавычки " ". Иначе пути будут обрезаться по первому пробелу.

Подробнее в видео уроках