gtest使用方法

关注

转载最新推荐文章于 2025-05-22 17:01:49 发布 1k 阅读 AI 写同款· GEO 优化 ›

单元测试gtest的安装与使用方法【结合官网的sample】 gtest单元测试是Google的一套用于编写C++测试的框架，可以运行在很多平台上（包括Linux、Mac OS X、Windows、Cygwin等等）。基于xUnit架构。支持很多好用的特性，包括自动识别测试、丰富的断言、断言自定义、死亡测试、非终止的失败、生成XML报告等等，本文对gtest的安装以及基本使用方法进行细致说明，希望对您有所帮助。阅读详情

（0）gtest是什么
gtest是一个跨平台的C++测试框架，google作品。
它支持自动发现测试，断言集，用户定义的断言，death测试，致命与非致命的失败，类型参数化测试，各类运行测试的选项和XML的测试报告。

（1）下载gtest
地址：
http://code.google.com/p/googletest/downloads/list
笔者下载的版本是1.6.0
http://googletest.googlecode.com/files/gtest-1.6.0.zip

（2）安装gtest

1

2

3

4

 
        unzip gtest-1.6.0.zip
       
        cd
        gtest-1.6.0
       
        .
        /configure
       
        make

确认lib目录下生成了libgtest.a和libgtest_main.a，
这两个库是后续测试程序需要链接的库。

（3）测试gtest
不妨设我们需要测试foo.h中的一个max函数（求两个数中较大的一个）
foo.h文件内如如下：

1

2

3

4

5

6

7

 
        #ifndef __FOO_H__
       
        #define __FOO_H__
       
        int
        max(
        int
        a, 
        int
        b)
       
        {
       
        return
        a>b?a:b;
       
        }
       
        #endif

撰写测试程序foo_test.cpp来对foo进行测试：
foo_test.cpp文件内如如下：

 
        #include "gtest/gtest.h"
       
        #include "foo.h"
       
        TEST(foo, max)
       
        {
       
        EXPECT_EQ(2, max(2,-1));
       
        EXPECT_EQ(3, max(2,3));
       
        }
       
        int
        main(
        int
        argc, 
        char
        ** argv)
       
        {
       
        ::testing::InitGoogleTest(&argc, argv);
       
        return
        RUN_ALL_TESTS();
       
        }

编译foo_test.cpp，编译命令如下：

1

2

3

 
        g++ -g foo_test.cpp -o foo_test \
       
 
        -I.
        /gtest-1
        .6.0
        /include
        \
       
 
        -L.
        /gtest-1
        .6.0
        /lib
        -lgtest -lgtest_main -lpthread
       

需要注意的是，要链接pthread这个库。

执行结果如下：
[==========] Running 1 test from 1 test case.
[==========] Global test environment set-up.
[==========] 1 test from foo
[ RUN ] foo.max
[ OK ] foo.max (0 ms)
[==========] 1 test from foo (0 ms total)

[==========] Global test environment tear-down
[==========] 1 test from 1 test case ran. (0 ms total)
[ PASSED ] 1 test.

（4）简要说明

1

2

3

4

 
        TEST(name1, name2)
       
        {
       
        EXPECT_EQ(value1, value2);
       
        }

这是要执行的测试用例，后面是执行内容
name1：测试用例名称
name2：测试名称
这两个参数都只起到提示作用，我们也可以这么使用
name1：类名
name2：方法名
或者
name1：文件名
name2：函数名

EXPECT_EQ(value1, value2);
用例执行成功时，期望value1和value2是相等的，相等才算通过测试，如上例中的：
EXPECT_EQ(2, max(2,-1));
max(2, -1)的执行结果值期望是2如果不等，则用例运行失败。

1

2

3

4

5

 
        int
        main(
        int
        argc, 
        char
        ** argv)
       
        {
       
        ::testing::InitGoogleTest(&argc, argv);
       
        return
        RUN_ALL_TESTS();
       
        }

这个是main函数，InitGoogleTest会初始化一些环境变量，RUN_ALL_TESTS()会调用所有的TEST(name1, name2)

（6）结束语
想了解更详细的关于gtest的信息，见官网：
http://code.google.com/p/googletest/

编写测试用例
本例中要测试的是一个求阶乘的函数

函数头文件:func.H

[cpp]view plaincopyprint? 
   
 #ifndef FUNC_H  
 #define FUNC_H  
 int fac(int nInput);  
 #endif  

函数实现文件：func.C

