Сборка движка: подготовка и результат

Что собирать, какие инструменты нужны и как проверить полученный комплект.

Сначала определите результат: редактор для разработки, экспортный шаблон для игры или отдельная нативная библиотека. Для нативного расширения сборка самого движка обычно не нужна.

Известное ограничение текущих исходников

В сборочных helper-функциях Source/methods.py обнаружен импорт SCons.Entity, отсутствующий в установленном SCons 4.11.1. Изолированные вызовы glob_recursive и glob_recursive_2 завершаются ImportError до обхода каталогов. Полная сборка не запускалась; инструкции ниже описывают конфигурацию, а не подтверждают её успешное выполнение в этом состоянии дерева. Подробности и границы проверки — в настройке IDE. Этот дефект не исправлялся изменением установленного Runtime.

Подготовка

Команды этого раздела выполняются из каталога Source с файлом SConstruct. Нужны согласованная копия исходников, Python не ниже 3.9, SCons не ниже 4.4 и компилятор/SDK целевой платформы. Минимальные версии Python/SCons заданы текущим SConstruct; платформенные инструменты проверяются отдельно.

Используйте один и тот же Python для установки и запуска SCons. Успех python --version не доказывает, что SCons установлен именно для этого интерпретатора. Проверьте инструменты:

python --version
python -m SCons --version

Платформа сборки — где выполняется компилятор; целевая платформа — где будет работать бинарник. Кросс-компиляция требует подходящего toolchain, SDK и зависимостей; одного platform=... недостаточно.

Выберите цель

target	Результат
editor	Редактор и средства разработки с редакторским API
template_debug	Игровой экспортный шаблон с диагностическими возможностями, без редактора
template_release	Игровой релизный шаблон без редактора

Редактор не заменяет шаблоны экспорта. Сборка только template_release не создаёт редактор. Параметры оптимизации, символов, архитектуры и управляемой интеграции задаются дополнительно.

Порядок работы

Настройте инструменты своей платформы: Windows, Linux/BSD, macOS.
Зафиксируйте platform, target, arch, precision, модули и файлы профилей. Сначала соберите обычную конфигурацию, затем меняйте её по одному параметру.
Для проекта C# включите модуль mono и подготовьте согласованные управляемые сборки/SDK. Успешная компиляция одной нативной программы этого не гарантирует: см. сборку с .NET.
Найдите фактический результат в bin по выводу линкера. Имя зависит от платформы, цели, архитектуры, precision, dev_build и модулей; не используйте устаревшее окончание .64.exe как универсальный шаблон.
Запустите полученный комплект, проверьте версию, открытие проекта и необходимый экспорт с выбранным шаблоном.

Сохраняйте ревизию исходников, полный набор параметров, версии инструментов, журнал и хеши артефактов. Имя продукта 1.0.0 не различает две сборки с разным составом модулей или ABI.

Следующие шаги

Параметры SCons объясняют конфигурацию. Уменьшение размера начинается с измеримого базового результата. Для мобильных и Web-целей используйте отдельное руководство платформы, а не переименованный desktop-бинарник.

Инструкции сверены с текущими файлами сборки. В этой проверке выполнялся только запрос версии SCons; полный редактор, экспортные шаблоны и кросс-компиляция заново не собирались.