Qt单元测试--基本使用

框架生成

QtTestLib框架提供了一个简单易用的单元测试框架，首先我们通过Qt Creator自动创建一个测试框架。

创建名为MyTest的项目

选择QtGui和QtWidget（根据测试项目需要选定）

类名：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。

下面我们来添加需要测试的内容。

QString类中函数toUpper()的测试

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 *********

GUI 事件测试

首先我们在测试类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命令行参数

在测试过程中，我们需要输出哪些信息，是否输出到文件，测试选项，性能测试选项等的配置，都可以通过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