1. 場(chǎng)景

之前寫(xiě)過(guò) 微信小程序的幾種方式，對(duì)于有源碼的小程序推薦使用微信開(kāi)放的 SDK 來(lái)做自動(dòng)化，否則只能使用原生或 WebView 的方式。

[[326404]]

最近在用 Python + Appium 在微信小程序做一個(gè)自動(dòng)化項(xiàng)目，中間遇到很多問(wèn)題，都一一解決了。

本篇文章將和大家聊聊微信小程序自動(dòng)化究竟有哪些坑?

2. 小程序入口

對(duì)大部分人來(lái)說(shuō)，使用小程序的方式一般是在微信主界面下拉屏幕后，然后選中目標(biāo)小程序的圖標(biāo)，進(jìn)入到程序應(yīng)用

另外，由于小程序在屏幕的展示位置不固定，會(huì)影響到自動(dòng)化程序的穩(wěn)定性

def swipe_down(step): 
    # 屏幕寬度 
    x = driver.get_window_size()['width'] 
 
    # 屏幕高度 
    y = driver.get_window_size()['height'] 
 
    # 起始x軸和y軸坐標(biāo) 
    x1 = int(x * 0.5)  
    y1 = int(y * 0.25)  
 
    # 終點(diǎn)y軸坐標(biāo) 
    y2 = int(y * (0.25 + step))  
 
    # 向下滑動(dòng)屏幕 
    driver.swipe(x1, y1, x1, y2, 1000) 
 
# 向下滑動(dòng)屏幕 
swipeDown(0.4)  
 
# 找到目標(biāo)小程序的圖標(biāo)元素，從頂部進(jìn)入小程序 
# pass 

這里，更推薦另外一種方式。

具體操作步驟是：先將目標(biāo)小程序轉(zhuǎn)發(fā)到文件傳輸助手，然后將文件傳輸助手設(shè)置為置頂消息

這樣，只需要點(diǎn)擊第一條消息 Item，進(jìn)入到文件傳輸助手頁(yè)面，然后點(diǎn)擊最后一條消息，即可以進(jìn)入到小程序頁(yè)面

# 進(jìn)入到文件傳輸助手聊天頁(yè)面 
for item in chat_record_elements: 
    chat_record_name = item.text 
    if chat_record_name == '文件傳輸助手': 
        item.click() 
        break 
 
def find_element_by_id_and_text(driver: webdriver, id, text): 
    """ 
    通過(guò)id和文本內(nèi)容查找元素 
    :param driver: 
    :param id: 
    :param text: 
    :return: 
    """ 
    result = None 
    elements = driver.find_elements_by_id(id) 
    if elements: 
        for item in elements: 
            if item.text == text: 
                result = item 
                break 
 
    return result 
 
 
# 點(diǎn)擊小程序，進(jìn)入到目標(biāo)應(yīng)用程序 
mini_program_tag = find_element_by_id_and_text(driver, 'com.tencent.mm:id/apc', '160掛號(hào)丨預(yù)約健康醫(yī)療服務(wù)平臺(tái)') 

3. 審查網(wǎng)頁(yè)元素

由于小程序是基于騰訊 X5 內(nèi)核的 WebView，為了方便頁(yè)面元素的定位及操作，需要開(kāi)啟調(diào)試模式

一般來(lái)說(shuō)，對(duì)于低版本 6.X 的微信，只需要從任意的聊天記錄，點(diǎn)擊 debugx5.qq.com 鏈接，進(jìn)入到 X5 調(diào)試頁(yè)面，打開(kāi) TBS 內(nèi)核 Inspector 調(diào)試功能即可

但是，在實(shí)際使用過(guò)程中發(fā)現(xiàn)，部分手機(jī)即使使用低版本微信，也沒(méi)法通過(guò) Chrome inspect 命名，查看到小程序頁(yè)面元素

因此，如果你的設(shè)備沒(méi)法利用上面的方式審查網(wǎng)頁(yè)元素，建議下載微信 play 版本，root 后安裝 XP 框架和 WebViewDebugHook 插件，強(qiáng)制打開(kāi)調(diào)試功能。

下載地址：

https://github.com/feix760/WebViewDebugHook

4. ChromeDriver 版本對(duì)應(yīng)

正常使用 appium 命令打開(kāi) Appium Server 會(huì)使用系統(tǒng)默認(rèn)的 ChromeDriver

# 開(kāi)啟appium server 
appium  

如果 ChromeDriver 的版本和微信 WebView 版本不一致，會(huì)報(bào)如下的錯(cuò)誤

因此，我們啟動(dòng) Appium Server 的正確步驟如下：

首先，Chrome 中輸入 chrome://inspect/#devices，查看 WebView 的版本號(hào)

