Модуль для сборки ПОМодуль для сборки ПО позволяет выполнять сборку, очистку и компиляцию проекта. Кроме того, можно автоматически запускать созданные приложения. По сути, модуль предоставляет способ настройки наборов команд для запуска, а также позволяет выполнить синтаксический анализ вывода, чтобы найти ссылки на файлы и определённые строки и позиции в этих файлах. Этот модуль изначально был создан для компиляции кода на языке C/C++ и в основном тестировался в связи с этой задачей, но его также можно использовать для других задач и языков.
Этот модуль добавляет панель Сборка в нижней части окна, а также меню в строке меню. Панель позволяет выбирать и настраивать цели сборки, а меню и его комбинации клавиш возможно использовать для выбора и выполнения настроенных команд оболочки.
На панели Сборка доступны две статические вкладки:
Параметры цели
Вывод
Вкладка «Параметры цели» используется для настройки различных целей сборки и определения наборов целей.
Набор целей — это группа команд, которые можно запускать в указанном рабочем каталоге. Наборы целей можно добавлять либо на панели Проекты, либо на панели Сеанс. Пользовательские наборы целей, добавленные на панели Проекты, хранятся в файле .kateproject.build в корневом каталоге проекта и восстанавливаются при повторном открытии проекта. Наборы целей, добавленные на панели Сеанс, хранятся в конфигурации сеанса Kate.
Первая строка в наборе целей содержит название набора (в первом столбце) и каталог, в котором должны выполняться команды (во втором столбце). В каждой последующей строке находятся название команды (в первом столбце), команда сборки (во втором столбце), команда запуска (в третьем столбце). Чтобы выполнить редактирование, сделайте двойной щелчок по нужной записи или нажмите связанную клавишу (часто это F2).
- Рабочий каталог
Второй столбец первой строки в наборе целей позволяет настроить рабочий каталог, в котором выполняется компиляция и запускаются команды. Если модуль проектов включён, строка рабочего каталога также может содержать заменители для пути к основному каталогу проекта: %B и имя: %b
- Команда сборки
Второй столбец в «не первых строках» содержит команду оболочки для запуска в рабочем каталоге. Обратите внимание на слово «оболочка». Подойдёт почти любая команда оболочки. Команда сборки может содержать заменители. %f для текущего файла, %d для каталога текущего файла и %n для базового имени текущего файла (имя файла без суффикса).
- Команда запуска
Третий столбец в «не первых строках» может содержать команду оболочки для запуска в самом терминале в рабочем каталоге набора целей. Терминал открывается в виде вкладки. Модуль попытается повторно использовать вкладку терминала, если выполняется та же самая команда и предыдущее приложение завершило работу.
В верхней части вкладки Параметры цели находится панель инструментов с фильтром целей и следующими кнопками:
 Собрать выбранную цель |
 Собрать и запустить выбранную цель |
 Добавить цель |
 Создать набор целей |
 Скопировать команду или набор целей |
 Удалить текущий набор целей |
На вкладке Вывод показаны выходные данные консоли, сгенерированные запущенной командой (сборки). Если строка содержит расположение файла, по ней можно щёлкнуть. Если в строке вывода также показана ошибка или предупреждение, такая строка будет другого цвета.
Если на странице модуля в параметрах настройки Kate включена опция Выводить ошибки и предупреждения, на панели диагностики также будут показаны ошибки и предупреждения. Чтобы перейти к предыдущей ошибке на панели диагностики, нажмите Alt+Shift+Стрелка влево. Чтобы перейти к следующей ошибке, нажмите Alt+Shift+Стрелка вправо.
- →
Фильтр выбора цели фокусируется на вкладке «Параметры цели». При вводе имени будут отфильтрованы цели, которые не соответствуют введённой строке. Для перемещения по иерархическому списку целей также можно использовать клавиши со стрелками. После выбора нужной цели нажмите клавишу Return или Enter для её выполнения и запуска.
- →
Выполняет сборку последней выбранной цели. Если ничего не выбрано, работает как Выбрать цель…
- →
Выполняет сборку последней выбранной цели и запускает команду запуска после успешного завершения работы команды сборки.
- →
Попытаться скомпилировать текущий файл путём поиска команды в возможном compile_commands.json.
- →
Прекратить сборку цели.
- →
Передать фокус следующей вкладке модуля для сборки слева. Или открыть панель модуля для сборки, если она скрыта.
- →
Передать фокус следующей вкладке модуля для сборки справа. Или открыть панель модуля для сборки, если она скрыта.
- →
Открывает диалоговое окно со списком файлов, в котором пользователь может выбрать CMakeCache.txt. Когда файл выбран, модуль генерирует цели команды сборки cmake, которые можно выполнить в каталоге сборки для проекта на основе CMake.