騰訊出品小程式自動化測試框架【Minium】系列（一）環境搭建之第一個測試程式

久曲健發表於2023-01-11

框架

一、什麼是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("執行測試結束！")