Appium移动端测试之元素定位
定位元素规则
从示例代码,大家就可以发现,和Selenium Web自动化一样,要操作界面元素,必须先 定位选择到该元素。Appium是基于Selenium的,所以 和 Selenium 代码 定位元素的 基本规则相同:
find_element_by_XXX
方法,返回符合条件的第一个元素,找不到抛出异常find_elements_by_XXX
方法,返回符合条件的所有元素的列表,找不到返回空列表- 通过
WebDriver
对象调用这样的方法,查找范围是整个界面 - 通过
WebElement
对象调用这样的方法,查找范围是该节点的子节点
界面元素查看工具
做 Selenium Web 自动化的时候,要找到元素,我们是通过浏览器的开发者工具栏来查看元素的特性,根据这些特性(属性和位置),来定位元素,Appium 要自动化手机应用,同样需要工具查看界面元素的特征。常用的查看工具是: Android Sdk包中的 uiautomateviewer
和 Appium Desktop 中的 Appium Inspector
uiautomateviewer
安卓查看APP界面元素,最常用的就是 Android SDK 中的工具 uiautomateviewer
,它在SDK目录目录 的 tools\bin 目录中
和Selenium一样,我们要定位选择元素,也是根据元素的特征,包括
- 元素的属性
- 元素的相对位置(相对父元素、兄弟元素等)
Appium Inspector
Appium Desktop 中的 Appium Inspector
也可以查看元素。它的一个优点是可以直接验证 选择表达式是否能定位到元素
定位元素的方法
根据ID
在Selenium Web自动化教程里,我们说过,如果能根据ID选择定位元素,最好根据ID,因为通常来说ID是唯一的,所以根据ID选择 效率高。在安卓应用自动化的时候,同样可以根据ID查找。但是这个ID ,是安卓应用元素的 resource-id
属性
使用如下代码
driver.find_element_by_id('expand_search')
根据CLASS NAME
安卓界面元素的 class属性 其实就是根据元素的类型,类似web里面的tagname, 所以通常不是唯一的。通常,我们根据class 属性来选择元素, 是要选择多个而不是一个。如果你确定 要查找的 界面元素的类型 在当前界面中只有一个,就可以根据class 来唯一选择。
使用如下代码
driver.find_elements_by_class_name('android.widget.TextView')
根据ACCESSIBILITY ID
元素的 content-desc 属性是用来描述该元素的作用的。如果要查询的界面元素有 content-desc属性,我们可以通过它来定位选择元素。
使用如下代码
driver.find_element_by_accessibility_id('找人')
Xpath
Appium 也支持通过 Xpath选择元素。但是其可靠性和性能不如 Selenium Web自动化。Web自动化对Xpath的支持是由浏览器实现的,而Appium Xpath的支持是 Appium Server实现的。浏览器产品的成熟度比Appium要高很多。Xpath是标准语法,表达式的语法规则和 以前Selenium里面Xpath的语法是一样的,比如
driver.find_element_by_xpath('//ele1/ele2[@attr="value"]')
注意:
selenium自动化中, xpath表达式中每个节点名是html的tagname。但是在appium中, xpath表达式中 每个节点名 是元素的class属性值。比如:要选择所有的文本节点,就使用如下代码
driver.find_element_by_xpath('//android.widget.TextView')
安卓 UIAutomator
根据id,classname, accessibilityid,xpath,这些方法选择元素,其实底层都是利用了安卓 uiautomator框架的API功能实现的。参考 这里的谷歌安卓官方文档介绍: https://developer.android.google.cn/training/testing/ui-automator
也就是说,程序的这些定位请求,被Appium server转发给手机自动化代理程序,就转化为为uiautomator里面相应的定位函数调用。其实,我们的自动化程序,可以直接告诉 手机上的自动化代理程序,让它 调用UI Automator API的java代码,实现最为直接的自动化控制。
主要是通过 UiSelector 这个类里面的方法实现元素定位的,比如
code = 'new UiSelector().text("热门").className("android.widget.TextView")'
ele = driver.find_element_by_android_uiautomator(code)
ele.click()
就是通过 text 属性 和 className的属性 两个条件 来定位元素。