一、什么是Minium?
minium
是为小程序专门开发的自动化框架,使用minium
可以进行小程序UI
自动化测试。 当然,它的能力不仅仅局限于UI
自动化, 比如:
- 使用
minium
来进行函数的mock
- 可以直接跳转到小程序某个页面
- 设置页面数据, 做针对性的全面测试
这些能力是其他的一些工具所不具备的,不仅如此,它还有许多其他特性,也是很吸引人的:
- 支持一套脚本,
iOS
&Android
& 模拟器,三端运行 - 提供丰富的页面跳转方式,看不到也能去得到
- 可以获取和设置小程序页面数据,让测试不止点点点
- 可以直接触发小程序元素绑定事件
- 支持往
AppSerive
注入代码片段执行 - 可以调用部分
wx
对象上的接口 - 支持
Mock wx
对象上的接口 - 支持
Hook wx
对象上的接口 - 通过
suite
方式管理用例,config
管理运行设备 - ...
二、环境搭建
1、准备工作
- Python 3.8及以上
- 选择稳定版下载 微信开发者工具
- 微信 >= 7.0.7
2、自动安装
pip3 install minium
或者pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip
3、手动安装
下载minium安装包, 解压后进入文件夹, 运行
python3 setup.py install
4、设置微信开发者工具
5、找开发要源代码
这里我们以官方示例小程序项目作为演示,使用git
直接clone
:
git clone https://github.com/wechat-miniprogram/miniprogram-demo.git
下载到本地之后,先cd
到miniprogram-demo
中,然后cnpm i
。接着再cd
到miniprogram
中,再次cnpm i
。(npm 真不好使)
安装、依赖、编译成功,就可以看到如下小程序:
6、环境确认
minium安装完成后,可执行以下命令查看版本:
输入minitest -v
出现如下表示安装成功
开发者工具自动化能力检查
path/to/cli" auto --project "path/to/project" --auto-port 9420
路径说明:
-
path/to/project
: 指代填写存放小程序源码的目录地址,文件夹中需要包含有project.config.json
文件 -
path/to/cli
: 指代开发者工具cli
命令路径。macOS
:<安装路径>/Contents/MacOS/cli
,Windows
:<安装路径>/cli.bat
- 有类似以下
log
并且开发者工具上有以下提示的则通过,否则根据提示和开发者工具文档调试解决
举个栗子:
以我win10
系统为例,输入如下命令:"E:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat" auto --project "D:\pyworkspace\miniprogram-demo" --auto-port 9420
看到如下显示,证明安装成功且小程序也会被启动!
三、编写测试脚本
1、项目结构
简单创建一个python项目即可,如下所示:
2、添加配置文件
在项目目录添加suite.json
,示例如下:
{
"pkg_list": [
{
"case_list": [
"test_*"
],
"pkg": "test_case.*_test"
}
]
}
在项目目录添加config.json
,这里替换上你自己本地环境的对应路径。示例如下:
{
"project_path": "D:\\pyworkspace\\miniprogram-demo",
"dev_tool_path": "E:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"debug_mode": "warn"
}
3、编写测试代码
示例代码如下:
# -*- coding: utf-8 -*-
"""
@Time : 2022/12/30 15:48
@Auth : longrong.lang
@File :my_test.py.py
@IDE :PyCharm
@Motto:ABC(Always Be Coding)
"""
import minium
class ComponentTest(minium.MiniTest):
def test_ui_op(self):
self.page.get_element("view", inner_text="视图容器").click()
self.page.get_element("navigator", inner_text="swiper").click()
self.page.get_elements("switch")[0].click()
self.page.get_elements("switch")[1].click()
print("执行测试结束!")
4、执行测试脚本
选中测试类执行
运行结果如下:
命令行形式
minitest -m test_case.first_test -c config.json -g -s suite.json
运行结果如下:
效果
四、生成测试报告
输入如下命令,可生成一份美丽的测试报告
python -m http.server 12345 -d outputs
打开浏览器,访问http://localhost:12345即可查看报告。
五、写在最后
写这篇文章,算是技痒吧,在微信群看到某位同学分享的名字,我顺腾摸瓜花了一小时就有了它。
学习的意义,不在于一定要用上,而在于要用的时候可以轻松无缝衔接,而不是不会憋得一脑袋汗!
到此,小程序的入门分享完毕,感兴趣的同学可以查看官方文档。
我是测试君,关于后面小程序测试框架的更新,我也会继续,更多请继续关注我,觉得对你有用,请星标即可,不用转发!