26.使用CMake和CTest组织工程测试

文章目录

使用CMake和CTest组织工程测试
- 软件测试
- CMake中如何组织测试
- 测试属性
- 使用CTest
- - reference

欢迎访问个人网络日志🌹🌹知行空间🌹🌹

使用CMake和CTest组织工程测试

软件测试

软件相关的测试包括：

1.冒烟测试(SMOKE TEST)，这是最基本的测试，例如代码能不能成功编译，能不能执行简单的测试用例。
2.回归测试(Regression Test)，回归测试确保软件更新后还能保证以前的功能可以正常运行。
3.黑白盒测试(Black-, and White-box Testing),白盒测试是在知道代码如何编写的情况下测试代码可能存在的潜在的问题，黑盒测试是在只知道公开API信息而不知道代码实现的情况下，对软件功能进行测试。
4.软件标准兼容性测试(Software Standard Compliance Testing),前面三种测试主要聚焦在代码可否正常编译，可否实现功能，软件标准兼容性测试是来测试代码是否工程标准，增强代码可维护性的。如代码规范维护使用的静态分析工具cppchecker等

CMake中如何组织测试

CMake中对测试的支持主要是使用add_test命令。

要使用add_test命令，需要先在CMakeLists.txt中添加include(CTest),add_test的命令格式为：

add_test(NAME TestName COMMAND ExecutableToRun arg1 arg2 ...)

第一个参数TestName是一个字符串，指定当前测试的名字
第二个参数ExecutableToRun是可执行文件的名称，arg1/arg2/...是可执行文件需要的参数，可执行文件的名称可以是当前工程中编译生成的文件名，也可以是外部可执行文件，如Python。

使用方式十分简单，

add_executable(TestInstantiator TestInstantiator.cxx)
target_link_libraries(TestInstantiator vtkCommon)
add_test(NAME TestInstantiatorCOMMAND TestInstantiator)

测试属性

当一个测试满足以下3个条件时才会认为测试用例通过，

测试执行文件可以找到
测试运行没有异常
测试执行成功并返回0

通过cmake中的一些命令，可以改变这些属性：

set_property命令格式：

set_property(TEST test_namePROPERTY prop1 value1 value2 ...)

prop1的可选项主要有：

ENVIRONMENT指定运行当前测试时需要的环境变量
LABELS指定当前测试的标签
WILL_FAIL这个选项被设置为true时，如果测试可执行文件返回的结果不是0,测试用例也能通过
PASS_REGULAR_EXPRESSION,测试程序的输出和这个属性设置的值不同时，测试用例将会提示测试失败。
FAIL_REGULAR_EXPRESSION，测试程序的输出和这个属性设置的值不同时，测试用例将会提示测试成功。

include(CTest)
add_test(NAME outputTest COMMAND ${TARGET_NAME})set (passRegex "^Test passed" "^All ok")
set (failRegex "Error" "Fail")set_property (TEST outputTestPROPERTY PASS_REGULAR_EXPRESSION "${passRegex}")
set_property (TEST outputTestPROPERTY FAIL_REGULAR_EXPRESSION "${failRegex}")