使用CPPUNIT对MFC程序进行测试

1 资源下载

使用的是cppunit-1.12.1 ，在网上下载后 需要自己编译 ，编译过程中可能出现各种问题

在此，将自己编译好的软件放在了资源中，可以直接使用： http://download.csdn.net/detail/shuilan0066/4395617，免去了重复编译的工作。
资源中同时包含CPPUnitProjectWizard

2 环境配置

cppunit不能直接使用，必须先配置好运行环境。

CPPUNIT环境配置：

比如，CPPUNIT安装在E盘 E:\cppunit-1.12.1

1） 定义环境变量 CPPUNITDIR

变量值为： E:\cppunit-1.12.1

2） 修改环境变量PATH,在PATH原有路径的最后，添加 %CPPUNITDIR%/lib, 以便程序加载时能找到 cppunit_dll.dll

3） 在开发环境中，设置好Include/Lib路径

项目-->属性-- 》C/C++ 》常规 下 的 附加包含目录中添加Include : $(CPPUNITDIR)\Include

项目-->属性-- 》连接器 》常规 下 的 附加库目录中添加lib: $(CPPUNITDIR)\lib

CPPUnitProjectWizard环境配置：

1） 解压缩后，复制如下两个文件到Visual Studio 8安装目录下的 VCProjects 文件夹中
… /VC/vcprojects下

CPPUnitProjectWizard.vsdir -为向导命名

CPPUnitProjectWizard.vsz -让VS知道从哪里找到向导

2） 把整个CPPUnitProjectWizard解决方案文件夹复制到您的Visual Studio 8安装目录下的VCWizards文件夹中，比如，我放在…/VC/VCWizards下

然后用记事本编辑CPPUnitProjectWizard.vsz，定义参数 ABSOLUTE_PATH

Param="ABSOLUTE_PATH = …VC/VCWizards/ CPPUnitProjectWizard"
3 CPPUNIT 宏说明

CPPUNIT 通过以下宏来判断是否正确

[cpp]
view plaincopyprint?

CPPUNIT_ASSERT是一个宏，判断后面的参数是否正确，CPPUNIT还有很多宏，如
CPPUNIT_ASSERT(condition) // 确信condition为真
CPPUNIT_ASSERT_MESSAGE(message, condition) // 当condition为假时失败, 并打印message

CPPUNIT_FAIL(message) // 当前测试失败, 并打印message

CPPUNIT_ASSERT_EQUAL(expected, actual) // 确信两者相等
CPPUNIT_ASSERT_EQUAL_MESSAGE(message, expected, actual) // 失败的同时打印message

CPPUNIT_ASSERT_DOUBLES_EQUAL(expected, actual, delta) // 当expected和actual之间差大于delta时失败

4 简单示例

1） 打开vs2005，新建一个MFC 对话框项目名为CppUnit

2) 设置项目属性

项目-->属性-- 》C/C++ 》常规 下 的 附加包含目录中添加Include : $(CPPUNITDIR)\Include

项目-->属性-- 》连接器 》常规 下 的 附加库目录中添加lib: $(CPPUNITDIR)\lib

3） 打开CppUnit.cpp文件，增加包含文件和声明使用库代码

[cpp]
view plaincopyprint?

#include <cppunit/ui/mfc/TestRunner.h>

#include <cppunit/extensions/TestFactoryRegistry.h>

#pragma comment(lib, "cppunitd.lib")

#pragma comment(lib, "testrunnerud.lib")

注：如果为Release版本声明使用库文件为

[cpp]
view plaincopyprint?

#pragma comment(lib, "cppunit.lib")

#pragma comment(lib, "testrunner.lib")

4）修改InitInstance()函数

注释掉了对话框

增加了CPPUNIT_NS 测试

[cpp]
view plaincopyprint?

BOOL CCppUnitApp::InitInstance()
{
// 如果一个运行在 Windows XP 上的应用程序清单指定要
// 使用 ComCtl32.dll 版本 6 或更高版本来启用可视化方式，
//则需要 InitCommonControlsEx()。否则，将无法创建窗口。
INITCOMMONCONTROLSEX InitCtrls;
InitCtrls.dwSize = sizeof(InitCtrls);
// 将它设置为包括所有要在应用程序中使用的
// 公共控件类。
InitCtrls.dwICC = ICC_WIN95_CLASSES;
InitCommonControlsEx(&InitCtrls);

CWinApp::InitInstance();

AfxEnableControlContainer();

// 标准初始化
// 如果未使用这些功能并希望减小
// 最终可执行文件的大小，则应移除下列
// 不需要的特定初始化例程
// 更改用于存储设置的注册表项
// TODO: 应适当修改该字符串，
// 例如修改为公司或组织名
SetRegistryKey(_T("应用程序向导生成的本地应用程序"));

// 注释掉了这一段
// CCppUnitDlg dlg;
// m_pMainWnd = &dlg;
// INT_PTR nResponse = dlg.DoModal();
// if (nResponse == IDOK)
// {
// // TODO: 在此处放置处理何时用“确定”来关闭
// // 对话框的代码
// }
// else if (nResponse == IDCANCEL)
// {
// // TODO: 在此放置处理何时用“取消”来关闭
// // 对话框的代码
// }

// 由于对话框已关闭，所以将返回 FALSE 以便退出应用程序，
// 而不是启动应用程序的消息泵。

//增加如下代码

CPPUNIT_NS::MfcUi::TestRunner runner;
runner.addTest( CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest() );
runner.run();

return FALSE;
}

编译运行出现如下图界面，此时未加任何用例的单元测试例子界面就出来了：



