CppUnitLite使用详解

一直想给现在的项目做C++的单元测试，而且也想看看一个单元测试框架的实现。无意中发现了CppUnitLite，CppUnit的轻量级, 确实简单易用。

一. 下载及目录结构
下载地址:(http://download.csdn.net/source/304011), 下载后目录结构如下：
/om
   /CppUnitLite
       /Failure.cpp
       /Failure.h
       /SimpleString.cpp
       /SimpleString.h
       ...
       /CppUnitTests   
       /Cpp
   /StackMain.cpp
   /StackTest.cpp
   /Stack.h
   /readme.txt

其中CppUnitLite根目录下面的几个Failure.h,SimpleString.cpp什么的就是CppUnitLite的核心代码了,而 Cpp文件夹和CppUnitTests文件夹下面则是针对CppUnitLite的测试文件,是VC6.0的项目.readme.txt以Stack为例教我们如何将CppUnitLite应用到我们的项目中(当然你也可以直接打开CppUnitTests文件夹下的CppUnitTests.dsw, 运行结果应该和下面的步骤一致):

二. 快速入门
1.首先建一个C++的静态库项目CppUnitLite,将什么Failure.cpp什么的(也就是上面所谈到核心代码)全部都添加到项目中,编译成CppUnitLite.lib,要去掉预编译选项.

2.再建一个Stack的Win32控制台项目,将StackMain.cpp和StackTest.cpp两个文件加入进来,并且静态链接CppUnitLite.lib,并且设置项目
依赖性:Stack项目依赖于CppUnitLite项目.

3.最后,Run吧.如果前面设置的都正确应该会在Console控制台下显示There were no test failures.

三.自己的项目使用CppUnitLite.

我们如果自己的项目如何使用CppUnitLite这个测试框架,具体说就是要加哪些文件和添哪些代码呢?还是从最简单的入手,看看StackMain.cpp和StackTest.cpp.

StackMain.cpp：

1. #include "CppUnitLite/TestHarness.h"
2. int main()
3. {
4.     TestResult tr;
5.     TestRegistry::runAllTests(tr);
6.     return 0;
7. }

StackTest.cpp:

1. #include "CppUnitLite/TestHarness.h"
2. #include "Stack.h"
3. #include <string>
4. SimpleString StringFrom(const std::string& value)
5. {
6.     return SimpleString(value.c_str());
7. }
8. TEST( Stack, creation )
9. {
10.   Stack s;
11.   LONGS_EQUAL(0, s.size());
12.   std::string b = "asa";
13.   CHECK_EQUAL("asa", b);
14. }

StackMain.cpp就是我们的Main函数,它保证运行所有的TestCase,这个几乎都不用改.
StackTest.cpp就是我们自己要写的代码了,做了些什么事情呢?
添加测试框架头文件"TestHarness.h".
添加你要测的类的头文件"Stack.h"
加入宏TEST,这个宏之后的代码就是你要测的东西.比如,我们要测试1+1=2,就可以这样写:

1. TEST(foo, creation)
2. {
3.    int a = 1;
4.    int b = 1;
5.    int result = a + b;
6.    CHECK(result == 2);
7.    CHECK(result == 3);
8. }

没错的话会有如下提示:Failure: "1 == 2" line 16 in C:/Documents and Settings/jczeng/Desktop/CppUnitLit
e/om/StackTest.cpp
There were 1 failures
Press any key to continue
它会将有几个Case没过和具体哪一行错了都提示出来.

四. MFC下使用CppUnitLite.
上面都只是列举的最简单情况,如果是测试MFC等项目,要注意这么几点:
1.控制台项目要选择支持MFC.
2.由于MFC是支持多线程调试的,要把CppUnitLite中的输出fprintf(stdout,xxx)改成printf.
3.此外,可能还会有些链接错误,具体问题可以查MSDN和下来交流．

<