FAutoTest一个 H5、小程序自动化测试框架

简介

随着产品业务形态逐渐从 App 延升到微信小程序、微信公众号以及 QQ公众号等，而之前的自动化建设主要是 Native App 为主，全手工测试已无法满足快速增长的业务需求。为提升测试效率和质量，FAutoTest 框架致力于解决 QQ、微信内 UI 的自动化问题（包括微信内 H5页面和小程序、QQ 内 H5页面），提升自动化测试的效率和稳定性。

FAutoTest 是一款成长中的框架，吸收借鉴了一些 UI 自动化工具的优秀设计理念和思想。如果框架有不足地方，或者你有更好的建议，欢迎提交 Issues 参与贡献。

特性

FAutoTest 专业服务于微信 H5/小程序的UI自动化测试，提升测试效率与质量。

• 支持微信 H5页面，能识别常见 H5控件，能获取页面任意内容（常见的如文字、图片、链接等）
• 支持小程序内控件识别，操作，页面内容获取等
• 支持安卓 Native 页面组合操作使用
• 简单的 api 设计，较低的使用门槛
• 支持基础的性能测试监控
• 功能扩展性强，扩展门槛低

架构

1. 整体采用分层设计，API设计方式参考 WEBDriver

2. 整体框架是一个同步阻塞的模型：在一个线程中循环的执行 receive 方法，等待收到 response，发送消息后，阻塞，只有当 receive 方法获得消息时，才会解除阻塞，发送下一条消息，具备超时异常处理机制

3. 框架内打包了 python 版本的 UIAutomator，方便在安卓 Native 页面进行操作

User Interface(用户交互层)： 提供给用户所有的界面操作 API(H5界面及小程序界面)，使用者不需要关注框架内部实现，只需要关注自身业务逻辑流程（手工用例流程转换成自动化流程）

PageOperator(操作解析层)： 主要用于接收和解析用户命令后传递给下层 Engine 层

Engine( H5&小程序引擎层)： 将用户命令传输到手机，并返回结果信息。封装 websocket 和单线程池，通过WebSocket Debug URL 和浏览器内核建立链接，发送 JSON 格式的协议到手机端进行用户指定的操作。

业务流程

• H5页面/小程序 UI 自动化执行流程

  

• 自动化脚本调用流程

  

依赖软件环境

1. Python 版本安装

下载 & 安装 Python，安装后在终端输入命令 python -v 和 pip list，能够执行，说明 Python 环境配置成功。

2. Java JDK 版本安装

下载 & 安装 Java JDK 安装后在终端输入命令java -version，java, javac命令能够执行，则 Java 环境配置成功。

3. Android SDK 版本安装

下载 & 安装 Android Studio，然后在里面安装 Android SDK

4. 配置 adb 环境

安装 Android Studio 后，配置 SDK 环境（若自动安装不成功，可到手动下载安装 ，安装后在终端输入命令 adb version 执行有结果，则说明配置成功

5. IDE 安装

下载 & 安装 Pycharm CE

FAutoTest 开发环境安装

• 使用pip安装框架所需的第三方库 uiautomator、websocket-client、lxml、bidict、ADBkeyBoard，如安装lxml、bidict、websocket-client可用pip形式安装，如安装lxml，

  pip install lxml

• 安装自身框架

  pip intsall dist/fastAutoTest-xxx.whl

• 打开微信Debug模式，安装 TBS 内核

  • 可在微信中打开 X5 调试地址：http://debugx5.qq.com
  • TBS 内核安装地址：http://debugtbs.qq.com
  • 详情方式见：http://x5.tencent.com/tbs/guide/debug/faq.html

使用方式

如何写测试案例，如微信 H5页面，如下所示：

# coding=utf-8 from fastAutoTest.core.h6.h6Engine import H5Driver # http://h6.baike.qq.com/mobile/enter.html 从微信进入此链接，首屏加载完后执行脚本 if __name__ == '__main__':    h6Driver = H5Driver()    h6Driver.initDriver()    h6Driver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')    h6Driver.clickFirstElementByText('白内障')    h6Driver.returnLastPage()    h6Driver.returnLastPage() print(h6Driver.getElementTextByXpath('/html/body/div[1]/div/div[3]/p'))    h6Driver.close()