CTest

Настройка проекта для тестирования с помощью CTest/CDash

Включите этот модуль в файл CMakeLists.txt верхнего уровня проекта, чтобы включить тестирование с помощью CTest и отправку данных на панель мониторинга CDash:

project(MyProject)
...
include(CTest)

Модуль автоматически создает следующие переменные:

BUILD_TESTING

Параметр, определяющий, вызывает ли include(CTest) команду enable_testing(). По умолчанию при создании модулем этому параметру присваивается значение ON.

После включения модуля используйте код, например:

if(BUILD_TESTING)
  # ... CMake code to create tests ...
endif()

для создания тестов, если тестирование включено.

Чтобы включить отправку данных на сервер CDash, создайте файл CTestConfig.cmake в корне проекта со следующим содержимым:

set(CTEST_NIGHTLY_START_TIME "01:00:00 UTC")
set(CTEST_SUBMIT_URL "http://my.cdash.org/submit.php?project=MyProject")

Сервер CDash может предоставить этот файл администратору проекта, который настраивает MyProject. Параметры в файле конфигурации используются как этим модулем CTest, так и режимом командной строки ctest(1) клиента панели мониторинга (ctest -S).

При сборке проекта для отправки данных на CDash CTest сканирует вывод сборки на наличие ошибок и предупреждений и сообщает о них, приводя окружающий контекст из журнала сборки. Этот универсальный подход работает со всеми инструментами сборки, но не предоставляет подробностей о вызове команды, который привел к той или иной проблеме. Более подробные отчеты можно получить, задав переменную CTEST_USE_LAUNCHERS:

set(CTEST_USE_LAUNCHERS 1)

в файле CTestConfig.cmake.