微信小程序自动化测试——基于 Appium & Python3
微信小程序自动化测试方案，基于 Appium 移动端测试框架及多种测试用例管理框架，使得UI测试更易于实施。
技术方案选型：
- Appium + Python3 + Behave （BDD风格，推荐）
- Appium + Python3 + Pytest
一、背景
在敏捷开发、快速迭代的发布节奏下，需要快速地对小程序、APP 等进行回归测试，为了使这一流程标准化、自动化、规范化的执行，本技术方案应运而生。
本项目的开源内容仅限于自动化驱动微信小程序部分（小程序界面元素的定位及驱动），包含了两种技术方案的用例 demo，demo 基于有车以后小程序，其他业务可自行扩展。
经过有车以后大半年的工程实践检验，该方案比较稳定。通过每天的持续回归测试，累计发现问题10+，效果显著。
二、使用教程
2.1 开启小程序 Web 调试
小程序本质上是一种 Web 应用，可以通过 PC 浏览器进行页面元素的 Inspect。为了进行页面元素的 Xpath 定位，必须先搞定这一步，参考官方文档： 【第六季】使用Timeline获取小程序的启动性能数据
注意这一步有较多人遇到手机无法开启调试的问题，关键点是要打开腾讯 X5 的调试开关。可反复尝试下面三个指令（特别是第三个指令），打开相应的开关， 一般情况下前两个指令就可以达到目的了。
http://debugmm.qq.com/?forcex5=true
http://debugx5.qq.com
http://debugtbs.qq.com
如果通过指令
chrome://inspect/devices#devices可以正常看到小程序页面，但是打开后白屏，可稍等几十秒时间， 如果还是不行或者出现HTTP/1.1 404 NOT FOUND提示，则需要浏览器设置代理翻墙。直到出现如下界面
2.2 ChromeDriver 下载
Appium 需要通过 chromedriver 驱动微信小程序的 webview，遗憾的是微信里面的 webview 版本号和 chromedriver 的版本号有一个对应的关系，两者必须要匹配。
微信扫码打开 http://httpbin.org/user-agent，即可看到自己的webview版本号（本示例为66）：
{
"user-agent": "Mozilla/5.0 (Linux; Android 7.0; SM-G928V Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko)
Version/4.0 Chrome/66.0.3359.126 MQQBrowser/6.2 TBS/044506 Mobile Safari/537.36 MMWEBID/9796
MicroMessenger/7.0.3.1400(0x2700033B) Process/tools NetType/WIFI Language/zh_CN"
}
去 ChromeDriver - WebDriver for Chrome 找到和自己匹配的 chromedriver 然后下载
下来，历史版本下载地址，例如，示例中的66和 ChromeDriver 2.40 可以兼容。
ChromeDriver 2.40
Supports Chrome v66-68
如果已经下载了正确的 chromedriver，但是 Appium 出现
No Chromedriver found that can automate Chrome '62.0.3202'， 报错信息是一个不相干的版本号
这种情况是因为 Appium 读取了系统版本的 webview 导致，没有正确读取微信使用的 webview 版本号。解决办法是在手机上安装一个同样版本的 Chrome（例如版本66）。
2.3 安装Appium并启动服务
用于驱动手机自动化操作，建议在服务器端运行此服务，运行服务平台推荐 Mac 或 Linux。（Windows下坑多，慎入）
需要安装 Android SDK、Java 等环境，推荐安装最新稳定版
2.4 安装 Python3 及依赖
此方案仅在 Python3 上测试通过，具体依赖列表参考 requirements.txt
推荐安装最新稳定版
2.5 修改configs/environment.py配置
符合自己实际情况即可
2.6 运行用例
- 通过 pytest 命令运行（如果报
No module named 'configs'则需要设置一下PYTHONPATH）：
pytest -v -s tests
- 通过 behave 命令运行：
behave --junit features
建议放到 jenkins 上触发执行
2.7 示例用例代码
以 behave 框架为例，通过 Native 以及 Web Xpath 两种方式定位和操作页面元素（详见demo）：
Scenario: 资讯-详情-操作
Given 进入有车以后
When 点击评测
"""
sleep.3
"""
When 点击评测详情
"""
sleep.8
"""
Then 翻2页
When 点击资讯收藏
"""
sleep.2
"""
2.8 运行结果截图
三、注意事项
3.1 微信安全性限制问题
注意尽量不要使用模拟器，应按照正常用户的使用流程，微信的很多功能是有操作频率限制的，一旦使用不当可能面临封号、或者限制使用的风险，所以尽量用小号测试
常见的封号原因：
- 平时微信会封禁的账户类型（诈骗，色情营销，吸粉账号等）
- 手机上安装了 Xposed 框架并激活了修改微信相关模块的用户
- 在手机上安装了 Magisk 框架并且激活了 Systemless Xposed 的用户
- 只在手机上安装了 Xposed 或 Magisk 框架但没有激活的用户
- 一部分只 ROOT 手机的用户（存疑）和使用越狱后 iOS 的用户
- 使用手机自带/第三方的微信分身功能同时使用多个微信账户
- 少部分什么都没装无辜躺枪的 Play 商店版微信用户（一脸懵逼）
- 使用模拟器或者多开的
3.2 关于等待时间
涉及到网络的操作或其他异步操作，一般需要显式的等待，根据经验进行调整
3.3 异常处理
每一步操作都需要做异常处理，一旦有异常即停止执行，保证后续脚本的执行环境
3.4 自动化环境
尽量使用 Mac，特别adb、node这些命令比在Windows下稳定多了
3.5 UI用例编写
应根据业务场景，做不同界面的兼容处理
3.6 关于 NATIVE 和 Webview 环境【重要】
如果通过 uiautomatorviewer 可以看到小程序内部的元素，则不用关注这个区别，直接按照安卓APP的定位方法即可，
值得注意的是，因为不是原生开发的，小程序里的元素没有Resource ID，但是可以通过文本、Xpath等去定位。
如果通过 uiautomatorviewer 只能看到一个 Webview（里面的子元素都看不到），那么处理起来会复杂一些，
自动化代码需要实现从原生的 NATIVE 环境切换到小程序的 Webview 环境、并在小程序的不同 Window 切换，详细参考代码实现。
这其中的原因暂未明确，可能微信有一定的控制策略。手头上的两台手机各种情况都出现过。
3.7 测试手机选型
尽量选择接近Android原生系统的手机（会减少很多莫名其妙的问题及不必要的麻烦），例如 Nexus、三星、乐视等。
！避免使用小米、华为、OV、一加这种经过深度定制或者阉割的手机！
安卓系统版本推荐 Android 7.x 或 Android 6.x （新版本的也可以，不过笔者的都是 7.x）
微信版本使用最新即可
3.8 如何切换小程序页面到当前页面？更多问题？
参考源码实现，部分细节未开源，可入群沟通
四、微信交流群
请扫码加群，如二维码失效，可加管理员 alisha_kelly 申请入群，备注小程序测试
五、版权声明
有车以后测试组荣誉出品，如果对您项目有帮忙，欢迎Star，开源声明 The 3-Clause BSD License