腾讯出品小程序自动化测试框架【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:\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("执行测试结束！")