Qt Creator: сборка и отладка исходников
Generic project, SCons, параметры запуска и диагностика индексации.
Это настройка Qt Creator для C/C++ исходников Reckfell 1.0.0. Для C# проекта игры нужен отдельный managed-проект. Здесь IDE вызывает SCons; импорт файлов не заменяет сборку движка.
Импорт исходников
В File → New Project → Import Project → Import Existing Project выберите каталог Source с SConstruct. Открывайте созданный .creator при следующем запуске. В generic project файл .files задаёт состав проекта, .includes — пути заголовков, .config — определения препроцессора.
Пути в .includes задавайте по одному на строку, относительно этого файла либо абсолютно. Добавление только точки не описывает платформенные заголовки, generated headers и defines. Сверяйте их с фактическими командами компиляции своей конфигурации. Не копируйте Android defines в Windows-проект. Индексация и сборка используют разные настройки: отсутствие подчёркивания ошибки ещё не означает успешную компиляцию.
Сборка через SCons
Сначала подготовьте compiler/SDK и окружение по руководству сборки. В Projects → Build Settings удалите стандартный make step и добавьте Custom Process Step. Command — доступный SCons executable; Arguments — его параметры; Working directory — каталог Source. Настройка внешнего процесса.
Пример полной команды для Windows x86_64 editor; в поле Arguments переносите только параметры после scons:
scons platform=windows target=editor arch=x86_64 dev_build=yes debug_symbols=yesДля Linux выбирают platform=linuxbsd, для редактора — target=editor: platform=editor неверно. Параметры другой платформы требуют её toolchain и зависимостей; Windows-команда не является инструкцией кросс-компиляции.
Если процесс не запускается, укажите реальный путь SCons и проверьте PATH/SDK в окружении IDE. Наличие выбранного kit само по себе не доказывает, что SCons получил нужные compiler variables. Сравните журнал IDE с рабочей терминальной командой. Не добавляйте compiledb_gen_only=yes или vsproj_gen_only=yes в обычный Build: генерация метаданных не создаёт executable.
Запуск и отладка
В Projects → Run Settings → Add → Custom Executable укажите фактически созданный файл из Source/bin. Его имя зависит от platform, target, dev_build, arch и других опций. Не выбирайте файл только по примеру имени из чужой сборки; проверьте путь и дату результата.
Для игры передайте --path к каталогу с project.reckfell; для редактора добавьте --editor. Рабочий каталог задаётся отдельно и не заменяет явный путь проекта. Debugger должен поддерживать формат символов выбранного compiler; символы и исходники должны соответствовать бинарнику. При Attach проверьте путь процесса и аргументы: редактор и Play могут быть разными процессами.
Диагностика
| Симптом | Что проверить |
|---|---|
| Could not start process scons | Реальный executable, PATH и окружение процесса сборки |
| Компиляция ищет файлы не там | Working directory указывает на Source с SConstruct |
| Неизвестные типы только в IDE | .includes/.config и параметры выбранной платформы; это не настройка SCons |
| Нет нового executable | Завершение compile/link, выбранный target; не оставлен ли generation-only |
| Вместо проекта открывается Project Manager | --path к каталогу с project.reckfell; --editor для редактора |
| Breakpoint не срабатывает | Нужный процесс, поддерживаемый debugger, matching binary/symbols/source |
Форматирование C/C++ берите из Source/.clang-format; .editorconfig задаёт UTF-8, LF и табуляцию, но Python/SConstruct/SCsub используют пробелы. Не применяйте настройку «табы везде» ко всем языкам.
Границы проверки
SCons options, формирование имени бинарника и правила форматирования сверены с текущими исходниками. Повторно использована проверка CLI --path на установленном Runtime. Команда сборки приведена как конфигурация, не выполнялась; Qt Creator GUI, импорт, индексация, сборка и breakpoint не проверены. Source, Runtime и SDK не менялись.