FAutoTest一個 H5、小程式自動化測試框架

簡介

隨著產品業務形態逐漸從 App 延升到微信小程式、微信公眾號以及 QQ公眾號等，而之前的自動化建設主要是 Native App 為主，全手工測試已無法滿足快速增長的業務需求。為提升測試效率和質量，FAutoTest 框架致力於解決 QQ、微信內 UI 的自動化問題（包括微信內 H5頁面和小程式、QQ 內 H5頁面），提升自動化測試的效率和穩定性。

FAutoTest 是一款成長中的框架，吸收借鑑了一些 UI 自動化工具的優秀設計理念和思想。如果框架有不足地方，或者你有更好的建議，歡迎提交 Issues 參與貢獻。

特性

FAutoTest 專業服務於微信 H5/小程式的UI自動化測試，提升測試效率與質量。

• 支援微信 H5頁面，能識別常見 H5控制元件，能獲取頁面任意內容（常見的如文字、圖片、連結等）
• 支援小程式內控制元件識別，操作，頁面內容獲取等
• 支援安卓 Native 頁面組合操作使用
• 簡單的 API 設計，較低的使用門檻
• 支援基礎的效能測試監控
• 功能擴充套件性強，擴充套件門檻低

架構

1. 整體採用分層設計，API設計方式參考 WebDriver

2. 整體框架是一個同步阻塞的模型：在一個執行緒中迴圈的執行 receive 方法，等待收到 response，傳送訊息後，阻塞，只有當 receive 方法獲得訊息時，才會解除阻塞，傳送下一條訊息，具備超時異常處理機制

3. 框架內打包了 Python 版本的 UIAutomator，方便在安卓 Native 頁面進行操作

User Interface(使用者互動層)：  提供給使用者所有的介面操作 API(H5介面及小程式介面)，使用者不需要關注框架內部實現，只需要關注自身業務邏輯流程（手工用例流程轉換成自動化流程）

PageOperator(操作解析層)：  主要用於接收和解析使用者命令後傳遞給下層 Engine 層

Engine( H5&小程式引擎層)：  將使用者命令傳輸到手機，並返回結果資訊。封裝 WebSocket 和單執行緒池，透過WebSocket Debug URL 和瀏覽器核心建立連結，傳送 Json 格式的協議到手機端進行使用者指定的操作。

業務流程

• H5頁面/小程式 UI 自動化執行流程

  

• 自動化指令碼呼叫流程

  

依賴軟體環境

1. Python 版本安裝

下載 & 安裝  Python ，安裝後在終端輸入命令 python -v 和 pip list，能夠執行，說明 Python 環境配置成功。

2. Java JDK 版本安裝

下載 & 安裝  Java JDK  安裝後在終端輸入命令java -version，java, javac命令能夠執行，則 Java 環境配置成功。

3. Android SDK 版本安裝

下載 & 安裝  Android Studio ，然後在裡面安裝 Android SDK

4. 配置 adb 環境

安裝 Android Studio 後，配置 SDK 環境（若自動安裝不成功，可到 手動下載安裝  ，安裝後在終端輸入命令 adb version 執行有結果，則說明配置成功

5. IDE 安裝

下載 & 安裝  Pycharm CE

FAutoTest 開發環境安裝

• 使用pip安裝框架所需的第三方庫 uiautomator、websocket-client、lxml、bidict、ADBkeyBoard，如安裝lxml、bidict、websocket-client可用pip形式安裝，如安裝lxml，

  pip install lxml
  

• 安裝自身框架

  pip intsall dist/fastAutoTest-xxx.whl
  

• 開啟微信Debug模式，安裝 TBS 核心

  • 可在微信中開啟 X5 除錯地址： http://debugx5.qq.com
  • TBS 核心安裝地址： http://debugtbs.qq.com
  • 詳情方式見：

使用方式

如何寫測試案例，如微信 H5頁面，如下所示：

# coding=utf-8 from fastAutoTest.core.h5.h5Engine import H5Driver # http://h5.baike.qq.com/mobile/enter.html 從微信進入此連結，首屏載入完後執行指令碼 if __name__ == '__main__':
    h5Driver = H5Driver()
    h5Driver.initDriver()
    h5Driver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')
    h5Driver.clickFirstElementByText('白內障')
    h5Driver.returnLastPage()
    h5Driver.returnLastPage() print(h5Driver.getElementTextByXpath('/html/body/div[1]/div/div[3]/p'))
    h5Driver.close()

1. 從微信初始化 H5頁面，如進入  http://h5.baike.qq.com/mobile/enter.html
2. 進入頁面後找到需要操作的控制元件的xpath，可透過 chrome:inspect 找到當前頁面，找到控制元件的xpath
3. 初始化框架並進行 API 呼叫，如執行點選控制元件等
4. 關閉框架，執行用例

QQ 的 H5頁面：

# coding=utf-8 from fastAutoTest.core.qq.qqEngine import QQDriver # 從動態 -> 動漫進入 if __name__ == '__main__':
    qqDriver = QQDriver()
    qqDriver.initDriver()
    qqDriver.clickFirstElementByText('英雄救美，這也太浪漫了')
    qqDriver.returnLastPage()
    qqDriver.clickElementByXpath('//*[@id="app"]/div/ul/li[2]')
    qqDriver.returnLastPage()
    qqDriver.close()

1. 從 QQ 動態，進入動漫 H5頁面
2. 找到需操作的控制元件的xpath，可透過 chrome:inspect 找到當前頁面，找到控制元件的xpath
3. 初始化框架並進行相關 API 呼叫
4. 關閉框架，執行用例

微信小程式：

# coding=utf-8 from fastAutoTest.core.wx.wxEngine import WxDriver import os # 進入企鵝醫典小程式 if __name__ == '__main__':
    wxDriver = WxDriver()
    wxDriver.initDriver() # 點選全部疾病 wxDriver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')
    wxDriver.clickFirstElementByText('白內障')
    wxDriver.returnLastPage()
    wxDriver.returnLastPage() # 截圖 dirPath = os.path.split(os.path.realpath(__file__))[0] PIC_SRC = os.path.join(dirPath, 'pic.png')
    wxDriver.d.screenshot(PIC_SRC)
    wxDriver.close()

1. 搜尋小程式，如企鵝醫典小程式，進入小程式頁面
2. 同樣找控制元件的xpath，同上操作
3. 初始化框架，進行相關 API 呼叫
4. 關閉框架，執行用例