ctest_configure

Выполняет CTest Configure Step в качестве Dashboard Client.

ctest_configure([BUILD <build-dir>] [SOURCE <source-dir>] [APPEND]
                [OPTIONS <options>] [RETURN_VALUE <result-var>] [QUIET]
                [CAPTURE_CMAKE_ERROR <result-var>]
                [PRESET <preset>]
                [PRESETS_FILE <file>]
                )

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

Доступны следующие параметры:

BUILD <build-dir>

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

SOURCE <source-dir>

Задает каталог исходного кода. Если он не указан, используется переменная CTEST_SOURCE_DIRECTORY.

APPEND

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

OPTIONS <options>

Задает разделенный точками с запятой список аргументов командной строки, передаваемых инструменту конфигурирования. Этот параметр игнорируется, если используется CTEST_CONFIGURE_COMMAND.

PRESET <preset>

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

Задает preset для конфигурирования проекта. Любое значение, заданное в скрипте CTest, имеет приоритет над соответствующей настройкой из пресета. Например, переменная CTEST_BINARY_DIRECTORY переопределит настройку binaryDir выбранного пресета.

Если указан пресет, переменная CTEST_CONFIGURE_COMMAND игнорируется, чтобы пресет всегда применялся.

См. также переменные CTEST_CONFIGURE_PRESET и CTEST_PRESET.

PRESETS_FILE <file>

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

Задает файл presets, который будет использоваться вместо файла CMakePresets.json по умолчанию в каталоге исходного кода. Относительный путь интерпретируется относительно каталога исходного кода. Не действует, если пресет не выбран с помощью аргумента PRESET или переменных CTEST_CONFIGURE_PRESET или CTEST_PRESET.

См. также переменную CTEST_PRESETS_FILE.

RETURN_VALUE <result-var>

Сохраняет в переменной <result-var> возвращаемое значение собственного инструмента конфигурирования.

CAPTURE_CMAKE_ERROR <result-var>

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

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

QUIET

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

Подавляет все не относящиеся к ошибкам сообщения CTest, которые в противном случае выводились бы в консоль. Вывод выполняемой команды конфигурирования не затрагивается.