一、googletest简介
本文使用googletest进行单元测试,这里先简要介绍一下googletest。googletest(简称gtest)是一个跨平台的并且开源的(Linux、Mac OS X、Windows、Cygwin、Windows CE and Symbian)C++单元测试框架,由google公司发布。gtest是为在不同平台上为编写C++测试而生成的。它提供了丰富的断言、致命和非致命判断、参数化、“死亡测试”等。
二、相关的准备工作
本文的内容基于win10+vs2015使用googletest框架进行C++单元测试,那么我们要做的第一个工作就是去下载和配置googletest,以便于我们接下来进行使用。
2.1下载源码
到https://github.com/google/googletest这个地址去下载googletest的源码为我们下一步进行编译做准备。
2.2编译googletest源码生成我们需要的库文件
下载完成之后我们得到的是一个zip格式的压缩文件,我们将其解压到合适的目录(以方便自己查找为原则)。这里我们需要注意两个文件夹,待会需要使用。
使用vs2015打开msvc/2010里面的gtest.sln,会提示升级VC++编译器和库,点击确定即可。
等待升级完成后,打开gtest项目属性对话框(可以右键单击项目名,打开属性),配置工程属性。按图中两种方式修改都是可以的(注意和后面测试项目的属性设置比较)。
Debug、Release两个模式都要编译。
在编译时会出现“无法启动程序”字样,这是正常的,因为我们只是生成了相关的库文件,并不是可执行文件。
编译后,在msvc/2010/gtest/下有Win32-Debug、Win32-Release两个文件夹,并且每个文件夹里面有一个gtestd.lib文件,如下图所示。
至此,准备阶段完成。
2.3必要知识学习
断言:gtest中采用了大量的宏来包装断言,这里的断言不同于C语言当中的断言(assert)。
按照其使用方法可以分为两类:
- ASSERT系列(ASSERT_&系列,当检查点失败时,退出当前函数,并非推出当前案例);
- EXPECT系列(EXPECT_*系列的断言,当检查点失败时,继续往下执行)。
按照常用功能可以依次分为12类,平常主要用到的以下这几类:
- 布尔值比较
- 数值型数据比较
- 字符串比较
- 浮点数比较
- 近似数比较
- 异常检测
- 自定义格式函数与参数检查
布尔值比较 | ||
ASSERT_TRUE(condition) | EXPECT_TRUE(condition) | condition == true |
ASSERT_FALSE(condition) | EXPECT_FALSE(condition) | condition == false |
数值型数据比较 | ||
ASSERT_EQ (expected, actual) | EXPECT_EQ (expected, actual) | expected == actual |
ASSERT_NE (val1, val2) | EXPECT_NE (val1, val2) | val1 != val2 |
ASSERT_LT (val1, val2) | EXPECT_LT (val1, val2) | val1 < val2 |
ASSERT_LE (val1, val2) | EXPECT_LE (val1, val2) | val1 <= val2 |
ASSERT_GT (val1, val2) | EXPECT_GT (val1, val2) | val1 > val2 |
ASSERT_GE (val1, val2) | EXPECT_GE (val1, val2) | val2 >= val2 |
字符串比较 | ||
ASSERT_STREQ (str1, str2) | EXPECT_STREQ (str1, str2) | 两个C字符串内容相同(同时支持char *和wchar_t *类型) |
ASSERT_STRNE (str1, str2) | EXPECT_STRNE (str1, str2) | 两个C字符串内容不同(同时支持char *和wchar_t *类型) |
ASSERT_STRCASEEQ (str1, str2) | EXPECT_STRCASEEQ (str1, str2) | 两个C字符串内容相同,忽略大小写(只支持char *类型) |
ASSERT_STRCASENE (str1, str2) | EXPECT_STRCASENE (str1, str2) | 两个C字符串内容不同,忽略大小写(只支持char *类型) |
浮点数比较 | ||
ASSERT_FLOAT_EQ (val1, val2) | EXPECT_FLOAT_EQ (val1, val2) | the two float values are almost equal |
ASSERT_DOUBLE_EQ (val1, val2) | EXPECT_DOUBLE_EQ (val1, val2) | the two double values are almost equal |
近似数比较 | ||
ASSERT_NEAR (val1, val2, abs_error) | EXPECT_NEAR (val1, val2, abs_error) | 两个数值val1和val2的绝对值差不超过abs_error |
|
|
|
| ||
异常检查 | ||
ASSERT_THROW (statement, exception_type) | EXPECT_THROW (statement, exception_type) | 抛出指定类型异常 |
ASSERT_THROW(statement) | EXPECT_THROW(statement) | 抛出任意类型异常 |
ASSERT_NO_THROW(statement) | EXPECT_NO_THROW(statement) | 不抛异常 |
| ||
函数值与参数检查(目前最多只支持5个参数) | ||
ASSERT_PRED1(pred1, val1) | EXPECT_PRED1(pred1, val1) | pred1(val1) returns true |
ASSERT_PRED2(pred2, val1, val2) | EXPECT_PRED2(pred2, val1, val2) | pred2(val1, val2) returns true |
| ||
Windows HRESULT | ||
ASSERT_HRESULT_SUCCEEDED(expression) | EXPECT_HRESULT_SUCCEEDED(expression) | expression is a success HRESULT |
ASSERT_HRESULT_FAILED(expression) | EXPECT_HRESULT_FAILED(expression) | expression is a failure HRESULT |
| ||
自定义格式函数与参数检查(目前最多支持5个参数) | ||
ASSERT_PRED_FORMAT1(pred1, val1) | EXPECT_PRED_FORMAT1(pred1, val1) | pred1(val1) is successful |
ASSERT_PRED_FORMAT1(pred1, val1, val2) | EXPECT_PRED_FORMAT1(pred1, val1, val2) | pred2(val1, val2) is successful |
2.4创建测试项目并配置属性
在vs2015中,创建Win32控制台应用程序MyTest。
打开项目属性对话框,配置工程属性。展开“配置属性 -> C/C++ -> 常规”,在【附加包含目录】中添加“.\include”(这里省略了include的相关母目录,在之前有过关于include的说明,如果忘记在哪找,可以在前边的内容中复习一下);展开“C/C++ -> 代码生成”,在【运行库】中修改为多线程调试DLL(/MDd),如下图所示。
展开“链接器 -> 输入”,在【附加依赖项】添加刚刚生成的lib文件路径,注意这里是配置Debug,要输入Win32-Debug里面的gtestd.lib文件路径(这里需要注意文件名后面有个d)。
以上就是配置Debug的方式,配置Release只需要把前边相对应的位置改为Release的相关内容即可。
2.5编写测试代码
这里测试代码主要分为3个文件,主文件FirstGtest.cpp,以及Box类的两个相关文件CBox.h和CBox.cpp
1 // CBox.h 2 #pragma once 3 #include <string.h> 4 5 //Box类的定义 6 class CBox 7 { 8 public: 9 //构造函数 10 CBox(double length_value, double width_value, double height_value); 11 //默认构造函数 12 CBox(); 13 //volume函数用于计算Box的体积 14 double volume(); 15 16 private: 17 //Box的3个特性:长、宽、高 18 double Length_of_box; 19 double Width_of_box; 20 double Height_of_box; 21 };
1 //FirstGtest.cpp 2 #include"stdafx.h" 3 #include"gtest\gtest.h" 4 #include"CBox.h" 5 6 //CBox测试类,继承Test对Box进行测试使用 7 class CBox_test : public testing::Test 8 { 9 protected: 10 CBox* c; 11 virtual void SetUp() 12 { 13 c = new CBox(2, 3, 4); 14 } 15 16 virtual void TearDown() 17 { 18 delete this->c; 19 } 20 }; 21 22 TEST(CBox, case1) 23 { 24 CBox box1{ 78.0, 24.0, 18.0 }; 25 CBox box2; 26 EXPECT_LT(23.0, box1.volume()); 27 } 28 29 TEST_F(CBox_test, case2) 30 { 31 EXPECT_EQ(4, c->volume()); 32 } 33 34 int main(int argc, char* argv[]) 35 { 36 testing::InitGoogleTest(&argc, argv); 37 return RUN_ALL_TESTS(); 38 }
1 //CBox.cpp 2 #include "stdafx.h" 3 #include<iostream> 4 #include"CBox.h" 5 6 using namespace std; 7 8 //构造函数定义,包含3个参数: 9 CBox::CBox(double length_value, double width_value, double height_value) 10 { 11 cout << "Constructor called." << endl; 12 Length_of_box = length_value; 13 Width_of_box = width_value; 14 Height_of_box = height_value; 15 } 16 17 //默认构造函数 18 CBox::CBox() 19 { 20 cout << "Default constructor is called." << endl; 21 } 22 23 24 // 计算Box体积函数 25 double CBox::volume() 26 { 27 return Length_of_box * Width_of_box * Height_of_box; 28 }
三、遇到的问题及解决办法
- 在生成两个gtestd.lib文件时,编译器报“不是有效的Win32应用程序”,因为之前写的程序都是生成可执行程序,而没有做过只生成库文件的程序,本能地以为程序出错了,之后经过查阅资料和以及进一步地深入研究,发现这里只是生成了依赖库文件(我们也只需要这个库),并没有生成可执行文件,所以那是正常的。
- 配置googletest依赖库时,“配置属性 -> C/C++ -> 代码生成”中的【运行库】,前后没有设置相同的模式,从而导致找不到对应的库的情况。
- 在配置googletest时,修改“配置属性 -> 链接器 -> 输入”中的【附加依赖项】时,只填到了我们所生成的库文件的目录,但是没有添加文件名,报找不到*.obj文件的错误,只需要把路径填写到库文件就可以解决这个问题。
作者:耑新新,发布于 博客园
转载请注明出处,欢迎邮件交流:zhuanxinxin@foxmail.com