Qt单元测试--基本使用

框架生成

QtTestLib框架提供了一个简单易用的单元测试框架,首先我们通过Qt Creator自动创建一个测试框架。
Qt单元测试--基本使用_第1张图片

创建名为MyTest的项目
Qt单元测试--基本使用_第2张图片

选择QtGui和QtWidget(根据测试项目需要选定)
Qt单元测试--基本使用_第3张图片

类名:MyTest,槽函数testQString,类型选择“性能测试”(会自动添加宏QBENCHMARK),同时勾选“使用测试数据库”,“需要QApplication”,
Qt单元测试--基本使用_第4张图片
- 使用测试数据集:会自动添加测试数据集槽函数,即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”中配置相关选项。
Qt单元测试--基本使用_第5张图片

文中示例程序可参照:MyTest

你可能感兴趣的:(Qt)