CMake I 创建一个简单的单元测试

    CMake 提供了一个称为 CTest 的测试工具。我们要做的只是在项目根目录的 CMakeLists.txt文件中调用一系列的 add_test 命令。

一、CMake语法及命令

1.enable_testing()

    使用 enable_testing() 命令可以启用测试。一定要在根目录下的CMakeLists.txt中开启，不然执行make test时会报错。

2.add_test()

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

add_test用来添加新测试：

• NAME：指定本测试的名称，可以随意命名。
• COMMAND：指定测试命令行。如果<command>指定了一个可执行目标（由add_executable（）创建），它将自动替换为生成时创建的可执行文件的位置。
• CONFIGURATIONS ：Debug/Release选项可以控制在不同的编译版本下是否进行测试。
• WORKING_DIRECTORY：指定要在其中执行测试的工作目录。如果未指定，测试将在当前工作目录设置为与当前源目录对应的生成目录的情况下运行。
• COMMAND_EXPAND_LISTS：3.16版新增。命令参数中的列表将展开，包括使用生成器表达式创建的列表。

add_test(
    NAME mytest 
    COMMAND $<TARGET_FILE:mytest> #<TARGET_FILE:mytest> 指代mytest这个目标的完整路径。
    )

     $<TARGET_FILE:mytest>是生成器表达式，它是在生成构建系统生成时的表达式。生成器表达式在测试时非常方便，因为不必显式地将可执行程序的位置和名称，可以硬编码到测试中。

3.ctest命令

    CTest遵循的标准约定是：返回零意味着成功，非零返回意味着失败。可以返回零或非零的脚本都可以做测试用例。（Windows端使用VS编译时要保证安装“用于Windows的C++ CMake工具”）

二、源码

1.C++源码

//sum_integers.h文件
#pragma once
#include <vector>
int sum_integers(const std::vector<int> integers);

//sum_integers.cpp文件
#include "sum_integers.h"
#include <vector>
int sum_integers(const std::vector<int> integers)
{
    auto sum=0;
    for(auto i:integers)
    {
        sum+=i;
    }
    return sum;
}

//MyDemo.cpp文件
#include "sum_integers.h"
#include <vector>
#include <iostream>
#include <string>
int main(int argc,char* argv[])
{
    std::vector<int> integers;
    for(auto i=1;i<argc;i++)
    {
        integers.push_back(std::stoi(argv[i]));
    }
    auto sum=sum_integers(integers);
    std::cout<<sum<<std::endl;
}

2.CMakeLists.txt文件

cmake_minimum_required(VERSION 3.5 FATAL_ERROR)
project(testUnit LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
#库
add_library(sum_integers sum_integers.cpp)
#demo
add_executable(mydemo MyDemo.cpp)
target_link_libraries(mydemo sum_integers)
#test
add_executable(mytest test.cpp)
target_link_libraries(mytest sum_integers)

enable_testing()

add_test(
    NAME mytest 
    COMMAND $<TARGET_FILE:mytest>#
    )

3.测试代码

//test.cpp
#include "sum_integers.h"
#include <vector>
int main()
{
    auto integers={1,2,3,4,5};
    if(sum_integers(integers)==15)
    {
        return 0;
    }else{
        return -1;
    }
}

三、配置及构建

1.配置

2.构建

3.测试

    使用ctest命令时，必须加上编译类型 **-C <config>**参数 ，才可以正确执行。默认情况下只有 **Passed/Failed** 提示信息，此外，我们可以添加以下命令：

• --output-on-failure：将测试程序生成的任何内容打印到屏幕上，以免测试失败。
• -v：将启用测试的详细输出。
• -vv：启用更详细的输出。

（1）正确使用ctest命令

（2）-V详细输出

（3）[错误]执行ctest命令时不带参数

（4）[错误]在错误文件夹中执行ctest命令

4.扩展

    使用 ctest 命令后，CMake还为CMake可以为生成器创建目标(Unix为 make test ，Ninja工具为 ninja test ，或者Visual Studio为 RUN_TESTS )。这意味着，还有另一种(几乎)可移植的方法来运行测试，以VS为例：