cppUnit快速使用指南

【原文写于22 January 2007 ，注】

VC下cppUnit快速使用指南

编译
打开cppUnit/src/CppUnitLibraries.dsw，build->batch build，全部build
编译后得到所需库文件，在cppUnit/lib

安装
将cppUnit/include加入到VC include目录
将cppUnit/lib加入到VC library目录
将cppUnit/lib加入到VC executable目录，以使能够定位到testrunner(d).dll
如果是VC6的话，Tools/Customize…/Add-ins and macro files/Browse…，选择cppUnit/lib/TestRunnerDSPlugIn.dll，这样使用cppUnit的编译器输出可以直接到达源文件行

安装测试
打开cppunit/examples/examples.dsw
找到CppUnitTestApp，这是cppunit自测试的MFC GUI版本，set as Active Project，运行
（在实验室机器上编译有错，打开XmlUniformiser.cpp, line 38, message.str()修改为message.str().c_str()，编译通过。不知道是不是stlport的问题）
browse->选择All Tests->run，如果green，表示安装成功，运行正常

找到CppUnitTestMain，这是cppunit自测试的编译器输出版本，set as Active Project，build（不必run）
如果打印出OK (219)，表示成功

使用

MFC（testrunner）
新建MFC对话框工程
修改工程设置：
Code generation，设为Multithreaded DLL
C++ langage，勾选RTTI
添加库cppunitd.lib(debug版）或cppunit.lib（release版）

在CXXXApp::InitInstance()中，注释掉原来的生成对话框代码，在该处加入以下代码

CppUnit::Test * suite = CppUnit::TestFactoryRegistry::getRegistry().makeTest();
CppUnit::MfcUi::TestRunner runner;
runner.addTest(suite);
runner.run();

并在前边加入头文件
#include <cppunit/ui/mfc/TestRunner.h>
#include <cppunit/extensions/TestFactoryRegistry.h>

然后编写测试用例
如果要使用cppunit的dll版本，在工程中添加CPPUNIT_DLL定义（Preprocessor definitions）

#include <cppunit/extensions/HelperMacros.h>

class CXXXTest : public CppUnit::TestFixture
{
CPPUNIT_TEST_SUITE(CXXXTest);
CPPUNIT_TEST(test_a);
CPPUNIT_TEST(test_b);
CPPUNIT_TEST(test_c);
CPPUNIT_TEST_SUITE_END();
public:
void test_a();
void test_b();
void test_c();
};
CPPUNIT_TEST_SUITE_REGISTRATION(CXXXTest);

void CXXXTest::test_a()
{
…
CPPUNIT_ASSERT(…);
CPPUNIT_ASSERT_EQUAL(…, …);
…
}

各种ASSERT参见cppUnit文档中Making assertions一章

编译器输出（build即测试）
新建console工程
修改工程设置与MFC GUI方式相同
在工程’post-build step’页中，’Post-build description’, 输入'’Unit testing…’；在’post-build command(s)’中, 添加一行: $(TargetPath)

编写main.cpp

#include <cppunit/CompilerOutputter.h>
#include <cppunit/ui/text/TestRunner.h>
#include <cppunit/extensions/TestFactoryRegistry.h>

int main()
{
CPPUNIT_NS::Test * suite = CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest();
CPPUNIT_NS::TextUi::TestRunner runner;
runner.addTest(suite);

runner.setOutputter( new CPPUNIT_NS::CompilerOutputter(&runner.result(), CPPUNIT_NS::stdCOut()) );
bool ret = runner.run();

return ret ? 0 : 1;
}

编写测试用例与MFC GUI方式相同
build，即同时完成建造和单元测试
测试失败会在建造信息中显示，双击该行信息会自动跳到引起测试失败的CPPUNIT_ASSERT语句