【QT】Qt单元测试浅析

Qt单元测试框架，使用于基于Qt的应用程序和库，先从一个简单的demo工程说起吧。

我们可以通过QtCreator来创建一个简单的Qt单元测试工程，夏天到了，这个demo工程的名字就叫Summer好了，创建过程中其它选项默认，完成后生成两个文件：Summer.pro和tst_summertest.cpp，先来看一下这两个文件。

Summer.pro——

QT       += testlib
QT       -= gui
TARGET = tst_summertest
CONFIG   += console
CONFIG   -= app_bundle
TEMPLATE = app
SOURCES += tst_summertest.cpp
DEFINES += SRCDIR=\\\"$$PWD/\\\"

Summer.pro文件中的QT+=testlib是必须的。

tst_summertest.cpp——

#include <QString>
#include <QtTest>

class SummerTest : public QObject
{
    Q_OBJECT

public:
    SummerTest();

private Q_SLOTS:
    void testCase1();
};

SummerTest::SummerTest()
{
}

void SummerTest::testCase1()
{
    QVERIFY2(true, "Failure");
}

QTEST_APPLESS_MAIN(SummerTest)

#include "tst_summertest.moc"

然后来编译运行（使用QtCreator）一下，结果如下：

********* Start testing of SummerTest *********
Config: Using QtTest library 5.3.1, Qt 5.3.1
PASS : SummerTest::initTestCase()
PASS : SummerTest::testCase1()
PASS : SummerTest::cleanupTestCase()
Totals: 3 passed, 0 failed, 0 skipped
********* Finished testing of SummerTest *********

在Summer工程中，C++代码里include了<QtTest>头文件，文件结尾处include了对应的.moc文件，测试类SummerTest要继承自QObject类或QObject的子类，需使用Q_OBJECT宏，测试方法testCase1()应标识为私有槽。

QTEST_APPLESS_MAIN(SummerTest)宏实际上是一个main()函数，其定义如下：

#define QTEST_APPLESS_MAIN(TestObject) \
int main(int argc, char *argv[]) \
{ \
    TestObject tc; \
    return QTest::qExec(&tc, argc, argv); \
}

看到了吧，非常简单，先是实例化一个SummerTest对象，然后调用QTest::qExec()，执行私有槽标识的所有测试方法，这里是testCase1()，QTest是个namespace，留心上面的SummerTest工程运行结果的话，会发现多了两个东东，initTestCase()和cleanupTestCase()，它们是测试框架自带的，即使不显式定义也会被调用，有点像C++的默认构造函数，前者在第一个测试方法执行前被调用，后者在最后一个测试方法执行后被调用，测试框架还提供了init()和cleanup()，它们分别在每一个测试方法执行的前后被调用，不显式定义时是不会执行的。除了QTEST_APPLESS_MAIN()外，测试框架还提供了两个类似的宏，QTEST_MAIN()和QTEST_GUILESS_MAIN()，用法相同。

Summer工程的编译运行也可以通过命令行来完成，有时候效果更好。

1、$qmake Summer.pro

使用qmake命令编译Summer.pro，生成MakeFile文件。

2、$make

使用make命令编译MakeFile，生成tst_summertest可执行文件，为什么可执行文件是tst_summertest而不是别的什么呢，这是因为在Summer.pro文件中指定了TARGET=tst_summertest，当然也可以设置成其它值。

3、$./tst_summertest

执行st_summertest，log输出到了终端，那么log可以输出到指定文件吗，答案是可以的，命令格式如下：

$./tst_summertest -o output_path

这时，log输出到了output_path指定的文件中，终端上不再显示log。