add_test

Добавить тест в проект, который будет выполняться с помощью ctest(1).

add_test(NAME <name> COMMAND <command> [<arg>...]
         [CONFIGURATIONS <config>...]
         [WORKING_DIRECTORY <dir>]
         [COMMAND_EXPAND_LISTS])

Добавляет тест с именем <name>. Имя теста может содержать произвольные символы, выраженные в виде Цитатированного аргумента или Аргумента в скобках, если это необходимо. См. политику CMP0110.

CMake генерирует тесты только если был вызван enable_testing() команда. Модуль CTest вызывает enable_testing автоматически, если BUILD_TESTING не установлено в OFF.

Тесты, добавленные с помощью add_test(NAME) подписи, поддерживают использование generator expressions в свойствах тестов, установленных с помощью set_property(TEST) или set_tests_properties(). Свойства тестов могут быть установлены только в каталоге, где создан тест.

add_test опции:

COMMAND

Укажите командную строку для теста.

Если <command> указывает целевой исполняемый файл, созданный с помощью add_executable():

• Он будет автоматически заменён расположением исполняемого файла, созданного во время сборки.

• Добавлен в версии 3.3: Целевой CROSSCOMPILING_EMULATOR, если задан, будет использоваться для запуска команды на хосте:

  <emulator> <command>
  

  Изменено в версии 3.29: Эмулятор используется только когда cross-compiling. См. политику CMP0158.

• Добавлен в версии 3.29: Целевой TEST_LAUNCHER, если задан, будет использоваться для запуска команды:

  <launcher> <command>
  

  Если также задан CROSSCOMPILING_EMULATOR, оба будут использоваться:

  <launcher> <emulator> <command>
  

Команда может быть указана с помощью generator expressions.

CONFIGURATIONS

Ограничить выполнение теста только указанными конфигурациями.

WORKING_DIRECTORY

Установить свойство теста WORKING_DIRECTORY, в котором следует выполнить тест. Если не указано, тест будет выполнен в CMAKE_CURRENT_BINARY_DIR. Каталог выполнения может быть указан с использованием generator expressions.

COMMAND_EXPAND_LISTS

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

Списки в COMMAND аргументах будут расширены, включая те, что созданы с помощью generator expressions.

Если тест завершается с кодом 0, тест считается пройденным. ненулевой код выхода указывает на "неудавшуюся" проверку. Свойство теста WILL_FAIL инвертирует эту логику. Обратите внимание, что системные сбои тестирования, такие как ошибки сегментации или ошибки кучи, все равно приведут к сбою теста, даже если WILL_FAIL true.

Выводимые в stdout или stderr данные собираются ctest(1) и влияют на статус "пройдено/не пройдено" только через свойства теста PASS_REGULAR_EXPRESSION, FAIL_REGULAR_EXPRESSION или SKIP_REGULAR_EXPRESSION.

Пример использования:

add_test(NAME mytest
         COMMAND testDriver --config $<CONFIG>
                            --exe $<TARGET_FILE:myexe>)

Это создаёт тест mytest, чья команда запускает инструмент testDriver, передавая имя конфигурации и полный путь к исполняемому файлу, созданному целевым объектом myexe.

Вышеприведённый синтаксис команды рекомендуется вместо более старой, менее гибкой формы:

add_test(<name> <command> [<arg>...])

Добавить тест под названием <name> с заданной командной строкой.

В отличие от вышеприведённой NAME подписи, имена целевых объектов в командной строке не поддерживаются. Кроме того, тесты, добавленные с этой подписью, не поддерживают generator expressions в командной строке или свойствах теста.