一、minium介绍
官方的介绍:minium 是为小程序专门开发的自动化框架, 提供了 Python 和 JavaScript 版本。使用 minium 可以进行小程序 UI 自动化测试, 但是 minium 的功能不止于仅仅是 UI 自动化, 甚至可以使用 minium 来进行函数的 mock, 可以直接跳转到小程序某个页面并设置页面数据, 做针对性的全面测试, 这些都得益于我们开放了部分小程序 API 的能力。除此之外,小程序有部分组件使用了系统原生的组件,对于这部分的组件,我们也基于 uiautomator 和 wda 做了补充。
## 我们仅聚焦与ui自动化,工具的其他功能暂不做探索。
二、环境怎么搭建
minium环境的搭建非常简单,按照官方文档操作就行。
官网文档地址:登录 - 微信开发者代码管理https://git.weixin.qq.com/minitest/minium-doc
第一步:安装python 略
注意的是minium要求python3.8以上版本
第二步:安装微信开发者工具
稳定版 Stable Build | 微信开放文档微信开发者平台文档https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html直接下载安装包一路下一步直到安装完成
注意安装完成后打开安全模式:设置 -> 安全设置 -> 服务端口: 打开
第三步:安装minium
在线安装:
pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip
离线安装 :
https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip
解压后进入文件夹运行
python3 setup.py install
环境检查:
命令行执行:
minitest -v
出现以下结果说明安装成功:
{'version': '1.1.0', 'revision': '2fac2e36c281213874110f2088bc08c570bc1a2d', 'branch': 'master', 'update_at': '2021-08-05 21:17:09'}
第四步:开发者工具配置
实际上没啥配置内容,主要是弄到项目代码,appID,加入项目团队
获取小程序开发代码
这个直接找开发要git地址,获得代码拉取权限,可以根据需要选择拉取master代码或分支代码
由于各团队代码结构习惯的问题,直接问清楚开发小程序的代码目录
比如:***\special-mini-program\dist\weapp
获取AppID
这个也是直接问开发或者项目经理要
加入项目团队
这里的项目团队非常规意义的项目团队,是指微型小程序的团队
找项目经理加入就行
微信开发者工具导入项目
打开第二步安装的微信开发者工具,点击导入
目录选择微信小程序的目录,注意这个目录不一定是开发代码的根目录,具体问开发
打开后查看渲染是否正常,正常则关闭开发者工具,保留创建项目页面。这种方式打开的环境不能支持自动化脚本,需要开启监听端口。
命令行开启开发者工具并打开监听端口
进入开发者工具安装目录
执行命令:cli.bat --auto D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420
D:\autotest\weixin\special-mini-program\dist\weapp::微信小程序代码目录
9420是监听端口
比如:
C:\Users\55401>d:
D:\>cd D:\Program Files (x86)\Tencent\微信web开发者工具
D:\Program Files (x86)\Tencent\微信web开发者工具>cli.bat --auto D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420
√ IDE server has started, listening on http://127.0.0.1:35808
[warn] DEPRECATED please upgrade to the following v2 command instead ( doc: https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html )
cli auto --project D:\autotest\weixin\special-mini-program\dist\weapp --auto-port 9420
√ Open project with automation enabled success D:\autotest\weixin\special-mini-program\dist\weapp
命令执行后会打开微信开发者工具。
第五步:开始使用
新建python文件demo.py
import minium
mini = minium.Minium({
"project_path": "path/to/project", # 替换成你的【小程序项目目录地址】
"dev_tool_path": "path/to/cli", # 替换成你的【开发者工具cli地址】,macOS: <安装路径>/Contents/MacOS/cli, Windows: <安装路径>/cli.bat
})
print(mini.get_system_info())
到这里minium就搭建好了,其他插件的扩展根据需要自行安装就好。