APP H5 混合自动化使用说明 [基于 Appium+Python 系列]

时间:2021-12-12 16:25:38

背景

前几天接到H5开发人员那边的业务开发需求单,说想将H5接入到自动化系列中,特此记录分享一下。

也可参考testerhome发表的文章链接:https://testerhome.com/topics/7866

环境前置准备

  • 手机与电脑USB连接,开启USB调试模式,通过adb devices可查看到此设备。
  • 电脑端、移动端安装chrome浏览器。(尽量保证移动端chrome版本低于电脑端)
  • App webview开启debug模式
  • 在电脑端Chrome浏览器地址栏输入chrome://inspect/#devices,进入调试模式:
    • 此时页面显示了手机型号、驱动名称、APP要调试的WebView名称
    • 点击inspect,若成功加载与APP端相同界面的调试页面,则配置成功
    • 若获取不到WebView或者调试页面预览框显示空白,则需要进行VPN破解–安装*软件(由于默认的DevTools使用的是appspot服务器,这在国内是需要翻越GWF)

尝试解决方法:

1、在windows host文件中增加:

61.91.161.217  chrome-devtools-frontend.appspot.com
61.91.161.217 chrometophone.appspot.com

2、使用*软件,如*蓝灯

环境检查

App webview 调试模式检查与开启

  • 基础检查方式

    • 打开app对应的h5页面,在chrome://inspect/#devices地址中,检查是否显示对应的webview,如没有,则当前未开启调试模式。
    • 在自动化代码中,进入到对应的H5页面,输出当前context,如果一直显示为Natvie,则webview未开启。
  • 开启方式
    在app中配置如下代码(在WebView类中调用静态方法setWebContentsDebuggingEnabled):

    if (Build.VERSION.SDK_INT >=Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
    }

    注:此步骤,一般需要App前端开发人员协助增加

浏览效果

chrome://inspect/#devices地址效果图类似如下:

APP H5 混合自动化使用说明 [基于 Appium+Python 系列]

点击inspect,正常则显示为如下:

APP H5 混合自动化使用说明 [基于 Appium+Python 系列]

代码实现

下述演示demo,均以微信App中的H5为例:
微信默认H5调试模式处于关闭,可用微信打开聊天窗口,输入debugx5.qq.com, 在弹出内核调试【信息】页面中 勾选"是否打开TBS内核Inspector调试功能" 来打开调试功能。

Python+Appium+WebDriver

__author__ = 'mikezhou'
#coding=utf-8 #appium 微信h5自动化示例
from appium import webdriver
import time packageName='com.tencent.mm'
appActivity='.ui.LauncherUI' desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1.1'
desired_caps['deviceName'] = 'K31GLMA660800338'
desired_caps['appPackage'] = packageName
desired_caps['appActivity'] = appActivity
desired_caps['fullReset'] = 'false'
desired_caps['unicodeKeyboard'] = 'True'
desired_caps['resetKeyboard'] = 'True'
desired_caps['fastReset'] = 'false' desired_caps['chromeOptions']={'androidProcess': 'com.tencent.mm:tools'} #驱动H5自动化关键之一 driver = webdriver.Remote('http://127.0.1.1:4723/wd/hub', desired_caps) driver.implicitly_wait(30)
driver.find_element_by_name('我').click()
print driver.contexts
driver.find_element_by_name('相册').click()
driver.find_element_by_xpath("//*[contains(@text,'正在繁星直播')]").click()
print driver.current_context
driver.find_element_by_xpath("//*[contains(@text,'正在繁星直播')]").click()
print driver.current_context
driver.switch_to.context('WEBVIEW_com.tencent.mm:tools')
print driver.current_context
print driver.page_source
driver.find_element_by_xpath('//*[@id="btnRecommend"]/div[1]').click()
driver.switch_to_default_content()
time.sleep(2)
driver.quit()

Python+AppiumLibrary+RobotFramework

注:RF关键字与用例部分,只提供关键代码,一些前置需要导入的library,自行添加:

App启动关键字

Open MobileFx Android App_H5
[Arguments] ${remote_url} ${deviceName} ${appActivity} ${appPackage} ${platformVersion} ${Process}
... ${app}=${Empty}
[Documentation] *启动手机繁星app_H5[Android]*
...
... 入参顺序:
...
... Arguments: 远程服务地址|设备名称|待测应用appActivity| 待测应用package包名|平台版本号|webveiw进程名
...
... Examples:
...
... | Open MobileFx Android App H5 | http://localhost:4723/wd/hub | Android Emulator | .ui.LauncherUI | 'com.tencent.mm | 4.4.2 | com.tencent.mm:tools | ${androidProcess}= Create Dictionary androidProcess=${Process}
Open Application ${remote_url} alias=fanxingappForAndroid platformName=Android deviceName=${deviceName} automationName=appium appActivity=${appActivity}
... appPackage=${appPackage} platformVersion=${platformVersion} unicodeKeyboard=True resetKeyboard=True app=${app} chromeOptions=${androidProcess}

套件用例区

*** Settings ***
Suite Setup 启动app
Suite Teardown Close All Applications
Library AppiumLibrary *** Variables ***
${appActivity} .ui.LauncherUI
${appPackage} com.tencent.mm
${deviceName} ${get_deviceName}
${platformVersion} ${get_platform_version}
${remote_url} ${android_remote_url}
${androidProcess} com.tencent.mm:tools *** Test Cases ***
微信分享验证
[Documentation] 检查首页搜索
[Tags] mikezhou main online
[Setup]
[Timeout]
Click Element Wait name=我
${contexts} get_contexts
${current_context} get_current_context
log ${contexts}
log ${current_context}
Click Element Wait name=相册
${current_context} get_current_context
log ${current_context}
Click Element Wait xpath=//*[contains(@text,'助力鹿晗')]
${current_context} get_current_context
log ${current_context}
Click Element Wait xpath=//*[contains(@text,'助力鹿晗')]
${current_context} get_current_context
log ${current_context}
Switch To Context WEBVIEW_com.tencent.mm:tools
${current_context} get_current_context
log ${current_context}
${page} Log Source
log ${page}
Page Should Contain Text 鹿晗 timeout=15
Page Should Contain Text 概念诠释冒险精神
Click Element Wait xpath=/html/body/div[1]/div
sleep 3
[Teardown] *** Keywords ***
启动app
Open MobileFx Android App_H5 ${remote_url} ${deviceName} ${appActivity} ${appPackage} ${platformVersion} ${androidProcess}

结束语

感慨最近事事不利,感昌近十几天了都未好转。

福利

最近TesterHome社区创始人思寒在极客时间出版了个人专栏,针对移动端自动化测试实战,推荐给大家,希望对大家有所帮助

原文阅读

APP H5 混合自动化使用说明 [基于 Appium+Python 系列]