[cpp]view plaincopyprint? 
   
 #include "func.H"  
 int fac(int nInput)  
 {  
     if(nInput < 0)  
     {  
         return -1;  
     }  
   
     int nRev = 1;  
     for(int i = 1; i <= nInput; ++i)  
     {  
         nRev *= i;  
     }  
     return nRev;  
 }  

主程序文件：主程序文件：fac_test.C

[cpp]view plaincopyprint? 
   
 #include <limits>  
 #include "func.H"  
 #include "gtest/gtest.h"  
   
 TEST(Fac_test, input_negative){  
     EXPECT_EQ(-1, fac(-1));  
     EXPECT_EQ(-1, fac(-2));  
     EXPECT_EQ(-1, fac(-5));  
 }  
   
 TEST(Fac_test, input_zero){  
     EXPECT_EQ(1, fac(0));  
 }  
   
 TEST(Fac_test, input_positive){  
     EXPECT_EQ(1, fac(1));  
     EXPECT_EQ(2, fac(2));  
     EXPECT_EQ(6, fac(3));  
 }  

将这三个文件都放在$/HOME/demo目录下。

4. 修改Makefile文件，然后编译

拷贝Makefile文件
cp $HOME/bin/gtest-1.6.0/make/Makefile $/HOME/demo/

需要修改的地方
1. 变量 GTEST_DIR USER_DIR TESTS
2. 最后Builds的输入输出

修改后的Makefile：

[cpp]view plaincopyprint? 
   
 # Points to the root of Google Test, relative to where this file is.  
 # Remember to tweak this if you move this file.  
 GTEST_DIR = ../bin/gtest-1.6.0  
   
 # Where to find user code.  
 USER_DIR = ./  
   
 # Flags passed to the preprocessor.  
 CPPFLAGS += -I$(GTEST_DIR)/include  
   
 # Flags passed to the C++ compiler.  
 CXXFLAGS += -g -Wall -Wextra  
   
 # All tests produced by this Makefile.  Remember to add new tests you  
 # created to the list.  
 TESTS = fac_test  
   
 # All Google Test headers.  Usually you shouldn't change this  
 # definition.  
 GTEST_HEADERS = $(GTEST_DIR)/include/gtest/*.h \  
                 $(GTEST_DIR)/include/gtest/internal/*.h  
   
 # House-keeping build targets.  
   
 all : $(TESTS)  
   
 clean :  
     rm -f $(TESTS) gtest.a gtest_main.a *.o  
   
 # Builds gtest.a and gtest_main.a.  
   
 # Usually you shouldn't tweak such internal variables, indicated by a  
 # trailing _.  
 GTEST_SRCS_ = $(GTEST_DIR)/src/*.cc $(GTEST_DIR)/src/*.h $(GTEST_HEADERS)  
   
 # For simplicity and to avoid depending on Google Test's  
 # implementation details, the dependencies specified below are  
 # conservative and not optimized.  This is fine as Google Test  
 # compiles fast and for ordinary users its source rarely changes.  
 gtest-all.o : $(GTEST_SRCS_)  
     $(CXX) $(CPPFLAGS) -I$(GTEST_DIR) $(CXXFLAGS) -c \  
             $(GTEST_DIR)/src/gtest-all.cc  
   
 gtest_main.o : $(GTEST_SRCS_)  
     $(CXX) $(CPPFLAGS) -I$(GTEST_DIR) $(CXXFLAGS) -c \  
             $(GTEST_DIR)/src/gtest_main.cc  
   
 gtest.a : gtest-all.o  
     $(AR) $(ARFLAGS) $@ $^  
   
 gtest_main.a : gtest-all.o gtest_main.o  
     $(AR) $(ARFLAGS) $@ $^  
   
 # Builds a sample test.  A test should link with either gtest.a or  
 # gtest_main.a, depending on whether it defines its own main()  
 # function.  
   
 func.o : $(USER_DIR)/func.C $(USER_DIR)/func.H $(GTEST_HEADERS)  
     $(CXX) $(CPPFLAGS) $(CXXFLAGS) -c $(USER_DIR)/func.C  
   
 fac_test.o : $(USER_DIR)/fac_test.C $(USER_DIR)/func.H $(GTEST_HEADERS)  
     $(CXX) $(CPPFLAGS) $(CXXFLAGS) -c $(USER_DIR)/fac_test.C  
   
 fac_test : func.o fac_test.o gtest_main.a  
     $(CXX) $(CPPFLAGS) $(CXXFLAGS) -lpthread $^ -o $@  