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 не относящийся к ошибкам вывод, который в противном случае был бы напечатан в консоль. Сводка предупреждений/ошибок, а также вывод от утилиты нативной сборки не влияют на этот параметр.
© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.11/command/ctest_build.html