小程序自動化測試框架Minium——框架介紹和環境搭建

轉自：https://blog.csdn.net/wessonlan/article/details/125360537

一、Minium 簡介

minium 是微信團隊爲小程序專門開發的自動化框架，我們可以用它來做小程序的UI自動化測試，但是它的能力卻不僅僅在於UI自動化。

正是得益於官方訂製打造，所以對於小程序很多原生內容和特性的支持自然也是非常獨到的，比如：

• 直接對函數進行 mock
• 直接跳轉到小程序某個頁面
• 直接設置頁面數據

這些能力是其他的一些工具做不到的。不僅如此，還有諸多其他特性也非常的吸引人：

• 支持一套腳本，iOS & Android & 模擬器，三端運行
• 提供豐富的頁面跳轉方式，看不到也能去得到
• 可以獲取和設置小程序頁面數據，讓測試不止點點點
• 可以直接觸發小程序元素綁定事件
• 支持往 AppSerive 注入代碼片段執行
• 可以調用部分 wx 對象上的接口
• 支持 Mock wx 對象上的接口
• 支持 Hook wx 對象上的接口
• 通過 suite 方式管理用例，config 管理運行設備

二、環境搭建

主要是三大件：

• Python 3.8及以上
• 微信開發者工具
• 微信版本 >= 7.0.7

語言是基於Python來的，而且框架中某些接口也是繼承了unittest.TestCase，所以對於熟悉Python和unittest的童鞋來說，無疑又降低了上手難度。

如果是小白的話其實也不用過於擔心，可以抽時間快速學習一下基礎知識也可以上手實操。學習資源搜索引擎裏就太多啦，這裏放置一個菜鳥教程的學習鏈接。

Python 和 微信開發者工具的下載傳送門：

• Python：下載Python 3.8即可。
• 微信開發者工具：下載穩定版即可。

1. 安裝 minium 框架

在Python和開發者工具都安裝完成後，就可以安裝minium框架了。打開cmd輸入命令：

pip3 install https://minitest.weixin.qq.com/minium/Python/dist/minium-latest.zip

 執行以下命令查看安裝版本：

minitest -v

2.設置開發者工具

• 安裝微信開發者工具（我本機使用的版本是1.05.2103200),並打開安全模式: 設置 -> 安全設置 -> 服務端口: 打開
• 在工具欄菜單中點擊設置,選擇項目設置,切換到“本地設置”,將調試基礎庫選擇大於2.7.3的庫; 

3.開啓被測試項目的自動化端口號

開發者工具自動化能力檢查，命令行輸入：

"path/to/cli" auto --project "path/to/project" --auto-port 9420

注意這裏不是直接複製粘貼執行，這裏：

path/to/cli：指代開發者工具cli命令路徑。macOS: <安裝路徑>/Contents/MacOS/cli， Windows: <安裝路徑>/cli.bat
path/to/project: 指代填寫存放小程序源碼的目錄地址，文件夾中需要包含有project.config.json文件
以我win10本地爲例最後輸入的檢查命令：

"D:\Program Files (x86)\Tencent\微信web開發者工具\cli.bat" auto --project "D:\my-miniprogram\miniprogram-demo" --auto-port 9420

 4.代碼示例

項目結構

 first_test.py

import minium


class ComponentTest(minium.MiniTest):
    def test_ui_op(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()
        print("test_ui_op執行測試")

suite.json

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

 config.json

這裏替換上你自己本地的對應路徑。

{
  "project_path": "D:\\my-miniprogram\\miniprogram-demo",
  "dev_tool_path": "D:\\Program Files (x86)\\Tencent\\微信web開發者工具\\cli.bat",
  "debug_mode": "warn"
}

在項目根目錄下，輸入命令：

minitest -m test.first_test -c config.json -g -s suite.json

可以看到微信開發者工具在執行代碼裏的動作。

控制檯也有對應的輸出。

 測試完成後，開發者工具裏的項目會自動關閉掉。

 5.測試報告

在項目中的outputs裏存放了測試結果，我們可以方便的生成一份網頁版的報告

python -m http.server 12345 -d outputs