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

巴黎的灯光下

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

• 手机与电脑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.com61.91.161.217    chrometophone.appspot.com2、使用翻墙软件，如Lantern蓝灯
环境检查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地址效果图类似如下：




点击inspect，正常则显示为如下：



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

1. __author__ = 'mikezhou'
   
2. #coding=utf-8
   
3. 
   
4. #appium 微信h5自动化示例
   
5. from appium import webdriver
   
6. import time
   
7. 
   
8. packageName='com.tencent.mm'
   
9. appActivity='.ui.LauncherUI'
   
10. 
    
11. desired_caps = {}
    
12. desired_caps['platformName'] = 'Android'
    
13. desired_caps['platformVersion'] = '5.1.1'
    
14. desired_caps['deviceName'] = 'K31GLMA660800338'
    
15. desired_caps['appPackage'] = packageName
    
16. desired_caps['appActivity'] = appActivity
    
17. desired_caps['fullReset'] = 'false'
    
18. desired_caps['unicodeKeyboard'] = 'True'
    
19. desired_caps['resetKeyboard'] = 'True'
    
20. desired_caps['fastReset'] = 'false'
    
21. 
    
22. desired_caps['chromeOptions']={'androidProcess': 'com.tencent.mm:tools'}   #驱动H5自动化关键之一
    
23. 
    
24. driver = webdriver.Remote('http://127.0.1.1:4723/wd/hub', desired_caps)
    
25. 
    
26. driver.implicitly_wait(30)
    
27. driver.find_element_by_name('我').click()
    
28. print driver.contexts
    
29. driver.find_element_by_name('相册').click()
    
30. driver.find_element_by_xpath("//*[contains(@text,'正在繁星直播')]").click()
    
31. print driver.current_context
    
32. driver.find_element_by_xpath("//*[contains(@text,'正在繁星直播')]").click()
    
33. print driver.current_context
    
34. driver.switch_to.context('WEBVIEW_com.tencent.mm:tools')
    
35. print driver.current_context
    
36. print driver.page_source
    
37. driver.find_element_by_xpath('//*[@id="btnRecommend"]/div[1]').click()
    
38. driver.switch_to_default_content()
    
39. time.sleep(2)
    
40. driver.quit()
    
41. Python+AppiumLibrary+RobotFramework
    
42. 注：RF关键字与用例部分，只提供关键代码，一些前置需要导入的library，自行添加:
    
43. App启动关键字
    
44. Open MobileFx Android App_H5
    
45.     [Arguments]    ${remote_url}    ${deviceName}    ${appActivity}    ${appPackage}    ${platformVersion}    ${Process}
    
46.     ...    ${app}=${Empty}
    
47.     [Documentation]    *启动手机繁星app_H5[Android]*
    
48.     ...
    
49.     ...    入参顺序：
    
50.     ...
    
51.     ...    Arguments: 远程服务地址｜设备名称｜待测应用appActivity| 待测应用package包名|平台版本号|webveiw进程名
    
52.     ...
    
53.     ...    Examples:
    
54.     ...
    
55.     ...    | Open MobileFx Android App H5 | http://localhost:4723/wd/hub | Android Emulator | .ui.LauncherUI | 'com.tencent.mm | 4.4.2 | com.tencent.mm:tools |
    
56. 
    
57. 
    
58.     ${androidProcess}=    Create Dictionary    androidProcess=${Process}
    
59.     Open Application    ${remote_url}    alias=fanxingappForAndroid    platformName=Android    deviceName=${deviceName}    automationName=appium    appActivity=${appActivity}
    
60.     ...    appPackage=${appPackage}    platformVersion=${platformVersion}    unicodeKeyboard=True    resetKeyboard=True    app=${app}    chromeOptions=${androidProcess}
    
61. 套件用例区
    
62. 
    
63. *** Settings ***
    
64. Suite Setup       启动app
    
65. Suite Teardown    Close All Applications
    
66. Library           AppiumLibrary
    
67. 
    
68. *** Variables ***
    
69. ${appActivity}    .ui.LauncherUI
    
70. ${appPackage}     com.tencent.mm
    
71. ${deviceName}     ${get_deviceName}
    
72. ${platformVersion}    ${get_platform_version}
    
73. ${remote_url}     ${android_remote_url}
    
74. ${androidProcess}    com.tencent.mm:tools
    
75. 
    
76. *** Test Cases ***

复制代码

微信分享验证

1. [Documentation]    检查首页搜索
   
2.     [Tags]    mikezhou    main    online
   
3.     [Setup]
   
4.     [Timeout]
   
5.     Click Element Wait    name=我
   
6.     ${contexts}    get_contexts
   
7.     ${current_context}    get_current_context
   
8.     log    ${contexts}
   
9.     log    ${current_context}
   
10.     Click Element Wait    name=相册
    
11.     ${current_context}    get_current_context
    
12.     log    ${current_context}
    
13.     Click Element Wait    xpath=//*[contains(@text,'助力鹿晗')]
    
14.     ${current_context}    get_current_context
    
15.     log    ${current_context}
    
16.     Click Element Wait    xpath=//*[contains(@text,'助力鹿晗')]
    
17.     ${current_context}    get_current_context
    
18.     log    ${current_context}
    
19.     Switch To Context    WEBVIEW_com.tencent.mm:tools
    
20.     ${current_context}    get_current_context
    
21.     log    ${current_context}
    
22.     ${page}    Log Source
    
23.     log    ${page}
    
24.     Page Should Contain Text    鹿晗    timeout=15
    
25.     Page Should Contain Text    概念诠释冒险精神
    
26.     Click Element Wait    xpath=/html/body/div[1]/div
    
27.     sleep    3
    
28.     [Teardown]
    
29. *** Keywords ***
    
30. 启动app
    
31.     Open MobileFx Android App_H5    ${remote_url}    ${deviceName}    ${appActivity}    ${appPackage}    ${platformVersion}    ${androidProcess}<span style="background-color: rgb(255, 255, 255); font-size: 14px; font-weight: normal;"></span>

复制代码

草帽路飞UU

Click Element Wait，这个是自己封装的吗？

巴黎的灯光下

草帽路飞UU 发表于 2017-6-27 14:13
Click Element Wait，这个是自己封装的吗？

嗯，是的！