QTestlib Manual

QTestlib ManualTrolltech公司提供的QTestlib框架，是一种针对基于QT编写的程序或库的单元测试工具。

QTestLib提供了单元测试框架的基本功能，并提供了针对GUI测试的扩展功能。

目录：∙QtestLib特性∙QTestLib API∙使用 QTestLibo编写一个测试程序o编译一个测试程序o QTestLib 命令行参数▪语法▪选项∙在Windows CE上远程使用QTestLibo使用cetest▪语法▪选项o QtRemoteo约束条件QTestlib特性设计QTestLib的目标是为了简化QT程序或库的单元测试工作。

注意：对于高级的GUI和应用程序测试需求，请参考Trolltech合作伙伴提供的测试产品。

（译者注：如FROGLOGIC提供的Squish工具）QTestLib API所有公有的方法都在QTest命名空间中。

另外，QSignalSpy类为QT的信号和槽提供了简单的内省机制。

使用QTestLib编写一个测试程序编写一个测试程序，需要从QObject类派生一个子类并加入一个或者多个私有槽。

每一个私有槽都是一个测试函数。

QTest::qExec()函数用于执行测试对象中所有的测试函数。

另外，有4种私有槽不能作为测试函数。

他们由测试框架执行，可为整个测试程序或当前测试函数进行初始化和清除操作。

∙initTestCase()会在第一个测试函数执行前调用。

1∙cleanupTestCase()会在最后一个测试函数执行后调用。

∙init()会在每一个测试函数执行前调用。

∙cleanup()会在每一个测试函数执行后调用。

如果initTestCase()函数执行失败，任何测试函数都不会执行。

如果init()函数执行失败，紧随其后的测试函数不会被执行，测试会继续处理下一个测试函数。

例子：c l a s s M y F i r s t T e s t:p u b l i c Q O b j e c t{Q_O B J E C Tp r i v a t e s l o t s:v o i d i n i t T e s t C a s e(){q D e b u g("c a l l e d b e f o r e e v e r y t h i n g e l s e");}v o i d m y F i r s t T e s t(){Q V E R I F Y(1==1);}v o i d m y S e c o n d T e s t(){Q V E R I F Y(1!=2);}v o i d c l e a n u p T e s t C a s e(){q D e b u g("c a l l e d a f t e r m y F i r s t T e s t a n d m y S e c o n d T e s t");}};更多测试例子，请参阅QTestLib Tutorial。

编译一个测试程序如果使用qmake作为编译工具，只需在project文件中增加移行：Q T+=t e s t l i b（注意，此处有错，应为CONFIG += qtestlib）如果使用其它的编译工具，确保把QTestLib的头文件加入到include路径（通常是Qt 安装路径下的include/QtTest目录）。

如果你要创建Qt程序的发行版本，将测试程序链接到QtTest库。

如果你要创建Qt程序的调试版本，使用QtTest_debug。

参阅：QTestLib Tutorial。

QTestlib命令行参数语法执行自动测试的语法接收下列简单形式：t e s t n a m e[o p t i o n s][t e s t f u n c t i o n s[:t e s t d a t a]]...用你的可执行文件替换testname。

testfunctions包含要执行的测试函数名，如果不指定testfunctions，所有的测试函数都会执行。

如果测试函数名之后加上了测试数据行的名字，则测试函数执行时只会使用该行测试数据。

列如：/m y T e s t D i r e c t o r y$t e s t Q S t r i n g t o U p p e r使用所有的测试数据执行toUpper测试函数。

/m y T e s t D i r e c t o r y$t e s t Q S t r i n g t o U p p e r t o I n t:z e r o使用所有的测试数据执行toUpper测试函数，使用行名为zero的测试数据执行toInt 测试函数（如果对应的测试数据不存在，相关的测试执行时就会失败）。

/m y T e s t D i r e c t o r y$t e s t M y W i d g e t-v s-e v e n t d e l a y500执行testMyWidget测试程序，输出每一个信号发射信息，在每次模拟鼠标/键盘事件之后等待500毫秒。

选项下列命令行参数可以被接受：∙-help输出命令行参数的帮助信息。

∙-functions输出测试中的所有测试函数。

∙-o filename将输出信息写入到执行文件中，而不是打印到标准输出上。

∙-silent沉默地输出，只显示警告、错误和最少的状态信息。

∙-v1详细输出；输出每次进入或离开测试函数的信息。

∙-v2详细输出；也输出每个QCOMPARE()和QVERIFY()信息。

∙-vs输出发出的所有信号。

∙-xml将输出格式化成XML格式，而不是普通文本∙-lightxml输出成XML标签流。

∙-eventdelay ms如果键盘或鼠标模拟(QTest::keyClick()，QTest::mouseClick()等)不指定延迟时间，则使用该参数（以毫秒为单位）作为延迟时间。

∙-keydelay ms与-eventdelay的作用一样，但只影响键盘模拟的延迟时间，不影响鼠标模拟的延迟时间。

∙-mousedelay ms与-eventdelay的作用一样，但只影响鼠标模拟的延迟时间，不影响键盘模拟的延迟时间。

∙-keyevent-verbose详细输出键盘模拟信息。

∙-maxwarnings numberBR设置警告信息的最大数量，0表示不限制，默认值为2000。

在Windows CE上远程使用QTestLibcetest能够帮助用户方便地在Windows CE设备或模拟器上加载应用程序，并且它需要在单元测试被成功编译后才能执行。

加载前，下列文件将拷贝到设备上：∙该工程链接的所有Qt库∙QtRemote.dll∙安装时指定的c运行库∙.pro文件中DEPLOYMENT规则指定的所有文件使用cetest语法执行自动测试的语法接受下列简单形式：c e t e s t[o p t i o n s]...选项cetest不仅提供了与非交叉编译平台相同的选项，参考Command Line Arguments，而且增加了下列选项：∙-debug在调试模式下编译测试程序。

∙-release在发行模式下编译测试程序。

∙-libpath path指明拷贝Qt库的目标路径。

∙-qt-delete执行结束后删除Qt库。

∙-project-delete执行结束后删除工程文件。

∙-delete执行结束后删除工程文件和Qt库。

∙-conf指定一个将被部署到远程路径中的qt.conf文件注意：debug是默认的编译选项。

QtRemoteQtRemote是在QTestLib之后编译的一个小的库。

它允许主机系统创建一个在远程设备上运行的进程，并等待其执行结束。

约束条件cetest使用Microsoft ActiveSync建立主机和设备之间的远程连接，顺利编译cetest 和QtRemote需要与之相关的头文件和库。

在安装Qt之前，需要正确设置INCLUDE和LIB环境变量。

Pocket PC上Windows Mobile 5的默认安装可通过下述方式得到：s e t I N C L U D E=C:\P r o g r a m F i l e s\W i n d o w s C E T o o l s\w c e500\W i n d o w s M o b i l e5.0P o c k e t P C S D K\A c t i v e s y n c\I n c;%I N C L U D E%s e t L I B=C:\P r o g r a m F i l e s\W i n d o w s C E T o o l s\w c e500\W i n d o w s M o b i l e5.0P o c k e t P C S D K\A c t i v e s y n c\L i b;%L I B%注意Qt会记住该路径，因此即使切换到交叉编译环境，你也不需要重新设置它。