5）添加测试代码

a) 添加一个c++类example,其基类是public
CPPUNIT_NS::TestFixture

b)
修改example.h

[cpp]
view plaincopyprint?

#pragma once

#include <cppunit/extensions/HelperMacros.h>

#include <cppunit/TestFixture.h>

class example :public CPPUNIT_NS::TestFixture

{

CPPUNIT_TEST_SUITE(example);

CPPUNIT_TEST_SUITE_END();

public:

example(void);

~example(void);

};

c) 修改example.c

[cpp]
view plaincopyprint?

#include "StdAfx.h"
#include "example.h"

CPPUNIT_TEST_SUITE_REGISTRATION(example);

example::example(void)
{
}

example::~example(void)
{
}

d) 此时编译，可发现出现了测试包：



e) 添加测试包初始化、结束函数setUp,tearDown（注意大小写）。以及添加测试用例testcase1,testcase2

example.h

[cpp]
view plaincopyprint?

#pragma once

#include <cppunit/extensions/HelperMacros.h>

#include <cppunit/TestFixture.h>

class example :public CPPUNIT_NS::TestFixture

{

CPPUNIT_TEST_SUITE(example);

CPPUNIT_TEST(testcase1);
CPPUNIT_TEST(testcase2);

CPPUNIT_TEST_SUITE_END();

public:

example(void);

~example(void);

public:
void setUp();
void tearDown();
void testcase1();
void testcase2();

};

example.cpp

[cpp]
view plaincopyprint?

#include "StdAfx.h"
#include "example.h"

CPPUNIT_TEST_SUITE_REGISTRATION(example);

example::example(void)
{
}

example::~example(void)
{
}

void example::testcase1()
{
AfxMessageBox((LPCTSTR)_T("I am testcase1"),MB_OK,0);

}

void example::testcase2()
{
AfxMessageBox((LPCTSTR)_T("I am testcase2"),MB_OK,0);
}

void example::setUp()
{
AfxMessageBox((LPCTSTR)_T("I am setup"),MB_OK,0);
}

void example::tearDown()
{
AfxMessageBox((LPCTSTR)_T("I am teardown"),MB_OK,0);
}

说明，每一个用例，都会调用setUp和tearDown 这是CPPUNIT内部默认的

f) 添加其他用例

[cpp]
view plaincopyprint?

#pragma once

#include <cppunit/extensions/HelperMacros.h>

#include <cppunit/TestFixture.h>

class example :public CPPUNIT_NS::TestFixture

{

CPPUNIT_TEST_SUITE(example);

CPPUNIT_TEST(testcase1);
CPPUNIT_TEST(testcase2);
CPPUNIT_TEST(testcase3);
CPPUNIT_TEST(testcase4);

CPPUNIT_TEST_SUITE_END();

public:

example(void);

~example(void);

public:
void setUp();
void tearDown();
void testcase1();
void testcase2();
void testcase3();
void testcase4();

};

[cpp]
view plaincopyprint?

#include "StdAfx.h"
#include "example.h"

CPPUNIT_TEST_SUITE_REGISTRATION(example);

example::example(void)
{
}

example::~example(void)
{
}

void example::testcase1()
{
AfxMessageBox((LPCTSTR)_T("I am testcase1"),MB_OK,0);

}

void example::testcase2()
{
AfxMessageBox((LPCTSTR)_T("I am testcase2"),MB_OK,0);
}

void example::testcase3()
{
CPPUNIT_ASSERT(1==1);
}

void example::testcase4()
{
CPPUNIT_ASSERT(1==2);
}

void example::setUp()
{
AfxMessageBox((LPCTSTR)_T("I am setup"),MB_OK,0);
}

void example::tearDown()
{
AfxMessageBox((LPCTSTR)_T("I am teardown"),MB_OK,0);
}

g) 单元测试结果

假如测试中所有断言都通过，则结果为绿色。

假如由一个断言失败，则显示红色，下面显示出错位置，且双击可以找到源代码位置。



5 测试另一个项目中的代码

新建一对话框项目DlgTest，检测对话框项目的函数CDlgTestDlg::Add。

1） 将CPPUNIT 测试项目 和被测试项目 放在同一目录下， 并在同一个解决方案中打开

2） 设置测试环境，将被测项目的路径添加到附加包含路径中

比如，被测项目DlgTest的路径为： E:\TEST\DlgTest\DlgTest

则在CPPUNIT项目属性--》C/C++-》常规 附加包含路径中添加 E:\TEST\DlgTest\DlgTest

因为之前添加了CPPUNIT的Include路径

所以，添加被测路径之后的值为： "$(CPPUNITDIR)\Include";E:\TEST\DlgTest\DlgTest

3） 使用 添加--》现有项功能 将被测的DlgTestDlg.h 和DlgTestDlg.cpp添加到CPPUnit中

4） 修改CPPUNIT单元测试项目中的测试单元example

修改example.h

添加被测函数的头文件

[cpp]
view plaincopyprint?

#include "DlgTestDlg.h"

修改example.cpp

在此，测试对话框CDlgTestDlg中的Add函数

[cpp]
view plaincopyprint?

void example::testcase1()
{
// AfxMessageBox((LPCTSTR)_T("I am testcase1"),MB_OK,0);

CDlgTestDlg dlg;

int i=dlg.Add(3,5);
CPPUNIT_ASSERT(i==9);

}

5） 编译运行 查看测试结果

CPPUNIT测试项目模板 保存在资源 http://download.csdn.net/detail/shuilan0066/4396670 ， 可以下载后，将其放置到被测项目的等同目录下，修改参数，进行测试