一、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.h2#pragma once3#include45//Box类的定义6classCBox7{8public:9//构造函数10CBox(doublelength_value,doublewidth_value,doubleheight_value);11//默认构造函数12CBox();13//volume函数用于计算Box的体积14doublevolume();1516private:17//Box的3个特性:长、宽、高18doubleLength_of_box;19doubleWidth_of_box;20doubleHeight_of_box;21};
1 //FirstGtest.cpp2#include"stdafx.h"3#include"gtest\gtest.h"4#include"CBox.h"56//CBox测试类,继承Test对Box进行测试使用7class CBox_test : public testing::Test8 {9protected:10CBox* c;11virtual void SetUp()12{13c =newCBox(2,3,4);14}1516virtual void TearDown()17{18deletethis->c;19}20};2122TEST(CBox, case1)23{24CBox box1{78.0,24.0,18.0};25CBox box2;26EXPECT_LT(23.0, box1.volume());27}2829TEST_F(CBox_test, case2)30{31EXPECT_EQ(4, c->volume());32}3334intmain(intargc, char* argv[])35{36testing::InitGoogleTest(&argc, argv);37returnRUN_ALL_TESTS();38}
1 //CBox.cpp2#include"stdafx.h"3#include4 #include"CBox.h"56usingnamespace std;78//构造函数定义,包含3个参数:9CBox::CBox(double length_value, double width_value, double height_value)10{11cout <<"Constructor called."<< endl;12Length_of_box = length_value;13Width_of_box = width_value;14Height_of_box = height_value;15}1617//默认构造函数18CBox::CBox()19{20cout <<"Default constructor is called."<< endl;21}222324// 计算Box体积函数25double CBox::volume()26{27returnLength_of_box * Width_of_box * Height_of_box;28}
三、遇到的问题及解决办法
在生成两个gtestd.lib文件时,编译器报“不是有效的Win32应用程序”,因为之前写的程序都是生成可执行程序,而没有做过只生成库文件的程序,本能地以为程序出错了,之后经过查阅资料和以及进一步地深入研究,发现这里只是生成了依赖库文件(我们也只需要这个库),并没有生成可执行文件,所以那是正常的。
配置googletest依赖库时,“配置属性 -> C/C++ -> 代码生成”中的【运行库】,前后没有设置相同的模式,从而导致找不到对应的库的情况。
在配置googletest时,修改“配置属性 -> 链接器 -> 输入”中的【附加依赖项】时,只填到了我们所生成的库文件的目录,但是没有添加文件名,报找不到*.obj文件的错误,只需要把路径填写到库文件就可以解决这个问题。