一: 進入minium官方文檔
1. 進入minium目錄然后運行服務,出現以下提示說明打開成功,
2. 瀏覽器直接運行http://localhost:3000即可看到效果。
3. 下圖為進入網頁后的效果圖,選擇For MiniProgram(minium)進入即可(如果小程序是游戲版本則進入For MiniGame)
二: 打開微信開發工具的安全模式,這一步的作用主要是讓工具打開一個端口,用於實現端口連接。跟appium運行時要指定端口一樣的原理。
2.1 進入微信開發工具界面。
2.2 在工具欄菜單中點擊設置
2.3 在下拉option中選擇安全設置
2.4 設置菜單彈窗中切換的“安全”分頁
2.5 服務端口處點擊開啟(開啟之后會自動隨機一個端口號)
2.6 關閉設置彈窗即可自動保存
三:確認開發者工具調試基礎版本大於>=2.7.3
3.1 進入微信開發工具界面。
3.2 在工具欄菜單中點擊設置
3.3 在下拉option中選擇項目設置
3.3 切換到“本地設置”分頁
3.4 將調試基礎庫選擇大於2.7.3的庫
四:開始運行minium:
1. 進入工具cli所在目錄,執行下面指令。如果出現錯誤,可先看看下面的注意說明。
指令:path/to/cli --auto /miniprogram/project/path --auto-port 9420
# path/to/cli 是命令行工具所在位置:
# macOS: <安裝路徑>/Contents/MacOS/cli
# Windows: <安裝路徑>/cli.bat windows版本在安裝之后默認會把cli加入到系統路徑,可以先測試cli命令是否可用,如果可用,path/to/cli可以直接用cli替換 (通過Windows PowerShell進入Program Files (x86)時需要在文件名前后加" ")
# /miniprogram/project/path 是小程序工程的路徑( Windows下面用 \\ 代替 \ )
下圖為運行指令后的截圖:
1.2注意:如果出現下圖錯誤請先運行微信開發者工具然后再次運行指令。(不報錯可以跳過)
1.2.1 運行開發者工具有兩個方式。
- 通過桌面圖標進行運行
- 通過cli指令來運行,如下圖:
1.2.2 打開開發者工具之后重新運行cli --auto e:\\books --auto-port 9420,即可看見提示:Open project with automation enabled success E:\books\,說明開發者工具綁定了9420端口
五:運行官方demo查看當前設備的信息
- 新建一個minium_test.py文件,里面編寫以下代碼:
#!/usr/bin/env python3
import minium
mini = minium.Minium()
system_info = mini.get_system_info()
print(system_info)
2. 運行上訴文件
運行python minium_test.py指令,結果如下:
3. 真機運行上訴文件。
3.1 打開微信開發者工具
3.2 手機掃碼實現真機調試
3.3 運行python minium_test.py指令,結果如下:
擴展:運行實例代碼目前可用以下三個方式:
- 通過cmd運行python指令
- 利用miniruntest來運行
- 通過idea來運行
下圖為方式一和方式二的運行結果,其中框架之間打印的log日志都有些不同:
六: 通過PyCharm idea運行官方demo並查看結果報告,不需要我們單獨運行HTMLTestRunner就有報告,特別方便。
1. 新建first_test.py編寫測試用例。
# -*- coding: utf-8 -*-
import minium
class FirstTest(minium.MiniTest):
def test_get_system_info(self):
sys_info = self.app.call_wx_method("getSystemInfo")
print(sys_info)
print(sys_info.result.result)
self.assertIn("SDKVersion", sys_info.result.result)
2. 通過idea工具來運行代碼,結果如下(截圖打錯字:應該為輸出的日志)
報告目錄(報告跟運行的文件同屬目錄):
說明:很明顯我們無法直接觀看到報告信息,可以試一試下面操作方法。下面方式運行后,通過idea運行的日志也會一起顯示在報告中。
3. 通過miniruntest -p file_name -g (file_name為文件名,無須拼接.py)來運行文件,結果如下:
報告目錄如下:
說明:將之前通過idea運行生成的報告給合並了,並且能通過index.html來查看報告。
打開報告后的結果如下:
說明:報告頁面中“用例說明”處有數據的原因為,我在代碼中加入了注釋,注釋方式沿用unittest的格式。
七:場景:手機在不掃碼的情況下,實現真機調試。
前提:手機開啟開發者模式,並且能通過adb devices查詢到手機。
1. 在用例所在的目錄下新建config.json文件.
2. 編寫下面代碼
{ "platform": "Android" }
3. 運行first_test代碼
4. 能看到手機進入小程序,並開啟調試模式
整文說明:
執行minium代碼的人必須擁有小程序的開發權限,否則無法運行。
調試階段用idea運行即可挺方便,等需要后台運行時可配置jenkins來運行。
代碼運行過程中不允許關閉開發者工具,類似於通過appium運行時不能關閉appium工具。
配置config.json文件之后,手機沒有連上電腦然后運行代碼會出現(at.core.adbwrap.AdbException: '沒有在線的手機')錯誤,電腦連上手機之后重新運行即可或者先去除該文件。