【CMake】使用ctest配置googletest
admin
2024-04-03 13:18:08
0

使用ctest配置googletest

介绍

以下讨论均为C++

我们首先要理解什么是测试。测试就是把程序的某个函数单独拿出来,然后为它单独写一个main函数。运行这个main函数,看看打印结果是不是预期的,那就是测试了。

googletest是什么:

由于测试是软件开发通用流程的一部分,因此当然可以用第三方工具来规范化测试流程。其中GoogleTest就是谷歌家推出的测试框架。它为你定义了一些方便的宏,还提供了好看的测试输出(比如测试失败的时候到底哪里错了?正确值是多少?)。我们要记住,它只是个方便的工具,你完全你可自己手写一个简陋的测试框架,只要写自己的main函数即可。

ctest是什么:

ctest是cmake中的一个类似于脚本化测试的工具。当你要管理项目的时候,一般会用到cmake。ctest是用来调用和定义测试的。你的测试可以是一个程序,一个脚本(python powershell bash等)。ctest不清楚你的测试程序是啥,它只知道去调用一个可执行的文件即可。

两者区别?
这就跟汽车外壳和汽车引擎的区别一样。ctest是那个外壳。gtest是那个引擎。ctest只知道去执行某个可执行文件,它不管你那个里面是什么,你可以就打印个hello world也没关系。而gtest是用来生成测试的可执行文件的。因为我们手写测试程序可能千奇百怪,不符合规范,因此可以借助googletest来写一个规范的测试。

ctest还可以搭配任何其他测试框架使用,比如catch2, boost.test等等。只不过gtest是最流行的。

虽说是ctest。但它不过是cmake语法的一部分而已。

参考博文:
https://matgomes.com/integrate-google-test-into-cmake/

实践

目录结构

├── CMakeLists.txt
├── scripts
│   ├── build.sh
│   └── clean-build.sh
├── src
│   ├── CMakeLists.txt
│   └── multiply
│       ├── CMakeLists.txt
│       ├── include
│       │   └── multiply
│       │       └── multiply.h
│       └── multiply.cpp
└── tests├── CMakeLists.txt└── multiply_test.cpp

test目录是单独存放测试的地方。你可以认为测试程序(也是个可执行文件目标)与项目本身的程序是互无瓜葛的,井水不犯河水。

src存放的就是项目本身的源码。
下面就是一个multiply。代表multiply这个目标。

头文件单独放在include当中。
并且include的目录结构与源码目录结构一致。

根目录CMakeLists.txt

cmake_minimum_required(VERSION 3.16)
project(MultiplyTest LANGUAGES CXX)set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)enable_testing()add_subdirectory(src)
add_subdirectory(tests)

其中注意enable_testing()代表开启ctest, 要尽量把它往前放。

src

src/CMakeLists.txt

add_subdirectory(multiply)

src\multiply\CMakeLists.txt

add_library(multiply multiply.cpp)target_include_directories(multiply PUBLIC include)

src\multiply\multiply.cpp

#include int multiply(int a, int b)
{return a*b;
}float multiply(float a, float b)
{return a*b;
}double multiply(double a, double b)
{return a*b;
}

src\multiply\include\multiply\multiply.h

int multiply(int a, int b);float multiply(float a, float b);double multiply(double a, double b);

tests

测试文件: gtest

如上文所说,gtest不过就是规范一下测试的写法并增加了一些宏。我们写测试不过就是写main函数而已。

其中最重要的两个宏:

  • TEST(testName, subName)
  • ASSERT_EQ(expected, actual)

tests\multiply_test.cpp

#include 
#include TEST(MultiplyTests, TestIntegerOne_One)
{const auto expected = 1;const auto actual = multiply(1, 1);ASSERT_EQ(expected, actual);
}TEST(MultiplyTests, TestIntegerZero_Zero)
{const auto expected = 0;const auto actual = multiply(0, 0);ASSERT_EQ(expected, actual);
}TEST(MultiplyTests, TestIntegerZero_One)
{const auto expected = 0;const auto actual = multiply(0, 1);ASSERT_EQ(actual, expected);
}int main(int argc, char** argv)
{::testing::InitGoogleTest(&argc, argv);return RUN_ALL_TESTS();
}

使用ctest并引入gtest的CMakeLists.txt

首先,我们要先安装gtest。你可以用vcpkg之类的安装,也可使用cmake自带的语法FetchContent。gtest也需要编译。

其次,要编译并连接测试程序。multiply_test 是我们写的测试程序,也就是单独定义的一个main函数。我们要把被测的函数编译成的静态库multiply链接到multiply_test 上,同时也把gtest链接到multiply_test 上。

tests\CMakeLists.txt

include(FetchContent)# 将Googletest下载到本地的build当中,作为本地项目的一部分。所有googletest的目标都将可见。
FetchContent_Declare(googletestGIT_REPOSITORY https://github.com/google/googletest.gitGIT_TAG release-1.11.0
)FetchContent_MakeAvailable(googletest)# 将下载下来的googletest编译成库 使用IMPORTED关键字
add_library(GTest::GTest INTERFACE IMPORTED)
# 链接gtest
target_link_libraries(GTest::GTest INTERFACE gtest_main)# 将我们写的tests编译成可执行文件
add_executable(multiply_test multiply_test.cpp)# 把GTest和被测函数都链接到 可执行文件 上
target_link_libraries(multiply_testPRIVATEGTest::GTestmultiply)# 增加测试
add_test(multiply_gtests multiply_test)

构建运行ctest

像构建运行正常程序那样构建运行你的测试程序。

(我的环境是win10 + VS2022)

 cmake -B buildcmake --build build --config=Release

