UnitTest++使用方法

UnitTest++是C++工程下使用的一个非常小巧、方便的单元测试工具。它提供了与CppUnit相似的功能，但它把用例写作的工作量最小化了，使用起来更方便，这些都得益于它的框架构思非常巧妙，如果想知道详细情况可参考源代码。此工具本身不支持VC6，我把它改进了一下。

下面是CppUnit与UnitTest++的简单比较：

1.使用方法 

1.1. 环境准备  

1.1.1. 编译生成UnitTest++.lib文件。 

1.1.2. 设置一个环境变量UNITTEST_CPP_PATH。

1.1.3. 如下图，把UnitTest++的所有头文件复制过来。

1.1.4. 如下图，把刚才编译的.lib文件复制过来。

1.2. 工程设置

需要测试的工程需要做如下设置。

1.2.1. 增加头文件搜索路径：

1.2.2. 增加库文件搜索路径：

1.2.3. 在main()函数所在文件中加载刚才的lib文件。在main()函数中调用UnitTest::RunAllTests();那么所有测试用例便都会被执行了。

1.3. 用例写作

一般可以为每个模块新建一个cpp文件用于写测试用例。

1.3.1. 简单的测试用例

// test.cpp
#include <UnitTest++.h>
TEST(TestCaseName)
{
int ret = TestFunction();
CHECK(ret == SUCCESS);
}

注：

1、 每个测试用例都以TEST开始，后面括号中是用例名字，不允许重复。

2、 一般情况下，检查结果用CHECK宏即可。更多的检查方式可以参考源代码或者UnitTest++自带的文档。下面列举一些常用的宏：

CHECK_EQUAL(expected, actual) 检查是否相等

CHECK_CLOSE(expected, actual, tolerance) 检查在可容忍的误差范围内是否相等(多用于浮点数相等判断)

CHECK_ARRAY_EQUAL(expected, actual, count) 检查数组是否相等，前面两个参数都是数组名字，count是元素个数。

CHECK_ARRAY_CLOSE(expected, actual, count, tolerance) 参考上面两个的说明。

CHECK_ARRAY2D_CLOSE(expected, actual, rows, columns, tolerance) 二维数组。

CHECK_THROW(expression, ExpectedExceptionType)检查是否会抛出指定类型的异常。

CHECK_ASSERT(expression) 检查是否会抛出UnitTest::AssertException类型的异常。

3、 每个测试用例都被自动添加到待运行的用例集合。

1.3.2. 测试套SUIT的使用

如果希望一组测试用例放在一个组中，则可以用SUIT。

SUITE(YourSuiteName)
{
TEST(YourTestName)
{
}
TEST(YourOtherTestName)
{
}
}

1.3.3. FIXTURE的使用

如果希望在一组用例执行前执行某一部分代码（即setUP），测试结束后再执行一段代码（即tearDown），或者是希望多个用例中的数据进行共享，那么可以用FIXTURE。

struct SomeFixture
{
SomeFixture() { /* some setup */ }
~SomeFixture() { /* some teardown */ }
int testData;
};
TEST_FIXTURE(SomeFixture, YourTestName)
{
int temp = testData;
}

注：

1、 使用FIXTURE需要先定义一个结构SomeFixture。

2、 把setUp中要运行的代码放到SomeFixture的构造函数中。

3、 把tearDown中要运行的代码放到SomeFixture的析构函数中。

4、 SomeFixture中的成员可以用于测试数据共享。

5、 每个用例都用TEST_FIXTURE来定义，与TEST宏一样，这样定义的用例也会被自动加入待运行的用例集合。

1.3.4. 限制用例部分代码的执行时间

可以限制用例中的一部分代码只能在规定时间内运行完（如果运行不完，用例fail）。

TEST(YourTimedTest)
{
       // Lengthy setup...
{
UNITTEST_TIME_CONSTRAINT(50);
// Do time-critical stuff
}
// Lengthy teardown...
}

如果“Do time-critical stuff”部分的代码在50ms内没运行完，则用例fail。

1.4. 高级用法 

1.4.1. 修改UnitTest++源代码可以进行功能定制。

int RunAllTests()
{
    TestReporterStdout reporter;
     return RunAllTests(reporter, Test::GetTestList(), 0);
}

1、 在UnitTest++源代码中修改上面的RunAllTests(reporter, Test::GetTestList(), 0)最后一个参数０，可以设置全局的时间约束，即每个用例的执行时间必须少于此时间约束，否则用例fail。

2、 可以改变reporter的类型，从而改变测试结果输出方式。比如用XmlTestReporter把结果输出到xml文件。

1.4.2. 更多的高级用法

通过学习UnitTest++源代码、UnitTest++自身的测试代码来获得。UnitTest++自身的测试代码写得很好，学习它可以了解UnitTest++的功能和测试用例的写作方法。