ctest_build

Выполнить этап сборки CTest в качестве клиента панели мониторинга.

ctest_build([BUILD <build-dir>] [APPEND]
            [CONFIGURATION <config>]
            [PARALLEL_LEVEL <parallel>]
            [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), если таковая имеется.

PARALLEL_LEVEL <parallel>

Добавлен в версии 3.21.

Указывает уровень параллелизма для базовой системы сборки. Если не указано, проверяется переменная окружения CMAKE_BUILD_PARALLEL_LEVEL.

FLAGS <flags>

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

PROJECT_NAME <project-name>

Игнорируется с CMake 3.0.

Изменено в версии 3.14: Это значение больше не требуется.

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>

Добавлен в версии 3.7.

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

QUIET

Добавлен в версии 3.3.

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