小程序自动化测试神器Minium系列（一）环境搭建

一、什么是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:pyworkspaceminiprogram-demo" --auto-port 9420

看到如下显示，证明安装成功且小程序也会被启动！

三、编写测试脚本

1、项目结构

简单创建一个python项目即可，如下所示：

2、添加配置文件

在项目目录添加suite.json，示例如下：

{
  "pkg_list": [
    {
      "case_list": [
        "test_*"
      ],
      "pkg": "test_case.*_test"
    }
  ]
}

在项目目录添加config.json，这里替换上你自己本地环境的对应路径。示例如下：

{
  "project_path": "D:pyworkspaceminiprogram-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("执行测试结束！")