C++ 测试框架 GoogleTest 初学者入门篇 乙

*以下内容为本人的学习笔记，如需要转载，请声明原文链接微信公众号「ENG八戒」https://mp.weixin.qq.com/s/aFeiOGO-N9O7Ab_8KJ2wxw

开发者虽然主要负责工程里的开发任务，但是每个开发完毕的功能都是需要开发者自测通过的，所以经常会听到开发者提起单元测试的话题。那么今天我就带大伙一起来看看大名鼎鼎的谷歌 C++ 测试框架 GoogleTest.
本文上接《C++ 测试框架 GoogleTest 初学者入门篇 甲》，欢迎关注微信公众号【ENG八戒】查看更多精彩内容。

安装配置环境

Googletest 的安装配置过程并不复杂，但是对于小白来说还是有些困难，所以很有必要手把手说一下。
为了更清晰地说明环境配置过程，下面会选择对 Googletest 源码执行编译，然后安装。编译源码时，Googletest 官方手册推荐使用的工具有两种，这里只介绍其中的 Cmake。
其实在各个平台，用户都有使用 Googletest 的需求，这里专挑 Linux 和 Windows 平台来分别说明怎么安装配置 Googletest。
linux 平台

我的虚拟机里 Linux 系统是 Ubuntu 18.04，使用 apt 在线直接安装的 cmake 版本最高只能去到 3.10，为了顺利编译最新版的 Googletest 源码，选择安装官网最新版的 cmake。
安装最新版 cmake

先卸载原来的 cmake 版本，再添加指定安装源为 kitware.com 并更新安装缓冲，最后开始安装，下面的指令可依次操作

1. # 卸载 cmake
2. sudo apt purge --auto-remove cmake
4. # 下载 cmake 安装包，
5. wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /etc/apt/trusted.gpg.d/kitware.gpg >/dev/null
7. sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ bionic main'
9. sudo apt update
11. sudo apt install cmake

复制代码

下载编译 gtest 开发包

下载安装源码包

1. sudo apt-get install libgtest-dev

复制代码

进入源码安装目录，执行编译

1. cd /usr/src/gtest
2. sudo cmake CMakeLists.txt
3. sudo make

复制代码

编译完之后，我看到网上有些教程会推荐直接拷贝库文件(.a)到 /usr/lib 目录

1. sudo cp *.a /usr/lib

复制代码

不过，我建议是直接用 install 命令，这样库文件和头文件都可以一步部署到位

1. sudo make install

复制代码

好了，到这里 ubuntu 下面的 googletest 就安装结束了，你也可用之前的应用样例来验证一下环境是否 OK 。
Windows 平台

在 Windows 平台安装最新版 cmake 比较简单，这里掠过。
我这里安装的版本是

1. cmake version 3.24.2
3. CMake suite maintained and supported by Kitware (kitware.com/cmake).

复制代码

下载编译 googletest 源码包

这里选择 googletest 的最新稳定版源码包，可以去 github 下载，下面贴出我这边实验用的下载链接

https://codeload.github.com/google/googletest/zip/refs/tags/v1.13.0

下载之后解压到本地文件夹，进到这个本地文件夹，然后启动命令行终端 cmd，当前位置应该是这个本地文件夹，接着按照下面的指令去编译，默认输出静态的调试版本库文件(.lib)

1. mkdir build && cd build
2. cmake ..
3. cmake --build .

复制代码

编译成功后，在目录 .\build\lib\Debug 下面多了很多生成文件，但是我们只需要这两个静态库文件

1. gtest.lib
2. gtest_main.lib

复制代码

那么，怎么输出动态的调试版本库文件(.lib)呢？

按照上图修改保存，然后输入和上面一样的编译指令即可。
编译成功后，在目录 .\build\bin\Debug 下面多了很多生成文件，但是我们只要这两个动态库文件

1. gtest.dll
2. gtest_main.dll

复制代码

另外，和编译静态库文件一样，在目录 .\build\lib\Debug 下生成的这两个静态库文件也是需要的，用于链接目标 exe 文件。

1. gtest.dll
2. gtest_main.dll

复制代码

测试工程配置示例

新建一个测试工程 TEST，调用 googletest 库分为静态调用和动态调用，分别对应上一节的两种输出文件，现在就分开来演示一下怎么配置目标测试工程。
TEST 工程只有一个源码文件 main.cpp
调用静态调试库
首先，需要找到 googletest 的源码目录下的 .\googletest\include\gtest

把整个文件夹拷贝到目标测试工程 TEST 目录下，然后把 gtest 编译输出的静态库文件(.lib)也拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下

然后看一下 CMakeLists.txt 可以这样写

1. cmake_minimum_required(VERSION 2.14)
3. project(runTests)
5. # Locate GTest
6. include_directories(${CMAKE_CURRENT_SOURCE_DIR})
7. message("CMAKE_CURRENT_SOURCE_DIR:" ${CMAKE_CURRENT_SOURCE_DIR})
9. link_directories(${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib)
11. # for window static debug
12. set(CMAKE_CXX_FLAGS_DEBUG "/MTd")
13. # for window dynamic debug
14. # set(CMAKE_CXX_FLAGS_DEBUG "/MDd")
15. # for window dynamic release
16. # set(CMAKE_CXX_FLAGS_DEBUG "/MD")
17. # for window static release
18. # set(CMAKE_CXX_FLAGS_DEBUG "/MT")
20. # Link runTests with what we want to test and the GTest and pthread library
21. add_executable(${PROJECT_NAME} main.cpp)
22. target_link_libraries(${PROJECT_NAME}
23.                         gtest
24.                         gtest_main)

复制代码

Cmake 工程的编译方法都是一样的，照搬上面提到的编译指令即可，这里略过
调用动态调试库
配置过程，和调用静态调试库是差不多的，但是在把 gtest 编译输出的静态库文件(.lib)拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下时，也需要把 gtest 编译输出的动态库文件(.dll)一起拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下，这样的目的是为了在测试工程 TEST 编译的过程中，方便部署可执行文件(.exe)的运行环境，也就是 exe 文件依赖的 googletest 库文件。
然后看一下 CMakeLists.txt 可以这样写

1. # for default window dynamic debug
2. cmake_minimum_required(VERSION 2.14)
4. project(runTests)
6. set(DESTINATION_DIR ${PROJECT_BINARY_DIR}/Debug)
7. execute_process( COMMAND ${CMAKE_COMMAND} -E make_directory ${DESTINATION_DIR})
8. execute_process( COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib/gtest_main.dll ${DESTINATION_DIR})
9. execute_process( COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib/gtest.dll ${DESTINATION_DIR})
11. # Locate GTest
12. include_directories(${CMAKE_CURRENT_SOURCE_DIR})
13. message("CMAKE_CURRENT_SOURCE_DIR:" ${CMAKE_CURRENT_SOURCE_DIR})
15. link_directories(${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib)
17. # Link runTests with what we want to test and the GTest and pthread library
18. add_executable(${PROJECT_NAME} main.cpp)
19. target_link_libraries(${PROJECT_NAME}
20.                         gtest
21.                         gtest_main)

复制代码

在 cmake 运行过程中，会把 exe 文件依赖的 googletest 库文件(.dll)拷贝到即将生成的 exe 文件的存放位置。
由于篇幅受限，本系列教程还未完结，下一篇《C++ 测试框架 GoogleTest 初学者入门篇 丙》将在本公众号稍后推送，如果你想看了解更多精彩内容，欢迎关注我的微信公众号 【ENG八戒】

学习可以等，时间不等人！

关注我，带你学习编程领域更多核心技能！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！