Appium自动化（5）- 高级元素定位方式之 UI Automator API
高级元素定位方式之 UI Automator API
前面介绍过根据id，classname， accessibilityid，xpath来定位元素，其他这些方法底层都是利用了 UI Automator 的 API 功能实现的
UI Automator 介绍
- UI Automator 测试框架提供了一组 API 来构建 UI 测试，用于在用户应用和系统应用中执行交互
- 利用 UI Automator API，可以打开“设置”菜单或应用启动器等操作
- UI Automator 测试框架非常适合编写黑盒自动化测试，其中的测试代码不依赖于目标应用的内部
UI Automator 提供的功能
- 自带的元素定位工具
- 在设备上检索状态信息并执行操作的API
- 支持跨应用 UI 测试的API
UI Automator 访问设备状态
UI Automator 测试框架提供了一个 UiDevice 类，用于在 app 运行的设备上进行访问和执行等操作，它提供了以下操作
- 更改设备旋转
- 按D-pad按钮
- 按返回、主屏幕、菜单按钮
- 打开通知栏
- 对当前窗口进行屏幕截图
更多的 UI Automator API
利用 UI Automator API，可以编写稳健可靠的测试，而无需了解目标应用的实现详情
下面将列出常见的类，它们都是在 android.support.test.uiautomator 这个库下的
| 类 | 类名 | 作用 |
|---|---|---|
| UiDevice | 设备封装类 | 上面说到的，获取设备信息和设备交互 |
| UiObject | 所有空间抽象类 | 表示设备上可见的一个Android控件 |
| UiSelector | 控制选择器 | 在设备上查询一个或多个目标 UI 元素 |
| Configurator | 配置基类 | 设置运行 UI Automator 测试所需的关键参数 |
| UiScrollable | 滚动控件 | 当目标控件存在于屏幕之外时使用 |
| UiCollection | 控件集合 | 控件遍历，枚举容器的 UI 元素以便计算子元素个数 |
- 其中
UiSelector在 appium 自动化代码选择元素时候直接使用到的 - 用来生成一个定位器来选择界面中的控件元素，可以通过text,content-desc,class,和一些状态信息来进行条件过滤
UiSelector类似于 appium中find_element_by_xxx()方法中函数值- UiSelector官方文档：https://developer.android.google.cn/reference/android/support/test/uiautomator/UiSelector
UiSelector 初体验
java语法
new UiSelector().resourceId(“io.manong.developerdaily:id/tv_tab_title”)
结合 Appium 的用法
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.hpbr.bosszhipin:id/tv_tab_label")')
# 此处省略配置代码...
# 通过resourceId
test = driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.hpbr.bosszhipin:id/tv_tab_label")')
print(test.text)
# 通过text
test = driver.find_element_by_android_uiautomator('new UiSelector().text("附近")')
print(test.text)
# 通过className
test = driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.TextView")')
print(test.text)
UiSelector 还可以通过哪些方法来定位元素
| 方法名 | 作用 |
|---|---|
| className(String className) | 根据class名称 |
| classNameMatches(String regex) | 根据class名称的正则表达式 |
| description(String desc) | 根据content-desc |
| descriptionContains(String desc) | 根据content-desc中包含的字符串 |
| text(String text) | 根据文本值text |
| textContains(String text) | 根据文本值text包含的字符串 |
| resourceId(String id) | 根据resource-id |
基本上除了xpath之外，可以通过appium实现的元素定位方式，UIAutomator也有，因为底层就是靠他实现的
xpath 虽然没有直接对应的方法，但是像下面这种 xpath 写法，UIAutomator 也有对应的方法
- // ：表示任意后代关系
- x[n] ： 表示第几个子节点
| 方法名 | 对应xpath的语法 | 作用 |
|---|---|---|
| childSelector(UiSelector selector) | // | 用来选择后代元素（可以是非直接子元素），对应// |
| index(int index) | *[n] | index表示其父元素下的第几个节点 |
| instance(int instance) | 无 | 匹配的结果所有元素里面的第几个元素 比如通过 // android.widget.TextView 找到了十个对应类型的元素，instance(1) 表示第二个对应的元素，下标是从0开始的 |
# 正常appium写法
test = driver.find_elements_by_id("com.hpbr.bosszhipin:id/tv_tab_label")[1]
# 结合uiautomator写法
test = driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.hpbr.bosszhipin:id/tv_tab_label").enabled(true).instance(1)')
