create_test_sourcelist

创建一个测试驱动程序,将许多小测试链接到一个可执行文件中。当使用大型库构建静态可执行文件时很有用,可缩小所需总大小。

create_test_sourcelist(<sourceListName> <driverName> <test>... <options>...)

从一个独立测试源列表生成一个测试驱动源文件,并提供一个可以构建为可执行文件的源列表。

选项包括

<sourceListName>

用于存储构建测试驱动所需的源文件列表的变量名称。该列表将包含 <test>... 源和生成的 <driverName> 源。

3.29 版中已更改: 构建树中按绝对路径列出测试驱动源。以前它仅显示为 <driverName>

<driverName>

要生成到构建树中的测试驱动源文件名。源文件将包含一个 main() 程序入口点,启动命令行中指定的任何测试。

<test>...

要添加到驱动二进制文件中的测试源文件。每个测试源文件都必须包含一个与其同名且扩展名已移除的文件的函数。例如,一个 foo.cxx 测试源可能包含

int foo(int argc, char** argv)
EXTRA_INCLUDE <header>

指定一个头文件以 #include 到生成的测试驱动源中。

FUNCTION <function>

指定一个函数,该函数将使用指向 argcargv 的指针来调用。该函数可以提供在 EXTRA_INCLUDE 头文件中

void function(int* pargc, char*** pargv)

这可用于为每个测试添加额外的命令行处理。

此外,一些 CMake 变量会影响测试驱动生成

CMAKE_TESTDRIVER_BEFORE_TESTMAIN

在调用每个测试函数之前直接放置的代码。

CMAKE_TESTDRIVER_AFTER_TESTMAIN

在调用每个测试函数后直接放置的代码。