ctest_build

Выполнить Этап сборки CTest как Клиент панели мониторинга.

ctest_build([BUILD <build-dir>] [APPEND]
            [CONFIGURATION <config>]
            [FLAGS <flags>]
            [PROJECT_NAME <project-name>]
            [TARGET <target-name>]
            [NUMBER_ERRORS <num-err-var>]
            [NUMBER_WARNINGS <num-warn-var>]
            [RETURN_VALUE <result-var>]
            [CAPTURE_CMAKE_ERROR <result-var>]
            )

Собрать проект и сохранить результаты в Build.xml для отправки с помощью команды ctest_submit().

Переменная CTEST_BUILD_COMMAND может быть установлена для явного указания командной строки сборки. В противном случае командная строка сборки вычисляется автоматически на основе заданных параметров.

Параметры:

BUILD <build-dir>

Указать директорию сборки верхнего уровня. Если не указано, используется переменная CTEST_BINARY_DIRECTORY.

APPEND

Отметить Build.xml для добавления к результатам, ранее отправленным на сервер панели мониторинга, с момента последнего вызова ctest_start(). Семантика добавления определяется используемым сервером панели мониторинга. Это не приводит к добавлению результатов к файлу .xml , созданному предыдущим вызовом этой команды.

CONFIGURATION <config>

Указать конфигурацию сборки (например, Debug). Если не указано, будет проверена переменная CTEST_BUILD_CONFIGURATION. В противном случае будет использоваться параметр -C <cfg>, заданный для команды ctest(1), если таковой имеется.

FLAGS <flags>

Передать дополнительные аргументы в исходную команду сборки. Если не указано, будет проверена переменная CTEST_BUILD_FLAGS. Это можно, например, использовать для запуска параллельной сборки с помощью параметра -j утилиты make. См. модуль ProcessorCount для примера.

PROJECT_NAME <project-name>

Установить имя проекта для сборки. Это должно соответствовать вызову команды project() на верхнем уровне. Если не указано, будет проверена переменная CTEST_PROJECT_NAME.

TARGET <target-name>

Указать имя целевого объекта для сборки. Если не указано, будет проверена переменная CTEST_BUILD_TARGET. В противном случае будет собрана целевая задача по умолчанию. Это целевая задача «all» (называемая ALL_BUILD в Генераторах Visual Studio).

NUMBER_ERRORS <num-err-var>

Сохранить количество обнаруженных ошибок сборки в заданной переменной.

NUMBER_WARNINGS <num-warn-var>

Сохранить количество обнаруженных предупреждений сборки в заданной переменной.

RETURN_VALUE <result-var>

Сохранить возвращаемое значение утилиты исходной сборки в заданной переменной.

CAPTURE_CMAKE_ERROR <result-var>

Сохранить в переменной <result-var> значение -1, если при выполнении команды произошли ошибки, и предотвратить возврат ненулевого значения ctest при возникновении ошибки.

QUIET

Запретить вывод любых специфичных для CTest, не являющихся ошибками, которые иначе были бы выведены в консоль. Подведение итогов предупреждений/ошибок, а также вывод исходной утилиты сборки на это не влияют.