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 , 可以下载后,将其放置到被测项目的等同目录下,修改参数,进行测试