然后，通過(guò)下面的鏈接找到 ChromeDriver 對(duì)應(yīng)的版本號(hào)

查看地址：

https://raw.githubusercontent.com/appium/appium-chromedriver/master/config/mapping.json

接著，下載對(duì)應(yīng)版本號(hào)為：2.29 的 ChromeDriver

下載地址：

https://chromedriver.storage.googleapis.com/index.html

最后，使用 --chromedriver-executable 參數(shù)，顯式指定以某一個(gè)版本的 ChromeDriver 啟動(dòng) Appium Server 即可

# 開(kāi)啟appium server 
# 顯式運(yùn)行某個(gè)版本的chromedriver 
appium --chromedriver-executable  /Users/xingag/Desktop/test/chromedriver29 

5. 上下文及進(jìn)程

由于微信存在多個(gè)上下文，要對(duì) Web 頁(yè)面控件元素進(jìn)行操作，必須先切換到對(duì)應(yīng)的上下文

和 Selenium 類(lèi)型，只需要找出所有的上下文，并篩選出當(dāng)前合適的上下文即可

為了保證上下文能正確獲取到，最好在獲取之前強(qiáng)行等待幾秒

# 所有的上下文 
print(driver.contexts) 
 
# 切換到對(duì)應(yīng)Web的上下文 
driver.switch_to.context('WEBVIEW_com.tencent.mm:appbrand0') 

另外一個(gè)坑是，小程序是單獨(dú)運(yùn)行在其他進(jìn)程中，如果不顯式指定運(yùn)行進(jìn)程，切換上下文會(huì)失敗。

解決辦法如下：

首先，打開(kāi)小程序界面

然后，通過(guò) adb 命令，找到棧頂 Activity 對(duì)應(yīng)的 pid

接著，利用 pid 值，找到小程序的進(jìn)程名稱(chēng)

# 當(dāng)前棧頂activity的進(jìn)程 
adb shell dumpsys activity top | grep ACTIVITY 
#  ACTIVITY com.tencent.mm/.plugin.appbrand.ui.AppBrandUI 247e612 pid=4389 
 
# 通過(guò)進(jìn)程pid，即：4389，找到進(jìn)程名稱(chēng) 
adb shell ps 4389 
# u0_a291   4389  318   2274008 262160 sys_epoll_ 00000000 S com.tencent.mm:appbrand0 
 
# 小程序進(jìn)程名：com.tencent.mm:appbrand0 

最后，在 Appium 啟動(dòng)配置項(xiàng)中加入 chromeOptions 項(xiàng)，指定目標(biāo)小程序的運(yùn)行進(jìn)程

# 微信配置文件 
caps = { 
    "platformName": "Android", 
    "deviceName": "ca2b3455", 
    "appPackage": 'com.tencent.mm', 
    "appActivity": 'com.tencent.mm.ui.LauncherUI', 
    "autoGrantPermissions": True, 
    # 指定目標(biāo)小程序的進(jìn)程名稱(chēng) 
    "chromeOptions": { 
        "androidProcess": "com.tencent.mm:appbrand0" 
    }, 
    "noReset": True 
} 

6. 窗體句柄切換

切換上下文之后，就可以操作當(dāng)前頁(yè)面的元素控件了，但是，如果有頁(yè)面跳轉(zhuǎn)，可能窗體發(fā)生變化，直接元素查找會(huì)失敗

因此，一般對(duì)于 WebView 頁(yè)面內(nèi)的元素操作，可以先獲取所有的窗口句柄，遍歷切換到每一個(gè)窗口句柄，直到查找到元素即可

需要注意的是，如果是單頁(yè)面操作，就不涉及到窗體句柄切換

def find_element_by_web(driver: WebDriver, by: By, selector): 
    """ 
    在webview中查找元素，涉及到切換窗口句柄：handle 
    :return: 
    """ 
    # 獲取所有的handle 
    all_handles = driver.window_handles 
 
    result_element = None 
 
    for handle in all_handles: 
        try: 
            driver.switch_to.window(handle) 
            # 查找方式 
            if by == By.XPATH: 
                result_element = driver.find_element(By.XPATH, selector) 
            elif by == By.CSS_SELECTOR: 
                result_element = driver.find_element(By.CSS_SELECTOR, selector) 
            print('查找成功，直接返回') 
            break 
        except Exception as e: 
            print('查找失敗，繼續(xù)查找') 
            pass 
 
    return result_element 

7. 最后

使用 Appium 做微信小程序自動(dòng)化遇到的坑主要就上面這些，其他操作和原生、混合應(yīng)用類(lèi)似，這里就不詳細(xì)展開(kāi)說(shuō)明。