一个 H5、小程序自动化测试框架
随着产品业务形态逐渐从 App 延升到微信小程序、微信公众号以及 QQ公众号等,而之前的自动化建设主要是 Native App 为主,全手工测试已无法满足快速增长的业务需求。为提升测试效率和质量,FAutoTest 框架致力于解决 QQ、微信内 UI 的自动化问题(包括微信内 H5页面和小程序、QQ 内 H5页面),提升自动化测试的效率和稳定性。
FAutoTest 是一款成长中的框架,吸收借鉴了一些 UI 自动化工具的优秀设计理念和思想。如果框架有不足地方,或者你有更好的建议,欢迎提交 Issues 参与贡献。
FAutoTest 专业服务于微信 H5/小程序的UI自动化测试,提升测试效率与质量。
整体采用分层设计,API设计方式参考 WebDriver
整体框架是一个同步阻塞的模型:在一个线程中循环的执行 receive 方法,等待收到 response,发送消息后,阻塞,只有当 receive 方法获得消息时,才会解除阻塞,发送下一条消息,具备超时异常处理机制
框架内打包了 Python 版本的 UIAutomator,方便在安卓 Native 页面进行操作
User Interface(用户交互层): 提供给用户所有的界面操作 API(H5界面及小程序界面),使用者不需要关注框架内部实现,只需要关注自身业务逻辑流程(手工用例流程转换成自动化流程)
PageOperator(操作解析层): 主要用于接收和解析用户命令后传递给下层 Engine 层
Engine( H5&小程序引擎层): 将用户命令传输到手机,并返回结果信息。封装 WebSocket 和单线程池,通过WebSocket Debug URL 和浏览器内核建立链接,发送 Json 格式的协议到手机端进行用户指定的操作。
H5页面/小程序 UI 自动化执行流程
自动化脚本调用流程
软件 | 软件要求 |
---|---|
Python 版本 | 2.7.x 版本 |
Java JDK 版本 | Java 语言框架(最低1.7) |
Android SDK 版本 | 4.4 及以上版本 |
adb 版本 | 最新版本即可 |
Python IDE 开发环境 | 如 PyCharm CE等 |
下载 & 安装 Python,安装后在终端输入命令 python -v
和 pip list
,能够执行,说明 Python 环境配置成功。
下载 & 安装 Java JDK 安装后在终端输入命令java -version
,java
, javac
命令能够执行,则 Java 环境配置成功。
下载 & 安装 Android Studio,然后在里面安装 Android SDK
安装 Android Studio 后,配置 SDK 环境(若自动安装不成功,可到手动下载安装 ,安装后在终端输入命令 adb version
执行有结果,则说明配置成功
下载 & 安装 Pycharm CE
库名称 | 版本 | 下载地址 |
---|---|---|
uiautomator | 0.3.2 | https://pypi.org/project/uiautomator/#files |
lxml | 4.2.3 | https://pypi.org/project/lxml/4.2.3/#files |
bidict | 0.17.0 | https://pypi.org/project/bidict/#files |
websocket-client | 0.44.0 | https://pypi.org/project/websocket-client/#files |
使用pip
安装框架所需的第三方库 uiautomator
、websocket-client
、lxml
、bidict
、ADBkeyBoard
,如安装lxml
、bidict
、websocket-client
可用pip
形式安装,如安装lxml
,
pip install lxml
安装自身框架
pip intsall dist/fastAutoTest-xxx.whl
打开微信Debug模式,安装 TBS 内核
如何写测试案例,如微信 H5页面,如下所示:
# coding=utf-8
from fastAutoTest.core.h5.h5Engine import H5Driver
# http://h5.baike.qq.com/mobile/enter.html 从微信进入此链接,首屏加载完后执行脚本
if __name__ == '__main__':
h5Driver = H5Driver()
h5Driver.initDriver()
h5Driver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')
h5Driver.clickFirstElementByText('白内障')
h5Driver.returnLastPage()
h5Driver.returnLastPage()
print(h5Driver.getElementTextByXpath('/html/body/div[1]/div/div[3]/p'))
h5Driver.close()
xpath
,可通过 chrome:inspect
找到当前页面,找到控件的xpath
QQ 的 H5页面:
# coding=utf-8
from fastAutoTest.core.qq.qqEngine import QQDriver
# 从动态 -> 动漫进入
if __name__ == '__main__':
qqDriver = QQDriver()
qqDriver.initDriver()
qqDriver.clickFirstElementByText('英雄救美,这也太浪漫了')
qqDriver.returnLastPage()
qqDriver.clickElementByXpath('//*[@id="app"]/div/ul/li[2]')
qqDriver.returnLastPage()
qqDriver.close()
xpath
,可通过 chrome:inspect
找到当前页面,找到控件的xpath
微信小程序:
# coding=utf-8
from fastAutoTest.core.wx.wxEngine import WxDriver
import os
# 进入企鹅医典小程序
if __name__ == '__main__':
wxDriver = WxDriver()
wxDriver.initDriver()
# 点击全部疾病
wxDriver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')
wxDriver.clickFirstElementByText('白内障')
wxDriver.returnLastPage()
wxDriver.returnLastPage()
# 截图
dirPath = os.path.split(os.path.realpath(__file__))[0]
PIC_SRC = os.path.join(dirPath, 'pic.png')
wxDriver.d.screenshot(PIC_SRC)
wxDriver.close()
xpath
,同上操作所有代码采用 BSD-3-Clause License 开源
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型