快速入门¶
测试项目¶
测试用例归属于一个测试项目，在设计测试用例之前，如果没有测试项目，请先参考《Testbase创建和修改测试项目》。
开发工具¶
你可以选择你习惯的开发环境，如Eclipse、命令行执行、PyCharm、VS Code等，推荐使用VS Code开发环境。
第一个测试用例¶
我们先看一个简单的UI自动化的用例:
import subprocess
import qt4c.wincontrols as wincontrols
from qt4c.testcase import ClientTestCase
from qt4c.qpath import QPath
class QT4CHelloTest(ClientTestCase):
'''QT4C示例测试用例
'''
owner = "qta"
timeout = 1
priority = ClientTestCase.EnumPriority.Normal
status = ClientTestCase.EnumStatus.Ready
def pre_test(self):
#-----------------------------
self.startStep("关闭当前的所有计算器窗口")
#-----------------------------
from qt4c.util import Process
for i in Process.GetProcessesByName('calc.exe'):
i.terminate()
def run_test(self):
#-----------------------------
self.startStep("打开计算器")
#-----------------------------
subprocess.Popen('calc.exe')
cw = wincontrols.Window(locator=QPath("/ClassName='CalcFrame' && Text='计算器' && Visible='True'"))
btn1 = wincontrols.Control(root=cw, locator=QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'"))
result = wincontrols.Control(root=cw, locator=QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'"))
btn1.click()
self.assert_equal("检查按键结果", result.Text, '1')
这个测试用例的逻辑很简单：
- 为排除干扰，关闭当前的所有计算器窗口
- 打开一个计算器窗口
- 按下“1”，检查输出结果是否为1
我们先看主要代码的实现run_test，在第一步通过subprocess.Popen启动一个计算器进程后，我们实例化一个窗口对象:
cw = wincontrols.Window(locator=QPath("/ClassName='CalcFrame' && Text='计算器' && Visible='True'"))
可以看到这里使用一个“qt4c.qpath.QPath”实例来作为locator的参数，这个locator其实是用于唯一定位我们打开的计算器主窗口。
在构造主窗口对象后，我们构造了两个控件实例对象:
btn1 = wincontrols.Control(
root=cw,
locator=QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'"))
result = wincontrols.Control(
root=cw,
locator=QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'"))
第一个控件表示的是我们打开的计算器的按键“1”，第二个控件表示的是计算器的显示屏，可以看到这里使用两个参数:
- root：表示这个控件所属的窗口容器
- locator：用于在窗口内唯一定位一个控件
可以看到location示例是属于我们的cw窗口，所以其root为cw。
在构造btn1和result对象后，我们点击按键“1”:
btn1.click()
我们便可以通过result控件的Text属性来检查:
self.assert_equal("检查按键结果", result.Text, '1')
定位控件¶
上面的例子中，我们使用了一个叫QPath的locator来定位控件。QPath是怎么唯一定位一个控件的呢？
对于Windows平台，其实对于其他的平台也是一样，UI元素是以树结构组织的。像Windows操作系统的文件系统，也是以树结构的形式来管理的，我们使用的文件路径比如:
C:\Python27\Lib\ctypes
以上的路径就是通过间隔符号“”来分层定位一个文件。所以，可以理解QPath其实就是一个UI元素的路径定位技术，比如我们实例化计算器窗口的QPath:
/ClassName='CalcFrame' && Text='计算器' && Visible='True'
表示的就是从根开始（对于Windows来说，桌面窗口就是所有窗口的根），搜索其直接子窗口中符合对应ClassName，Text和Visible属性的窗口。
而我们构造location控件对象时，由于指定了root参数，则是以计算器窗口为根节点开始，搜素符合条件的控件元素。
从这里可以看出，QT4C使用两步定位的方式来定位一个控件，先找到这个控件所属的窗口，然后在这个窗口中搜索这个控件。
严格来说，Windows操作系统只有窗口的概念，并没有区分控件和窗口这两个概念，而在QT4C中， qt4c.wincontrols.Window 的意义是指控件的容器，而 qt4c.wincontrols.Control 则表示一个不可以分隔的UI元素。
因此QT4C中是使用 qt4c.wincontrols.Window 还是 qt4c.wincontrols.Control ，关键看使用者怎么理解这个UI元素的作用。
更多的控件定位的详细内容，请参考《QPath语法和使用》
理解UI结构¶
上面的QT4CHelloTest用例存在两个问题：
- 可读性差，只能依赖构造的实例的名字来猜测控件对应的用途
- 维护成本高，我们在测试用例中硬编码QPath的路径，如果被测对象的UI结构调整，则需要修改每一个测试用例；而且可以看到在一个用例中，我们也多次引用了同一个QPath。
为解决这两个问题，我们的测试用例可以这样修改:
# -*- coding: utf-8 -*-
from qt4c.qpath import QPath
from qt4c import wincontrols
from qt4c.testcase import ClientTestCase
import subprocess
class CalcWindow(wincontrols.Window):
qp = QPath("/ClassName='CalcFrame' && Text='计算器' && Visible='True'")
def __init__(self):
super(CalcWindow, self).__init__(locator=self.qp)
locators = {
'按键1': {'type': wincontrols.Control, 'root': self, 'locator': QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'")},
'结果': {'type': wincontrols.Control, 'root': self, 'locator': QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'")}
}
self.updateLocator(locators)
@staticmethod
def closeAll():
from qt4c.util import Process
for i in Process.GetProcessesByName('calc.exe'):
i.terminate()
class QT4CHelloTest(ClientTestCase):
'''QT4C示例测试用例
'''
owner = "qta"
status = ClientTestCase.EnumStatus.Ready
timeout = 1
priority = ClientTestCase.EnumPriority.Normal
def pre_test(self):
#-----------------------------
self.startStep("关闭当前的所有计算器窗口")
#-----------------------------
CalcWindow.closeAll()
def run_test(self):
#-----------------------------
self.startStep("打开计算器")
#-----------------------------
subprocess.Popen('calc.exe')
cw = CalcWindow()
cw.Controls['按键1'].click()
self.assert_equal("检查按键结果", cw.Controls['结果'].Text, '1')
可以看到我们封装了一个CalcWindow类，表示这个计算器的窗口。
先看看run_test用例，和之前有较大的变化，实例化窗口对象不需要提供locator参数:
cw = CalcWindow()
检查其子控件的属性也变得简单易懂:
cw.Controls['结果'].Text
当然这得益于对CalcWindow的封装。CalcWindow本身是“qt4c.wincontrols.Window”的子类，表示这个是一个窗口，在其调用基类构造函数的时候传递了locator参数，因此使用的时候变得简单，无需任何参数。
ExplorerFolder还在构造函数中调用了updateLocator方法，传入一个字典:
{
'按键1': {
'type': wincontrols.Control,
'root': self,
'locator': QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'")
},
'结果': {
'type': wincontrols.Control,
'root': self,
'locator': QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'")
}
}
这个字典其实就是这个窗口的子控件的布局的描述，每个子控件的描述由四个部分组成：
- 名称：用字符串表示这个子控件的名字，窗口对象可以通过这个名字来引用使用对应的子控件，就像我们在测试用例中使用“’文件地址显示框’”一样。
- type：表示子控件的类型，下面我们会介绍
- root：表示子控件定位时使用的跟节点，一般都是用self，也就是当前的窗口对象
- locator：表示子控件定位时使用的路径，一般是QPath或其他类似的控件定位符号
通过CalcWindow类，可以更清晰得看到QT4C两层UI结构的意义所在。
实际上，除了Window和Control，QT4C还提供了第三层的UI结构，即是“qt4c.app.App”。比如上面的用例，我们可以增加一个ExplorerApp类并对应修改ExplorerFolder类:
class CalcWindow(wincontrols.Window):
qp_str = "/ClassName='CalcFrame' && Text='计算器' && Visible='True'"
def __init__(self, app):
super(CalcWindow, self).__init__(locator=QPath(self.qp_str + " && ProcessId='%s'" % app.ProcessId))
locators = {
'按键1': {'type': wincontrols.Control, 'root': self, 'locator': QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'")},
'结果': {'type': wincontrols.Control, 'root': self, 'locator': QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'")}
}
self.updateLocator(locators)
class CalcApp(App):
'''计算器应用
'''
def __init__(self):
'''构造函数
'''
p = subprocess.Popen('calc.exe')
self._pid = p.pid
@property
def ProcessId(self):
'''对应calc.exe进程的进程ID
'''
return self._pid
def quit(self):
CalcWindow(self).close()
def kill(self):
CalcWindow(self).close()
@staticmethod
def killAll():
from qt4c.util import Process
for i in Process.GetProcessesByName('calc.exe'):
i.terminate()
对应的，测试用例可以修改为:
class QT4CHelloTest(ClientTestCase):
'''QT4C示例测试用例
'''
owner = "qta"
status = ClientTestCase.EnumStatus.Ready
timeout = 1
priority = ClientTestCase.EnumPriority.Normal
def run_test(self):
#-----------------------------
self.startStep("打开计算器")
#-----------------------------
calc = CalcApp()
cw = CalcWindow(calc)
cw.Controls['按键1'].click()
self.assert_equal("检查按键结果", cw.Controls['结果'].Text, '1')
这个用例和之前的用例有比较大的区别就是少了pre_test，原因是CalcApp类已经实现了对多个计算器的管理的功能，所以可以不用在测试之前通过将全部窗口都关闭的方式来避免发生干扰。 QT4C的App的作用，在UI的层面上，就是用于管理多个重复窗口的情况；在操作系统的层面上讲，App可以理解为提供一个特定功能的软件，一般来说可能是对应操作系统的一个进程、一个线程、或者多个进程集合。
更多的UI结构和封装的详细内容，请参考《UI结构和封装》。
控件类型和属性¶
在指定UI布局的时候，我们可以选择对应的控件的类型，在上面的例子里面:
{
'按键1': {
'type': wincontrols.Control,
'root': self,
'locator': QPath("/ClassName='Button' && MaxDepth='3' && ControlId='0x83'")
},
'结果': {
'type': wincontrols.Control,
'root': self,
'locator': QPath("/ClassName='Static' && MaxDepth='3' && ControlId='0x96'")
}
}
type使用的是“qt4c.wincontrols.Control”类型，我们需要如何选择控件的类型？有哪些控件的类型呢？
同时，在检查控件的属性的时候，我们使用Text属性:
cw.Controls['结果'].Text
但是我们需要如何知道使用哪个属性？
QT4C目前支持三种类型的控件，分别是：
- Native控件，仅支持Windows操作系统提供的窗口控件，能力有限，维护和接入成本低，接口请参考《qt4c package》
- UIA控件，基于UI Automation能力，可以支持各类UI控件，能力较强，接入和维护成本低，接口请参考《qt4c package》
- Web控件，基于QT4W提供的内嵌Web页面的控件识别能力
Web控件和其他的控件的使用略有不同，我们会在《Web自动化测试支持》中讨论。
Native, UIA是控件的实现方式的差异导致，在同种实现方式下，也会有很多不同的控件类型，比如对于Native控件，我们前面使用到的“qt4c.wincontrols.Control”表示的就是普通的控件，但如果是可以列表控件，则可以使用“qt4c.wincontrols.ListView”。
使用哪种类型的控件，关键是看使用者要如何使用这个控件，QT4C不会也无法检查选择控件类型和对应的控件是否匹配。例如，对于一个ComboBox，可以对该控件的Value值进行设置，如果要实现这样的操作，则控件的类型必须指定为“qt4c.uiacontrols.ComboBox”:
{
'设置Value值': {
'type': uiacontrols.ComboBox,
'root': self,
'locator': QPath('/ControlId = "0x3E9" && MaxDepth="8"')
},
}
指定之后可以这样使用:
cw['设置Value值'].Value = 'value'