QtTestLib框架提供了一个简单易用的单元测试框架,首先我们通过Qt Creator自动创建一个测试框架。
类名:MyTest,槽函数testQString,类型选择“性能测试”(会自动添加宏QBENCHMARK),同时勾选“使用测试数据库”,“需要QApplication”,
- 使用测试数据集:会自动添加测试数据集槽函数,即testQString_data
- 需要QApplication:勾选的话,自动调用宏QTEST_MAIN;不勾选的话,自动调用宏 QTEST_APPLESS_MAIN;两者都是实现mian()
函数,但是后者不会实例化QApplication对象;
- 生成初始化和清理代码:如果勾选的话,会自动添加initTestCase()
和cleanupTestCase()
函数;
之后默认选择,这样Qt Creator就为我们自动生成了一个测试模板。我们可以看到测试模板定义了一个继承于QObject的测试类MyTest,包括void testQString_data()
和void testQString()
两个槽函数,宏QTEST_MAIN,以及#include "tst_mytest.moc"
(这是因为我们的类申明和实现都在同一个.cpp文件中,所以必须包含.moc文件)。另外我们打开项目中.pro文件,可以发现已经添加了QT += testlib
。
下面我们来添加需要测试的内容。
1.在测试数据集中添加需要测试的数据
void MyTest::testQString_data()
{
QTest::addColumn("string") ;
QTest::addColumn("result") ;
QTest::newRow("lower") << "hello"<<"HELLO";
QTest::newRow("mix")<<"HellO"<<"HELLO";
QTest::newRow("upper")<<"HELLO"<<"HELLO";
}
我们通过addColumn()
函数定义两个为QString类型的元素列,分别取名为string和result。另外通过newRow()
函数添加了三条测试数据集,分别取名为lower、mix和upper。由此,我们可以得到一张测试数据表:
序号 | 名称 | string(QString) | result(QString类) |
---|---|---|---|
0 | lower | “hello” | “HELLO” |
1 | mix | “HellO” | “HELLO” |
2 | Upper | “HELLO” | “HELLO” |
2.在测试槽函数中添加需要测试的函数
void MyTest::testQString()
{
QFETCH(QString, string);
QFETCH(QString, result);
QCOMPARE(string.toUpper(), result);
QBENCHMARK {
string.toUpper();
}
}
我们通过宏QFETCH获取测试数据表中的测试数据,其第一个参数为元素列的类型,第二个参数为元素列名称(与数据表中定义一致),并通过宏QCOMPARE来比较函数执行返回的值与期望的值是否一致。另外通过宏QBENCHMARK来测试函数的性能,该宏会多次调用函数去做较为精确的测量。
构建并运行程序,我们可以得到如下输出:
********* Start testing of MyTest *********
Config: Using QtTest library 5.9.1, Qt 5.9.1 (i386-little_endian-ilp32 shared (dynamic) debug build; by MSVC 2015)
PASS : MyTest::initTestCase()
PASS : MyTest::testQString(lower)
RESULT : MyTest::testQString():"lower": 0.0015 msecs per iteration (total: 51, iterations: 32768)
PASS : MyTest::testQString(mix)
RESULT : MyTest::testQString():"mix": 0.0013 msecs per iteration (total: 88, iterations: 65536)
PASS : MyTest::testQString(upper)
RESULT : MyTest::testQString():"upper": 0.00027 msecs per iteration (total: 72, iterations: 262144)
PASS : MyTest::cleanupTestCase()
Totals: 5 passed, 0 failed, 0 skipped, 0 blacklisted, 936ms
********* Finished testing of MyTest *********
首先我们在测试类MyTest中添加两个槽函数testGui_data()
和testGui()
来测试QLineEdit中事件响应。
1.添加测试数据集
void MyTest::testGui_data()
{
QTest::addColumn<QTestEventList>("event");
QTest::addColumn<QString>("result");
QTestEventList list1;
list1.addKeyClicks("hello world");
QTest::newRow("item 0 ")<<list1<<QString("hello world");
QTestEventList list2;
list2.addKeyClicks("abs0");
list2.addKeyClick(Qt::Key_Backspace);
QTest::newRow("item 1")<<list2<<QString("abs");
}
同样,我们通过addColumn()函数分别定义了一个名为event的QTestEventList类型和一个名为result的QStirng类型,并通过newRow()函数添加了两条测试数据集。
2.事件测试实现
void MyTest::testGui()
{
QFETCH(QTestEventList, event);
QFETCH(QString, result);
QLineEdit lineEdit;
event.simulate(&lineEdit);
QCOMPARE(lineEdit.text(), result);
}
通过QTestEventList::simulate()
来模拟列表中的事件,同样用宏QFETCH来加载测试数据,用宏QCOMPARE来进行比较。
构建并运行程序,可以在测试输出信息中发现:
PASS : MyTest::testGui(item 0 )
PASS : MyTest::testGui(item 1)
在测试过程中,我们需要输出哪些信息,是否输出到文件,测试选项,性能测试选项等的配置,都可以通过Qt Test命令行参数进行配置,具体的语法如下:
testname [options] [testfunctions[:testdata]]...
所有选项参数说明可以官网http://doc.qt.io/qt-5/qtest-overview.html,下面是两个常用的选项:
-o filename.format(格式包括:txt, xml, csv…… ):将测试信息输出到指定格式的指定文件;
-silent:仅输出错误信息;
Qt Creator中配置命令行参数选项的方法:“项目”->“Run”->“Command line arguments”中配置相关选项。
文中示例程序可参照:MyTest