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 通过以下宏来判断是否正确
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文件,增加包含文件和声明使用库代码
#include <cppunit/ui/mfc/TestRunner.h>
#include <cppunit/extensions/TestFactoryRegistry.h>
#pragma comment(lib, "cppunitd.lib")
#pragma comment(lib, "testrunnerud.lib")
注:如果为Release版本声明使用库文件为
#pragma comment(lib, "cppunit.lib")
#pragma comment(lib, "testrunner.lib")
4)修改InitInstance()函数
注释掉了对话框
增加了CPPUNIT_NS 测试
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
#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
#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
#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
#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) 添加其他用例
#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();
};
#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
添加被测函数的头文件
#include "DlgTestDlg.h"
修改example.cpp
在此,测试对话框CDlgTestDlg中的Add函数
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 , 可以下载后,将其放置到被测项目的等同目录下,修改参数,进行测试
参考资料:
http://blog.csdn.net/ainiyidiandian/article/details/5788240
http://morningspace.51.net/resource/cppunit/cppunit_anno.html
http://www.cppblog.com/ace/archive/2006/08/04/10842.html
http://blog.csdn.net/wincol/article/details/5789644
http://blog.csdn.net/alicehyxx/article/details/4483681
http://blog.csdn.net/jinjunmax_78/article/details/2033755