微信小程序自动化测试框架 Minium——快速开始
Minium 是微信测试团队为小程序专门开发的自动化框架。它实现了miniprogram-automator 中小程序自动化能力。使用 Minium 可以进行小程序 UI 自动化测试，但是 minium 的功能不止于仅仅是 UI 自动化，甚至可以使用 Minium 来进行函数的 Mock，可以直接跳转到小程序某个页面并设置页面数据，做针对性的全面测试，这些都得益于我们开放了部分小程序 API 的能力。此外，还支持并封装了所有的原生操作都进行了封装，屏蔽了iOS/Android底层差异，实现了一套脚本在三端同时运行。
下面重点介绍Minium的安装和使用，以及可能遇到的问题和解决方案
安装Minium框架
- 自动安装（推荐）
pip安装，拉取最新版本minium
pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip
- 手动安装
下载minium安装包，解压后进入文件夹，python安装
python3 setup.py install
环境检查
- minium安装完成后，可执行以下命令查看版本：
minitest -v
例如输出以下信息
{'version': '1.2.8', 'revision': 'd9e296d820fc572ce7a36bef23f16294e8dbaf46', 'branch': 'master', 'update_at': '2022-07-01 14:30:51'}
- 开发者工具自动化能力检查
"path/to/cli" auto --project "path/to/project" --auto-port 9420
可能遇到的问题
- 端口被占用
Error: Port 9420 is in use (code 10)
关闭项目，杀掉端口进程，重新执行，或者使用其他端口号
- 连接超时问题
receive from remote timeout, id:xxxxxxxxxxx
一般是因为ide的通道被远程调试占用了，请检查ide是否有打开。建议关闭工具，重新执行，防止端口被占用。或者网络环境等原因引起
- 报错traceback中有出现
_miniClassSetUp的调用
确认下开发者工具上选用的基础库是最新的：开发者工具项目窗口右上角 -> 详情 -> 本地设置 -> 调试基础库
注意
- 微信开发者工具需保持登录状态
- 登录账号需有该小程序的开发者权限
PyCharm + 虚拟环境 配置开发环境
PyCharm工具编写用例脚本，使用Minium框架，配置虚拟环境，具体操作如下
-
Python Interpreter
打开设置窗口，进入Python Interpreter
[Settings -> Project: xxx -> Python Interpreter] -
Add Python Interpreter
点击设置按钮，点击Add Python Interpreter -
配置虚拟环境
配置Virtualenv Enviroment，选择Existing enviroment，interpreter选择python安装路径
（注意：需python3.8及以上，若有多个python环境，选择3.8及以上即可） -
验证
配置好环境后，会加载多个package，包括minium包。
若没有，可能是由于配置的python环境没有安装minium包，可重新选择python环境（配置虚拟环境）
或 安装minium框架（执行pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip）
PyCharm + 虚拟环境 配置开发环境
PyCharm工具编写用例脚本，使用Minium框架，配置虚拟环境，具体操作如下
-
Python Interpreter
打开设置窗口，进入Python Interpreter
[Settings -> Project: xxx -> Python Interpreter] -
Add Python Interpreter
点击设置按钮，点击Add Python Interpreter -
配置虚拟环境
配置Virtualenv Enviroment，选择Existing enviroment，interpreter选择python安装路径
（注意：需python3.8及以上，若有多个python环境，选择3.8及以上即可） -
验证
配置好环境后，会加载多个package，包括minium包。
若没有，可能是由于配置的python环境没有安装minium包，可重新选择python环境（配置虚拟环境）
或 安装minium框架（执行pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip）
简单例子
小程序demo参考 miniprogram-demo
简单UI页面操作
class FirstTest(minium.MiniTest):
def test_ui_op(self):
# 页面跳转
self.app.switch_tab("/pages/index/index")
# 元素定位
ele = self.page.get_element("/page/view/navigator[3]/button")
# 元素点击
ele.click()
# 判断元素是否存在
self.assertTrue(self.page.element_is_exists("/page/view[9]/mytest//view", max_timeout=5))
# 打印元素文本
inner = self.page.get_element("/page/view[9]/mytest//view").inner_text
self.logger.info("UI Case %s", inner)
config.json 配置
{
"project_path":"xxx", // 小程序项目路径
"dev_tool_path":"xxx", // 微信开发者工具安装路径
"platform": "ide"
}
运行case
minitest -m test.first_test -c config.json -g
运行结果
查看结果
测试结果默认存储在outputs文件下，运行命令 python3 -m http.server 12345 -d outputs 然后在浏览器上访问 http://localhost:12345 即可查看报告，如图：
