KDevelop: SCons, запуск и отладка исходников
Рабочая папка сборки, индексация, выбор бинарника и диагностика.
KDevelop подходит для C/C++ исходников Reckfell 1.0.0. C#-проект игры настраивается отдельно. Движок собирается через SCons, а не CMake или сгенерированный Makefile.
Выберите исходники и окружение сборки
Откройте/импортируйте каталог Source с файлом SConstruct. Выберите Custom Build System, если такой менеджер проектов доступен в вашей установке. Импорт настраивает IDE, но не компилирует движок. Если плагина нет, редактируйте код в KDevelop, а SCons запускайте из терминала в Source.
Подготовьте компилятор и зависимости по инструкции сборки. Настройте внешнюю команду Build:
| Параметр | Значение |
|---|---|
| Executable | Реальный исполняемый файл SCons, доступный в окружении IDE |
| Working/build directory | Абсолютный путь к Source с файлом SConstruct |
| Arguments | Параметры после scons в команде ниже |
Пример для редактора Linux x86_64:
scons platform=linuxbsd target=editor arch=x86_64 dev_build=yes debug_symbols=yesЕсли IDE не находит компилятор или зависимость, сначала выполните ту же команду в терминале. Сравните PATH и окружение, а не только выбранный проект. platform=linuxbsd выбирает платформу; target=editor — редактор. Для Windows нужны platform=windows и соответствующий набор инструментов.
Не оставляйте compiledb_gen_only=yes или vsproj_gen_only=yes в Build. Создание метаданных индексации/проекта и получение исполняемого файла — разные операции. Не добавляйте шаг make в каталог без Makefile.
Отдельно настройте индексацию
Одного корня исходников в списке include недостаточно. Пути заголовков, компилятор, сгенерированные заголовки и определения препроцессора должны соответствовать выбранной конфигурации SCons. Определения Windows не описывают сборку Linux. Подсветка ошибок IDE не заменяет результат компилятора; успешная сборка не доказывает правильность модели кода IDE.
Запустите нужный исполняемый файл
В Run → Configure Launches задайте исполняемый файл, аргументы и окружение. Выберите реальный свежий результат сборки в Source/bin: имя зависит от platform, target, dev_build и arch. Сверьте журнал сборки и время файла вместо копирования имени из другой конфигурации.
Передайте --path и абсолютный путь к каталогу с project.reckfell. Для открытия проекта в редакторе добавьте --editor. Рабочая папка сама по себе не задаёт проект надёжно. Настройте native-отладчик, поддерживающий ваш компилятор, с соответствующими бинарником, символами и исходниками.
Ожидаемый результат: Build завершает компиляцию/линковку, а запуск открывает выбранный проект. Для проверки точки останова выберите C++-строку, которую выполняет этот процесс: подключение к Project Manager или другому процессу Play может оставить её несработавшей. Эта настройка не отлаживает управляемый C#-код.
| Проблема | Что проверить |
|---|---|
| SCons не запускается | Путь исполняемого файла и окружение IDE |
| SConstruct не найден | Рабочая папка сборки — Source |
| Нет нового бинарника | Ошибки сборки и параметры generation-only |
| Открывается Project Manager | Явный --path и расположение project.reckfell |
| Точка останова не разрешается | Выбранный процесс, подходящие символы и отладчик |
Границы проверки
Параметры сборки, имя результата и семантика запуска сверены с текущими исходниками. Ранее полученное Windows headless-подтверждение --path используется только для поведения CLI движка. Интерфейс KDevelop, индексация, компиляция Linux и точки останова не запускались. Source, Runtime и SDK не изменены.