跳转至

定位元素

代码规则

点击这里,边看视频讲解,边学习以下内容

从示例代码,大家就可以发现,和Selenium Web自动化一样,要操作界面元素,必须先 定位(选择)元素。

Appium是基于Selenium的,所以 和 Selenium 代码 定位元素的 基本规则相同:

  • find_element 方法,返回符合条件的第一个元素,找不到抛出异常

  • find_elements 方法,返回符合条件的所有元素的列表,找不到返回空列表

  • 通过 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 属性

使用如下代码

from appium.webdriver.common.appiumby import AppiumBy

driver.find_element(AppiumBy.ID, 'expand_search')

具体细节,参考视频里面的讲解。

根据CLASS NAME

安卓界面元素的 class属性 其实就是根据元素的类型,类似web里面的tagname, 所以通常不是唯一的。

通常,我们根据class 属性来选择元素, 是要选择多个而不是一个。

当然如果你确定 要查找的 界面元素的类型 在当前界面中只有一个,就可以根据class 来唯一选择。

使用如下代码

from appium.webdriver.common.appiumby import AppiumBy

driver.find_element(
  AppiumBy.CLASS_NAME, 
  'android.widget.TextView')

根据ACCESSIBILITY ID

元素的 content-desc 属性是用来描述该元素的作用的。

如果要查询的界面元素有 content-desc属性,我们可以通过它来定位选择元素。

使用如下代码

from appium.webdriver.common.appiumby import AppiumBy

driver.find_element(AppiumBy.ACCESSIBILITY_ID, '找人')

Xpath

Appium 也支持通过 Xpath选择元素。

但是其可靠性和性能不如 Selenium Web自动化。因为Web自动化对Xpath的支持是由浏览器实现的,而Appium Xpath的支持是 Appium Server实现的。

毕竟,浏览器产品的成熟度比Appium要高很多。

当然,Xpath是标准语法,所以这里表达式的语法规则和 以前学习的Selenium里面Xpath的语法是一样的,比如

from appium.webdriver.common.appiumby import AppiumBy

driver.find_element(AppiumBy.XPATH, '//ele1/ele2[@attr="value"]')


注意:

selenium自动化中, xpath表达式中每个节点名是html的tagname。

但是在appium中, xpath表达式中 每个节点名 是元素的class属性值。

比如:要选择所有的文本节点,就使用如下代码

driver.find_element(AppiumBy.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 这个类里面的方法实现元素定位的,比如

from appium.webdriver.common.appiumby import AppiumBy


code = 'new UiSelector().text("热门").className("android.widget.TextView")'
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, code)
ele.click()

就是通过 text 属性 和 className的属性 两个条件 来定位元素。


UiSelector里面有些元素选择的方法 可以解决 前面解决不了的问题。

比如

  • text 方法

可以根据元素的文本属性查找元素

  • textContains

根据文本包含什么字符串

  • textStartsWith

根据文本以什么字符串开头

  • textmartch 方法

可以使用正则表达式 选择一些元素,如下

code = 'new UiSelector().textMatches("^我的.*")'


UiSelector 的 instanceindex 也可以用来定位元素,都是从0开始计数, 他们的区别:

  • instance是匹配的结果所有元素里面 的第几个元素

  • index则是其父元素的几个节点,类似xpath 里面的*[n]


UiSelector 的 childSelector 可以选择后代元素,比如

code = 'new UiSelector().resourceId("tv.danmaku.bili:id/recycler_view").childSelector(new UiSelector().className("android.widget.TextView"))'

ele = driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, code)

注意: childSelector后面的引号要框住整个 子 uiSelector 的表达式

目前有个bug:只能找到符合条件的第一个元素,参考appium 在github上的 issues:

https://github.com/appium/java-client/issues/150

您需要高效学习,找工作? 点击咨询 报名实战班

点击查看学员就业情况