文章目录
- 一:Appium 元素定位工具安装
- iOS获得设备id的方法:
- 二:iOS定位元素
- 自动处理系统权限弹框
一:Appium 元素定位工具安装
第一种:通过Appium1.6的Inspector来查看
可以通过定位找到元素xpath或name
个人不推荐用这个方法,实际操作中发现,每次操作后点击刷新比较慢,而且有时左侧布局文件更新不及时,导致点击左侧屏幕的控件找不到元素,有时App Source根本就没更新
第二种:通过macaca的App inspector来定位元素
1.安装macaca-li
$ npm install macaca-cli -g
2.检查macaca环境
$ macaca doctor
只要打印出的结果都绿色的日志信息,就表示环境是好的
3.安装app-inspector
$ npm install app-inspector -g
4.使用方法
通过下面命令启动检测web界面,然后就在Safari中自动打开了【http://本地IP:5678】进行检测
$ app-inspector -u YOUR-DEVICE-ID(设备id)
iOS获得设备id的方法:
真机的获取方法:idevice_id -l
$ xcrun simctl list
获得下面的数据:
第一个括号内的就是手机的device id,第二个括号内是模拟器的状态
结果如下,也可以获得元素的name和xpath
说明:我目前使用第二种方式,
1是直接刷新页面速度比appium中快点;
2是没有很大延迟,刷新后点击元素图标一般都能找到元素
(使用时还遇到过一个问题,web打开时手机界面底部没展示全,通过键盘command和-号组合缩小页面,展示了全部内容)
遇到的问题:app-inspector我这用的模拟器,用真机的情况下一直报错。模拟器没问题
Error: connect ECONNREFUSED 127.0.0.1:8001
at Object.exports._errnoException (util.js:1024:11)
at exports._exceptionWithHostPort (util.js:1047:20)
at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1150:14)
解决方法:
cd /usr/local/lib/node_modules/app-inspector/node_modules/xctestwd/XCTestWD
open XCTestWD.xcodeproj
修改XCTestWD和XCTestWDUITests,修改bundle id,签名然后编译通过即可。(参考webdriveragent的更改方法,操作一致)
二:iOS定位元素
总结一下IOS定位方式和各个定位方式的速度排序。
据我观察,按查找元素的顺序速度,从快到慢的顺序如下:
ios_predicate >> accessibility_id >> class_name >>xpath
注⚠️:(论坛比较多的说法是class_name>>accessibility_id,在这里我们姑且认为它们的速度是一样的。)
- 元素属性介绍
type
:元素类型,与className作用一致,如:XCUIElementTypeButtonvalue
: 一般不用name
:元素的文本内容,可用作 AccessibilityId定位方式,如:ClearEmaillabel
:绝大多数情况下,与 name 作用一致enabled
:元素是否可点击,一般值为true或者falsevisible
;元素是否可见,一般值为true或者false
- ios_predicate
在 iOS 的 UI 自动化中,使用原生支持的Predicate定位方式是最好,可支持元素的单个属性和多个属性定位,强烈推荐使用。
使用方法,举例如下:
driver.find_element_by_ios_predicate("value == 'ClearEmail'")
driver.find_element_by_ios_predicate("type == 'XCUIElementTypeButton' AND value == 'ClearEmail'")
1)比较运算符:>、<、==、>=、<=、!=
可用于数值和字符串的比较:
如:value>100
或value == 'ClearEmail'
或 value != 'ClearEmail'
driver.find_element_by_ios_predicate("value>100")
2)范围运算符:IN、BETWEEN
可用于数值和字符串的范围核对
如:value BETWEEN {1,6}
或 value IN {'Clear','Email'}
driver.find_element_by_ios_predicate("value BETWEEN {1,6}")
3)字符串相关:CONTAINS、BEGINSWITH、ENDSWITH
包含某个字符串,如:value CONTAINS 'Email'
以某个字符串开头,如:value BEGINSWITH 'Clear'
以某个字符串结束,如:value ENDSWITH '班级Email'
driver.find_element_by_ios_predicate("value CONTAINS 'Email'")
4)通配符: LIKE
其中:?
代表一个字符,*
代表多个字符
如:一个元素的value属性为ClearEmail:value LIKE 'Clear?mail'
value LIKE 'Clear*'
以上这么多种文本都可以被识别为同一个元素。
driver.find_element_by_ios_predicate("value LIKE 'Clear*'")
5)正则表达式:MATCHES
如:一个元素的value属性为ClearEmail:value MATCHES '^C.+l$'
driver.find_element_by_ios_predicate("value MATCHES '^C.+l$'")
注⚠️:正则表达式详情可参考《Python-正则表达式》
6)两种及两种以上属性定位元素:AND
单个属性定位用符号AND连接起来即可,如下:
driver.find_element_by_ios_predicate("type == 'XCUIElementTypeButton' AND value == 'ClearEmail'")
- accessibility_id
替代以前的name
定位方式,在 iOS 上,主要使用元素的label
或name
(两个属性的值都一样)属性进行定位,如该属性为空,也是不能使用该属性。driver.find_element_by_accessibility_id('ClearEmail')
- class_name
使用元素的type
属性定位,特别注意该属性的唯一性!class_name
唯一的情况并不多,一般情况下用不上。driver.find_element_by_class_name('XCUIElementTypeButton')
- xpath
由于 iOS 10开始使用的 XCUITest 框架原生不支持,定位速度很慢,所以官方现在不推荐大家使用,也有其他替代的定位方式可使用。
1)使用绝对路径定位:driver.find_element_by_xpath('/XCUIElementTypeApplication/XCUIElementTypeButton')
2)使用相对路径定位driver.find_element_by_xpath('//XCUIElementTypeButton')
3)通过元素的索引定位driver.find_element_by_xpath('//XCUIElementTypeButton[index]')
4)通过元素的属性定位
一种属性:driver.find_element_by_xpath("//className[@value='ClearEmail']")
两种属性:driver.find_element_by_xpath("//className[@value='ClearEmail'][@ visible =true]")
部分属性(最强大):driver.find_element_by_xpath("//className[contains(@value,'ClearEmail')]")
- iOSClassChain
仅支持 iOS 10或以上,这是 github 的 Mykola Mokhnach 大神开发,仅限在 WebDriverAgent 框架使用,用于替代 xpath 的,但使用一阵子后,感觉灵活性没有 xpath 和 iOSNsPredicate 好,应该还不完善吧。具体使用方法,请见:https://github.com/appium/appium-xcuitest-driver/pull/391 。
find_element_by_ios_class_chain
def find_element_by_ios_class_chain(self, class_chain_string):
"""Find an element by ios class chain string.
Args:
class_chain_string (str): The class chain string
Usage:
driver.find_element_by_ios_class_chain('XCUIElementTypeWindow/XCUIElementTypeButton[3]')
Returns:
`appium.webdriver.webelement.WebElement`
:rtype: `appium.webdriver.webelement.WebElement`
"""
return self.find_element(by=MobileBy.IOS_CLASS_CHAIN, value=class_chain_string)
以上这个多定位方式。根据我的经验,推荐使用:
Android:AndroidUIAutomator > className = id = AccessibilityId > xpath。
iOS:iOSNsPredicateString > className = AccessibilityId> xpath。
总结:
- 选择定位方式的判断:
如果显示在界面的文本唯一或是第一个出现:使用accessibility
如果class唯一或是第一个出现:className
ID或class不方便定位,控件属性有明确的匹配规则:iOSNsPredicate
如果有工具可以直接给出准确的xpath:xpath
实在不行就用坐标吧 driver.tap([(30, 95), [30, 98]], 500)
- 如果控件的属性visible是false的话,请使用控件坐标并获取中心点用tap点击,直接点击控件会失败
自动处理系统权限弹框
autoAcceptAlerts
:True 低版本有效
autoAcceptAlerts 如果它们弹出,将自动接受所有iOS警报。这包括隐私访问权限警报(例如,位置,联系人,照片)。默认为false。true 要么 false
autoDismissAlerts 如果所有iOS警报弹出,将自动将其关闭。这包括隐私访问权限警报(例如,位置,联系人,照片)。默认为false。true 要么 false
def get_desired_capabilities():
desired_caps = {
#平台名称
'platformName': 'iOS',
#平台版本
'platformVersion': '11.3',
#设备名称
'deviceName': 'iPhone 8 Plus',
#app 的地址
'app': '/Users/tanzhiwu/Desktop/appium自动化测试/UTengineFrameworkTest.app',
#bundleid 如果没有填 app 地址,填了这个 id 就会直接运行已安装的 app
'bundleId': 'com.ut.pc.UTengineFrameworkTest',
#超时时间
'newCommandTimeout': 60,
#自动化测试平台
'automationName': 'Appium',
#是否不重新安装启动
'noReset': True
#自动处理系统权限弹框
#`autoAcceptAlerts`:True 低版本有效
}
return desired_caps
#def setUp(self):
#获取我们设定的 capabilities,通知 appium Server 创建相应的对话
#desired_caps = desired_capabilities.get_desired_capabilities()
#获取 Server 的地址
#uri = desired_capabilities.get_uri()
#创建会话,得到 driver 对象,driver 对象封装了所有的设备操作
#self.driver = webdriver.Remote(uri,desired_caps)
#设定等待时间,系统函数,在这个时间内会持续获取,超时会失败
#self.driver.implicitly_wait(10)
#处理系统权限弹框(新版本方法)
#self.driver.switch_to.alter.accept()
import time, os
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction
driver = webdriver.Remote(command_executor='http://127.0.0.1:4723/wd/hub',
desired_capabilities={
'bundleId': 'com.53zaixian.young',
'platformName': 'iOS',
'platformVersion': '11.2.5',
'deviceName': 'iPhone7 test',
"automationName": "XCUITest",
"noReset": True, #是否不重新安装启动
"udid": "c527ea59a43aabf64f0c088f87b071fdefda7192"
})
#此方法判断用户是否已登陆
def check_shouye():
print('开始判断....')
try:
shouye=driver.find_element_by_accessibility_id("tab_dashboard")
except Exception as e:
print('no canceBtn')
print('点击账号登录')
driver.find_element_by_accessibility_id("login_account").click()
driver.implicitly_wait(5)
driver.find_element_by_accessibility_id("login_account_password_input").send_keys("123456")
#点击登录
driver.find_element_by_accessibility_id("login_account_login").click()
print('登录后')
time.sleep(5)
driver.find_element_by_accessibility_id("tab_dashboard")
#点击新建
TouchAction(driver).tap(x=329, y=571).perform()
#点击新建文档
TouchAction(driver).tap(x=63, y=438).perform()
#定位标题
TouchAction(driver).tap(x=40, y=120).perform()
else:
print('已经登陆了!')
check_shouye()
xpath定位方式在 XCUITest 底层原生不支持,由 appium 额外支持的,定位速度很慢,而且有时候定位不到元素的情况存在。综上所述,在 iOS 的 UI 自动化中,使用原生支持的iOSNsPredicateString定位方式是最好,支持也是最好的。