跳转至

定位元素

代码规则

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

从示例代码，大家就可以发现，和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 属性

使用如下代码

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 的 instance 和 index 也可以用来定位元素，都是从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

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

点击查看学员就业情况