CTest

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

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

project(MyProject)
...
include(CTest)

Модуль автоматически создаёт параметр BUILD_TESTING для выбора, включить ли поддержку тестирования (ON по умолчанию). После включения модуля используйте код, подобный:

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

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

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

set(CTEST_PROJECT_NAME "MyProject")
set(CTEST_NIGHTLY_START_TIME "01:00:00 UTC")
set(CTEST_DROP_METHOD "http")
set(CTEST_DROP_SITE "my.cdash.org")
set(CTEST_DROP_LOCATION "/submit.php?project=MyProject")
set(CTEST_DROP_SITE_CDASH TRUE)

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

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

set(CTEST_USE_LAUNCHERS 1)

в файле CTestConfig.cmake.