介绍
什么是MiniTest
MiniTest是专属于小程序和小游戏的自动化测试框架，由三个部分组成，
- Minium小程序自动化框架
- 小程序云测试服务
- 小游戏云测试服务
什么是Minium
minium 是为小程序专门开发的自动化框架。使用 minium 可以进行小程序 UI 自动化测试, 但是 minium 的功能不止于仅仅是 UI 自动化, 甚至可以使用 minium 来进行函数的 mock, 可以直接跳转到小程序某个页面并设置页面数据, 做针对性的全面测试, 这些都得益于我们开放了部分小程序 API 的能力。除此之外，小程序有部分组件使用了系统原生的组件，对于这部分的组件，我们也基于 uiautomator 和 wda 做了补充。
特性
支持一套脚本，iOS & Android & 模拟器，三端运行
提供丰富的页面跳转方式，看不到也能去得到
可以获取和设置小程序页面数据，让测试不止点点点
可以直接触发小程序元素绑定事件
支持往 AppSerive 注入代码片段执行
可以调用部分 wx 对象上的接口
支持 Mock wx 对象上的接口
支持 Hook wx 对象上的接口
通过 suite 方式管理用例，config 管理运行设备
缺点
暂不支持H5页面的调试
开放社区人数较少，网上教程稀少，遇到问题需要啃源码和文档
安装
运行环境
Python 3.8及以上
微信开发者工具 (本文档中简称IDE)最新版本，并打开安全模式: 设置 -> 安全设置 -> 服务端口: 打开
微信 >= 7.0.7 (确认微信公共库版本 >= 2.7.3即可)
安装
自动安装
pip3 install minium
手动安装
#下载
pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip
#安装
python3 setup.py install
环境检查
cmd运行
minitest -v
输出版本号即说明环境安装成功
功能验证
import minium
mini = minium.Minium({
"project_path": "E:\code\front\dist",
"dev_tool_path": "D:\微信web开发者工具\cli.bat",
})
print(mini.get_system_info())
project_path 【小程序项目目录地址】
dev_tool_path 【开发者工具cli地址】，macOS: <安装路径>/Contents/MacOS/cli， Windows: <安装路径>/cli.bat
初试框架
配置文件
根目录下新建config.json
{
"project_path": "E:\code\front\dist",
"dev_tool_path": "D:\微信web开发者工具\cli.bat",
"debug_mode": "info", #日记级别 debug error
"auto_authorize": true, #自动处理授权弹窗
"test_port": 9420, #IDE端口
"platform": "ide", #运行平台ide, Android, IOS
"device_desire": {
"serial": "b777a722"
}
}
测试计划
根目录新建suite.json
{
"pkg_list": [
{
"case_list": [
"test_*"
],
"pkg": "test_case.test_*"
}
]
}
suite.json的pkg_list字段说明要执行用例的内容和顺序，pkg_list是一个数组，每个数组元素是一个匹配规则，会根据pkg去匹配包名，找到测试类，然后再根据case_list里面的规则去查找测试类的测试用例。可以根据需要编写匹配的粒度。注意匹配规则不是正则表达式，而是通配符。
pkg_list 执行用例的内容和顺序，为一个数组，可配置多个值
case_list case执行规则，为一个数组，可配置多个值
pkg 测试文件执行规则
第一个测试用例
import minium
class FirstTest(minium.MiniTest):
def test_get_system_info(self):
sys_info = self.mini.get_system_info()
self.assertIn("SDKVersion", sys_info)
执行测试用例
minitest -s suite.json -c config.json -g
-s 测试计划
-c 配置文件
-g 生成网页版测试报告
结果与报告
测试结果
每条用例的测试结果我们会存放到一个目录里面，里面包含:
1.包含用例执行信息的json文件
2.用例运行中的截图
3.用例运行中的日志
4.小程序运行中的日志
基于这些数据可以生成测试报告，也可以做一些存档的事情。
测试报告
根据用例的执行结果，我们基于Vue和element提供一个简洁的测试报告：
报告生成有2种方式:
1.执行用例的时候加上-g参数针
2.对已经生成的用例结果目录
minireport input_path output_path
input_path 测试结果目录
output_path 测试报告存储目录
框架进阶
脚手架
import minium
class FirstTest(minium.MiniTest):
@classmethod
def setUpClass(cls):
print('****所有用例执行前****')
@classmethod
def tearDownClass(cls):
print('****所有用例执行后****')
def setUp(self):
print('****每个用例执行前****')
def tearDown(self):
print('****每个用例执行后****')
def test_get_system_info1(self):
print("in the test_get_system_info1")
def test_get_system_info2(self):
print("in the test_get_system_info2")
数据驱动
import minium
data = [(1,2),(3,4)]
@minium.ddt_class
class FirstTest(minium.MiniTest):
@minium.ddt_case(*data)
@minium.ddt_unpack
def test_get_system_info(self,num1,num2):
print(num1,'*****',num2)
print(num1+num2)
截图
screen_shot()
import shutil
import minium
import os
class FirstTest(minium.MiniTest):
def test_get_system_info(self):
output_path = os.path.join(os.path.dirname(__file__), "outputs\\test_get_system_info.png")
if not os.path.isdir(os.path.dirname(output_path)):
os.mkdir(os.path.dirname(output_path))
if os.path.isfile(output_path):
os.remove(output_path)
self.app.screen_shot(output_path)
self.assertTrue(os.path.isfile(output_path))
if os.path.isdir(os.path.dirname(output_path)):
shutil.rmtree(os.path.dirname(output_path))
页面跳转
go_home() 跳转到小程序首页
navigate_to() 以导航的方式跳转到指定页面
redirect_to() 关闭当前页面，重定向到应用内的某个页面
switch_tab() 跳转到 tabBar 页面
import minium
import time
class FirstTest(minium.MiniTest):
@classmethod
def setUpClass(cls):
print('****setUpClass开始暂停等待获取token****')
time.sleep(5)
@classmethod
def tearDownClass(cls):
print('****关闭IDE****')
cls.mini.shutdown()
def test_get_system_info(self):
time.sleep(2)
self.app.redirect_to("/pages/ClassList/ClassList")
time.sleep(2)
self.app.go_home()
time.sleep(2)
self.app.navigate_to("/pages/AssignTaskList/AssignTaskList")
time.sleep(2)
self.app.go_home()
time.sleep(2)
self.app.switch_tab("/pages/UserCenter/UserCenter")
time.sleep(2)
元素定位
import minium
import time
class FirstTest(minium.MiniTest):
@classmethod
def setUpClass(cls):
print('****setUpClass开始暂停等待获取token****')
time.sleep(5)
@classmethod
def tearDownClass(cls):
print('****关闭IDE****')
cls.mini.shutdown()
def test_get_system_info(self):
time.sleep(2)
self.app.switch_tab('/pages/TaskRecord/TaskRecord')
self.page.get_element("/page/view/view/view/view[3]/view/view[4]",max_timeout=5).tap()
time.sleep(2)
self.page.get_element("/page/view/view/view/view[4]/view/view[1]/view[1]/view[2]/view[3]/view", max_timeout=5).tap()
time.sleep(2)
self.page.get_element("/page/view/view/view/view[4]/view/view[2]/view[2]/view[2]/form/button",max_timeout=5).tap()
time.sleep(2)
get_element() 在当前页面查询控件, 如果匹配到多个结果, 则返回第一个匹配到的结果
get_elements() 在当前页面查询控件, 并返回一个或者多个结果
真机调试
Android
配置测试 config.json
{
"project_path": "E:\code\front\dist",
"dev_tool_path": "D:\微信web开发者工具\cli.bat",
"debug_mode": "info",
"auto_authorize": true,
"platform": "Android",
"test_port": 9420,
"device_desire": {
"serial": "b777a722"
}
}
adb devices命令获取serial
获取微信测试APK安装命令
minitest --apk
安装微信测试APK
adb install -r D:\soft\Python\Python39\lib\site-packages\minium\native\lib\at\bin\AtServer.apk
执行测试用例
minitest -s suite.json -c config.json -g
IOS
安装 libmobiledevice
brew uninstall ideviceinstaller
brew uninstall libimobiledevice
brew install --HEAD libimobiledevice
brew link --overwrite libimobiledevice
brew install ideviceinstaller
brew link --overwrite ideviceinstaller
如果没有安装过直接 brew install ideviceinstaller 即可。
当然你也可以本地编译：
git clone https://github.com/libimobiledevice/libimobiledevice.git
cd libimobiledevice
./autogen.sh --disable-openssl
make
sudo make install
配置 WebDriverAgent
minium 不包含 WebDriverAgent（简称wda） 工程，先执行以下命令clone工程：
mkdir wda
cd wda
echo "{}" > package.json
npm i appium
echo `pwd`/node_modules/appium/node_modules/appium-webdriveragent
以上最后输出的路径为wda工程路径，可用xcode打开，也可写到device_desire配置中
按照以下指引配置工程
配置完成之后，可以用⌘+u快捷键运行 unit test 测试 wda 是否正常运行
配置测试 config.json
{
"platform": "iOS",
"device_desire":{
"wda_project_path": "/Users/sherlock/wda/node_modules/appium/node_modules/appium-webdriveragent", //自定义 wda 的路径
"device_info": {
"udid": "aee531018e668ff1aadee0889f5ebe21a2292...", //手机的 udid
"model": "iPhone XR",
"version": "12.2.5",
"name": "sherlock's iPhone"
}
}
}
执行测试用例
minitest -s suite.json -c config.json -g
其他
mock相关
相关函数
mock_wx_method() #mock掉小程序API的调用
restore_wx_method() #去掉函数的mock
mock_request() #mock wx.request 方法，根据正则匹配结果返回特定构造的数据
mock_request_once() #mock wx.request 方法，根据正则匹配结果返回特定构造的数据，无需调用restore_request()
restore_request() #清除掉所有mock request的匹配规则
hook相关
相关函数
hook_wx_method() #hook小程序API的调用
release_hook_wx_method() #释放hook小程序API的调用。
hook_current_page_method() #hook当前页面上的方法。
release_hook_current_page_method() #释放当前页面方法的监听函数。
性能相关
相关函数
start_get_perf() #获取 CPU 内存 数据
stop_get_perf() #停止获取 CPU 内存 数据
1476
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