然后运行ctest(注意: 必须先进入build文件夹才行!)

ctest

或者你可以加上--verbose,这样打印的信息更全面。

输出:

PS E:\Dev\zenoPBD\build> ctest --verbose
UpdateCTestConfiguration  from :E:/Dev/zenoPBD/build/DartConfiguration.tcl
UpdateCTestConfiguration  from :E:/Dev/zenoPBD/build/DartConfiguration.tcl
Test project E:/Dev/zenoPBD/build
Constructing a list of tests
Done constructing a list of tests
Updating test list for fixtures
Added 0 tests to meet fixture requirements
Checking test dependency graph...
Checking test dependency graph end
test 1Start 1: multiply_gtests1: Test command: E:\Dev\zenoPBD\build\tests\Release\multiply_test.exe
1: Test timeout computed to be: 10000000
1: [==========] Running 3 tests from 1 test suite.
1: [----------] Global test environment set-up.
1: [----------] 3 tests from MultiplyTests
1: [ RUN      ] MultiplyTests.TestIntegerOne_One
1: [       OK ] MultiplyTests.TestIntegerOne_One (0 ms)
1: [ RUN      ] MultiplyTests.TestIntegerZero_Zero
1: [       OK ] MultiplyTests.TestIntegerZero_Zero (0 ms)
1: [ RUN      ] MultiplyTests.TestIntegerZero_One
1: [       OK ] MultiplyTests.TestIntegerZero_One (0 ms)
1: [----------] 3 tests from MultiplyTests (0 ms total)
1:
1: [----------] Global test environment tear-down
1: [==========] 3 tests from 1 test suite ran. (0 ms total)
1: [  PASSED  ] 3 tests.
1/1 Test #1: multiply_gtests ..................   Passed    0.04 sec100% tests passed, 0 tests failed out of 1Total Test time (real) =   0.05 sec

相关内容

热门资讯

安卓怎么传到苹果系统,从安卓到... 你是不是也有过这样的烦恼:手机里存了好多好用的安卓应用,可是一换到苹果系统,就发现这些宝贝们都不见了...
安卓改系统字体app,安卓系统... 你有没有想过,手机上的字体也能变得个性十足?没错,就是那个安卓改系统字体app,它可是让手机界面焕然...
安卓系统重启密码错误,破解与预... 手机突然重启了,屏幕上竟然出现了密码输入的界面!这可怎么办?别急,让我来帮你一步步解决这个安卓系统重...
安卓系统怎么删除相片,照片删除... 手机里的相片越来越多,是不是感觉内存都要不够用了?别急,今天就来教你怎么在安卓系统里轻松删除那些不再...
什么安卓机系统最好,安卓系统最... 你有没有想过,手机里那个默默无闻的系统,其实才是决定你手机体验好坏的关键呢?没错,说的就是安卓机系统...
小米手环8安卓系统,智能生活新... 你有没有注意到,最近小米手环8安卓系统成了大家热议的话题呢?这款智能手环自从上市以来,就凭借其强大的...
虹膜系统怎么换为安卓,技术革新... 你有没有想过,你的虹膜系统怎么换为安卓呢?这可是个挺酷的话题,不是吗?想象你的手机上装了个高科技的虹...
安卓刷苹果mac系统,探索跨平... 你有没有想过,你的安卓手机竟然能变身成为苹果Mac系统的超级战士?没错,这就是今天我要跟你分享的神奇...
安卓系统不模仿苹果,不模仿苹果... 你知道吗?在科技圈里,有一场关于操作系统的大戏正在上演。没错,就是安卓系统和苹果iOS系统之间的较量...
安卓系统计步开启,开启健康生活... 你有没有发现,最近你的手机里多了一个小助手——计步器?没错,就是那个默默记录你每一步的小家伙。今天,...
怎么备份安卓系统 recove... 你有没有想过,如果你的安卓手机突然间像顽皮的小猫一样,把你的照片、视频和重要文件都给“藏”了起来?别...
安卓系统同步功能停用,安卓系统... 最近发现了一个让人有点小郁闷的消息——安卓系统的同步功能竟然被停用了!这可真是让人有点措手不及呢。想...
安卓系统的平板重装系统,轻松恢... 你那安卓平板是不是突然间卡得跟蜗牛似的,系统反应慢得跟乌龟赛跑似的?别急,今天就来给你支个招,教你怎...
安卓操作系统语言,引领智能时代... 你知道吗?在手机世界里,有一个超级厉害的操作系统,它就是安卓!这个操作系统可是全球最流行的,几乎每个...
安卓系统声音录音软件,声音记录... 你有没有想过,在安卓手机上,那些美妙的旋律、有趣的对话或者重要的会议内容,如何变成你随时可以回顾的宝...
coloros系统和安卓9,创... 你知道吗?最近手机圈里可是热闹非凡呢!一款名为ColorOS的系统,还有那个大家熟悉的安卓9,它们俩...
安卓个推系统搭建,基于个推系统... 你有没有想过,自己的手机里那些推送消息是怎么悄无声息地出现在你眼前的?没错,就是安卓个推系统在默默为...
设置系统时间app安卓,安卓时... 你有没有想过,手机里那个默默无闻的系统时间,竟然能通过一个小巧的App变得如此有趣和个性化?没错,今...
安卓系统输出开关量,安卓系统开... 你有没有想过,你的安卓手机里竟然隐藏着这么一个神奇的开关量输出功能?没错,就是那个你可能从未留意过的...
安卓系统音乐软件推荐,五大热门... 你有没有发现,手机里音乐软件那么多,挑一款适合自己的真心不容易啊!安卓系统上的音乐软件更是五花八门,...