C++ 测试框架 GoogleTest 初学者入门篇 乙
经常会听到开发者提起单元测试的话题，那么今天我就带大伙一起来看看大名鼎鼎的谷歌 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 并更新安装缓冲，最后开始安装，下面的指令可依次操作
# 卸载 cmake
sudo apt purge --auto-remove cmake
# 下载 cmake 安装包，
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
sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ bionic main'
sudo apt update
sudo apt install cmake
下载编译 gtest 开发包
下载安装源码包
sudo apt-get install libgtest-dev
进入源码安装目录，执行编译
cd /usr/src/gtest
sudo cmake CMakeLists.txt
sudo make
编译完之后，我看到网上有些教程会推荐直接拷贝库文件(.a)到 /usr/lib 目录
sudo cp *.a /usr/lib
不过，我建议是直接用 install 命令，这样库文件和头文件都可以一步部署到位
sudo make install
好了，到这里 ubuntu 下面的 googletest 就安装结束了，你也可用之前的应用样例来验证一下环境是否 OK 。
Windows 平台
在 Windows 平台安装最新版 cmake 比较简单，这里掠过。
我这里安装的版本是
cmake version 3.24.2
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)
mkdir build && cd build
cmake ..
cmake --build .
编译成功后，在目录 .\build\lib\Debug 下面多了很多生成文件，但是我们只需要这两个静态库文件
gtest.lib
gtest_main.lib
那么，怎么输出动态的调试版本库文件(.lib)呢？
按照上图修改保存，然后输入和上面一样的编译指令即可。
编译成功后，在目录 .\build\bin\Debug 下面多了很多生成文件，但是我们只要这两个动态库文件
gtest.dll
gtest_main.dll
另外，和编译静态库文件一样，在目录 .\build\lib\Debug 下生成的这两个静态库文件也是需要的，用于链接目标 exe 文件。
gtest.dll
gtest_main.dll
测试工程配置示例
新建一个测试工程 TEST，调用 googletest 库分为静态调用和动态调用，分别对应上一节的两种输出文件，现在就分开来演示一下怎么配置目标测试工程。
TEST 工程只有一个源码文件 main.cpp
调用静态调试库
首先，需要找到 googletest 的源码目录下的 .\googletest\include\gtest
把整个文件夹拷贝到目标测试工程 TEST 目录下，然后把 gtest 编译输出的静态库文件(.lib)也拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下
然后看一下 CMakeLists.txt 可以这样写
cmake_minimum_required(VERSION 2.14)
project(runTests)
# Locate GTest
include_directories(${CMAKE_CURRENT_SOURCE_DIR})
message("CMAKE_CURRENT_SOURCE_DIR:" ${CMAKE_CURRENT_SOURCE_DIR})
link_directories(${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib)
# for window static debug
set(CMAKE_CXX_FLAGS_DEBUG "/MTd")
# for window dynamic debug
# set(CMAKE_CXX_FLAGS_DEBUG "/MDd")
# for window dynamic release
# set(CMAKE_CXX_FLAGS_DEBUG "/MD")
# for window static release
# set(CMAKE_CXX_FLAGS_DEBUG "/MT")
# Link runTests with what we want to test and the GTest and pthread library
add_executable(${PROJECT_NAME} main.cpp)
target_link_libraries(${PROJECT_NAME}
gtest
gtest_main)
Cmake 工程的编译方法都是一样的，照搬上面提到的编译指令即可，这里略过
调用动态调试库
配置过程，和调用静态调试库是差不多的，但是在把 gtest 编译输出的静态库文件(.lib)拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下时，也需要把 gtest 编译输出的动态库文件(.dll)一起拷贝到目标测试工程 TEST 的 .\gtest\lib 目录下，这样的目的是为了在测试工程 TEST 编译的过程中，方便部署可执行文件(.exe)的运行环境，也就是 exe 文件依赖的 googletest 库文件。
然后看一下 CMakeLists.txt 可以这样写
# for default window dynamic debug
cmake_minimum_required(VERSION 2.14)
project(runTests)
set(DESTINATION_DIR ${PROJECT_BINARY_DIR}/Debug)
execute_process( COMMAND ${CMAKE_COMMAND} -E make_directory ${DESTINATION_DIR})
execute_process( COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib/gtest_main.dll ${DESTINATION_DIR})
execute_process( COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib/gtest.dll ${DESTINATION_DIR})
# Locate GTest
include_directories(${CMAKE_CURRENT_SOURCE_DIR})
message("CMAKE_CURRENT_SOURCE_DIR:" ${CMAKE_CURRENT_SOURCE_DIR})
link_directories(${CMAKE_CURRENT_SOURCE_DIR}/gtest/lib)
# Link runTests with what we want to test and the GTest and pthread library
add_executable(${PROJECT_NAME} main.cpp)
target_link_libraries(${PROJECT_NAME}
gtest
gtest_main)
在 cmake 运行过程中，会把 exe 文件依赖的 googletest 库文件(.dll)拷贝到即将生成的 exe 文件的存放位置。
由于篇幅受限，本系列教程还未完结，下一篇《C++ 测试框架 GoogleTest 初学者入门篇 丙》将在本公众号稍后推送，如果你想看了解更多精彩内容，欢迎关注我的微信公众号 【ENG八戒】
学习可以等，时间不等人！
关注我，带你学习编程领域更多核心技能！
