1、前言

提起 UI 自動(dòng)化測(cè)試，web 端常用 Selenium，手機(jī)端常用 Appium，那么很火的微信小程序可以用什么工具來(lái)進(jìn)行自動(dòng)化測(cè)試？本篇將介紹一款專(zhuān)門(mén)用于微信小程序的自動(dòng)化測(cè)試工具 - minium。

2、簡(jiǎn)介

minium 是為小程序?qū)ｉT(mén)開(kāi)發(fā)的自動(dòng)化框架, 提供了 Python 和 JavaScript 版本。使用 minium 可以進(jìn)行小程序 UI 自動(dòng)化測(cè)試, 但是 minium 的功能不止于僅僅是 UI 自動(dòng)化, 甚至可以使用 minium 來(lái)進(jìn)行函數(shù)的 mock, 可以直接跳轉(zhuǎn)到小程序某個(gè)頁(yè)面并設(shè)置頁(yè)面數(shù)據(jù), 做針對(duì)性的全面測(cè)試。

特性：

• 支持一套腳本，iOS & Android & 模擬器，三端運(yùn)行
• 提供豐富的頁(yè)面跳轉(zhuǎn)方式，看不到也能去得到
• 可以獲取和設(shè)置小程序頁(yè)面數(shù)據(jù)，讓測(cè)試不止點(diǎn)點(diǎn)點(diǎn)
• 可以直接觸發(fā)小程序元素綁定事件
• 支持往 AppSerive 注入代碼片段
• 可以調(diào)用部分 wx 對(duì)象上的接口

官方文檔：

https://run-noob.github.io/minium-doc-github/#/minium/Python/readme.

3、安裝

環(huán)境要求（Python 版本）：

Python 3.x

微信公共庫(kù)版本 >= 2.7.3

安裝 穩(wěn)定版微信開(kāi)發(fā)者工具

如果要測(cè) Android，下載 微信測(cè)試包

安裝：

微信開(kāi)發(fā)者工具-設(shè)置-安全設(shè)置，開(kāi)啟安全模式。

安裝 minium.

pip install minium

快速上手.

使用開(kāi)發(fā)者工具的命令行工具，輸入命令打開(kāi)測(cè)試小程序。

/Applications/wechatwebdevtools.app/Contents/MacOS/cli --auto /Users/wangmeng/WeChatProjects/testdemo --auto-port 9420

注：

這里的 --auto-port 填寫(xiě) 9420，不是開(kāi)發(fā)者工具安全模式的端口。

確保開(kāi)發(fā)者工具登錄的微信號(hào)具備被測(cè)小程序的開(kāi)發(fā)者權(quán)限。

/Applications/wechatwebdevtools.app/Contents/MacOS/cli 命令行工具所在位置。

Mac: <安裝路徑>/Contents/MacOS/cli

Windows: <安裝路徑>/cli.bat

/Users/wangmeng/WeChatProjects/testdemo 小程序工程的路徑（例如官方的小程序示例）。

輸入后，成功打開(kāi)對(duì)應(yīng)的小程序。

命令行輸出：Open project with automation enabled success，表示成功。

確認(rèn)開(kāi)發(fā)者工具調(diào)試基礎(chǔ)庫(kù)版本 >= 2.7.3。

打開(kāi) IDE，如 PyCharm，創(chuàng)建示例代碼。

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# 公眾號(hào)：AllTests軟件測(cè)試

import minium

mini = minium.Minium()
system_info = mini.get_system_info()
print(system_info)

執(zhí)行結(jié)果，成功打印出系統(tǒng)信息。

如果想在手機(jī)上運(yùn)行腳本，可以點(diǎn)擊開(kāi)發(fā)者工具的真機(jī)調(diào)試，連接成功后，再次運(yùn)行腳本，腳本就會(huì)在手機(jī)上面運(yùn)行。

連接成功。

再次執(zhí)行后，可以看到打印出的是手機(jī)上的系統(tǒng)信息。

測(cè)試框架.

minium 提供一個(gè)基于 unittest 封裝好的測(cè)試框架。

測(cè)試基類(lèi) MiniTest 會(huì)根據(jù)測(cè)試配置進(jìn)行測(cè)試，minitest 向上繼承了 unittest.TestBase。

示例代碼，2條用例，每條用例都加上了斷言。

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# 公眾號(hào)：AllTests軟件測(cè)試

import minium
import time

class MyTest(minium.MiniTest):
    def test_view(self):
        self.page.get_element("view", inner_text="視圖容器").click()
        self.page.get_element(".navigator-text", inner_text="swiper").click()
        self.page.get_elements("switch")[0].click()
        self.page.get_elements("switch")[1].click()
        assertValue1 = self.page.get_element(".weui-cell__bd").text
        self.assertEqual("指示點(diǎn)", assertValue1)
        time.sleep(0.5)
        self.app.navigate_back()

    def test_form(self):
        self.page.get_element("view", inner_text="表單組件").click()
        self.page.get_element(".navigator-text", inner_text="textarea").click()
        self.page.get_element("page > view > view > view:nth-child(1) > view.textarea-wrp > textarea").click()
        self.page.get_element("page > view > view > view:nth-child(1) > view.textarea-wrp > textarea").input("小程序自動(dòng)化測(cè)試")
        assertValue2 = self.page.get_element("page > view > view > view:nth-child(1) > view.textarea-wrp > textarea").text
        self.assertIn("小程序", assertValue2)
        time.sleep(0.5)
        self.app.navigate_back()

執(zhí)行結(jié)果，2條用例執(zhí)行成功。

自動(dòng)生成 outputs 目錄，將測(cè)試數(shù)據(jù)輸出到 outputs 目錄里，里面包含一個(gè)簡(jiǎn)易的測(cè)試報(bào)告。

打開(kāi)命令行，跳轉(zhuǎn)到腳本項(xiàng)目目錄里，輸入：

python -m http.server 8080 -d outputs

在瀏覽器中輸入 http://localhost:8080/ 可以查看測(cè)試報(bào)告。

執(zhí)行日志。

如果不想在 IDE 上運(yùn)行，只想在命令行上運(yùn)行用例。

在項(xiàng)目的根目錄上創(chuàng)建 suite.json 文件。

文件內(nèi)容：

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

項(xiàng)目結(jié)構(gòu)，case 目錄存放測(cè)試用例。

打開(kāi)命令行，跳轉(zhuǎn)到腳本項(xiàng)目目錄里（testdemo123 編寫(xiě)的腳本項(xiàng)目），輸入：

miniruntest -s suite.json

加載用例開(kāi)始執(zhí)行。

如果想在手機(jī)上運(yùn)行腳本（如 Android），只需要在用例目錄下創(chuàng)建 config.json 配置文件即可。

{
    "debug_mode": "info",
    "enable_app_log": false,
    "platform": "Android"
}

然后連接手機(jī)，并且保證 adb devices 能夠識(shí)別到手機(jī)，之后命令行輸入執(zhí)行命令就可以了。