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>

指定一个要传递 argc 和 argv 指针的函数。该函数可以包含在 EXTRA_INCLUDE 头文件中

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

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

此外，一些 CMake 变量会影响测试驱动程序的生成