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。