简介

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

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

特性

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

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

整体采用分层设计，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等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 开发环境安装库名称版本下载地址uiautomator0.3.2https://pypi.org/project/uiautomator/#fileslxml4.2.3https://pypi.org/project/lxml/4.2.3/#filesbidict0.17.0https://pypi.org/project/bidict/#fileswebsocket-client0.44.0https://pypi.org/project/websocket-client/#files

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

pipinstalllxml

安装自身框架

pipintsalldist/fastAutoTest-xxx.whl

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

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

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

#coding=utf-8fromfastAutoTest.core.h6.h6EngineimportH5Driver#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()从微信初始化 H5页面，如进入http://h6.baike.qq.com/mobile/enter.html进入页面后找到需要操作的控件的xpath，可通过chrome:inspect找到当前页面，找到控件的xpath初始化框架并进行 API 调用，如执行点击控件等关闭框架，执行用例

QQ 的 H5页面：

#coding=utf-8fromfastAutoTest.core.qq.qqEngineimportQQDriver#从动态->动漫进入if__name__=='__main__':qqDriver=QQDriver()qqDriver.initDriver()qqDriver.clickFirstElementByText('英雄救美，这也太浪漫了')qqDriver.returnLastPage()qqDriver.clickElementByXpath('//*[@id="app"]/div/ul/li[2]')qqDriver.returnLastPage()qqDriver.close()从 QQ 动态，进入动漫 H5页面找到需操作的控件的xpath，可通过chrome:inspect找到当前页面，找到控件的xpath初始化框架并进行相关 API 调用关闭框架，执行用例

微信小程序：

#coding=utf-8fromfastAutoTest.core.wx.wxEngineimportWxDriverimportos#进入企鹅医典小程序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，同上操作初始化框架，进行相关 API 调用关闭框架，执行用例