Java UIAutomator 选元素

前面我们学习的选择 界面元素的方式，根据 id，classname， accessibilityid，xpath，这些方法，其实底层都是利用了 uiautomator 的 API功能实现的，我们来看一下安卓官网是如何描述 uiautomator 的 API 的：https://developer.android.google.cn/training/testing/ui-automator

• UI Automator 测试框架提供了一组 API 来构建用于在用户应用程序和系统应用程序上执行交互的 UI 测试。UI Automator API 允许您执行操作，例如打开测试设备中的“设置”菜单或应用程序启动器。UI Automator 测试框架非常适合编写黑盒式自动化测试，其中测试代码不依赖于目标应用程序的内部实现细节。

---

• UI Automator 测试框架的主要功能包括：

1. 用于检查布局层次结构的查看器（就是UIAutomatorviewer）。如需了解详细信息，请参阅 UI Automator 查看器。

2. 在目标设备上检索状态信息并执行操作的 API（指对设备进行各种操作的API，我们要知道，所谓API就是库的编程接口）。如需了解详细信息，请参阅访问设备状态。

这些操作，大都可通过 appium 的 webdriver 的方法实现

3. 支持跨应用 UI 测试的 API(这个就是选择和操作界面元素的API)。如需了解详细信息，请参阅 UI Automator API。

---

利用 UI Automator API，您可以编写稳健可靠的测试，而无需了解 app 的实现详情。您可以使用这些 API 在多个应用中捕获（就是选择）和操作 UI 组件，这些 API 主要是通过下面这些类来实现的：
UiCollection UiObject UiScrollable UiSelector Configurator 其中 UiSelector 是我们 appium 自动化代码选择元素的时候，直接使用的 。UiObject 是选择到的元素对象。

UiSelector： UiSelector 类就是用来选择的 web 元素的。

我们 appium 自动化程序里面 driver.select_element_by_xxx,，发给到手机上的‘木马’(这里所指的木马，就是我们初次运行自动化程序安装的apk)时， 转换为相应的这个 UiSelector 调用。打开链接到 UiSelector类 ：https://developer.android.google.cn/reference/androidx/test/uiautomator/UiDevice

刚才说我们前面的根据 id，classname， accessibility id，xpath 其实底层都是利用了 uiautomator 的这个 selecotor 功能实现的。比如，我们要根据 classname 查询， appium server 就发送类似 findbyclassname：android.widget.Button 的命令给 木马 程序，里面会调用下面的方法。

image.png

根据id呢？对应 resourceId 方法，根据 accessibilityid呢？对应description 方法。根据 xpath 呢？ UIAutomator API 里面没有直接对应的方法，这是appium 自己分析 xpath 的表达式计算的， 比如 //*[@resource-id='abc']，就调用 resourceId 方法。

最终都是通过 这个UI Automator API实现的。

所以如果我们能直接使用调用 UI Automator API 的代码，就可以实现最为直接的控制。所以，appium 确实也提供了这样的方法， 可以直接发送 java 代码 字符串给‘木马’，‘木马’ 会在 在手机上直接执行这些代码,这样我们可以精确的使用底层的方法选择界面元素。

根据class name 和text属性

比如，上次 开发者头条的应用 我们想点击 我的 按钮，UIAutomatorviewer 查看属性可以利用它的文本值为我的， class 为 android.widget.TextView，

code = 'new UiSelector().text("我的").className("android.widget.TextView")'
ele = driver.find_element_by_android_uiautomator(code)

ele.click()

如果只根据文本这样写就可以了：

code = 'new UiSelector().text("我的")'
ele = driver.find_element_by_android_uiautomator(code)

ele.click()

根据 resource-id 属性

code = 'new UiSelector().resourceId("io.manong.developerdaily:id/tab_bar")'
ele = driver.find_element_by_android_uiautomator(code)

注意区大小写。UiSelector 里面有些元素选择的方法是以前所不具备的，比如根据 正则表达式搜索文本，就是其它方法不支持的。

childSelector 和 Instance

像 xpath 这种 // 表示后代关系的， UIAutomator 通过 childSelector 和 instance ，index 来实现。打开文档查看：https://developer.android.google.cn/reference/androidx/test/uiautomator/UiSelector.html#childSelector(androidx.test.uiautomator.UiSelector)

image.png

childSelector 用来选择后代元素（可以是非直接子元素）。

instance 和 index的区别：

选择第几个元素可以使用 instance 和 index ：

image.png

instance 和 index 都是从0开始计数，但是：其中instance是匹配的结果所有元素里面 的第几个元素而 index 则是其父元素的几个节点，类似 xpath 里面的 *[n]

上一个章节我们讲到开发者头条的我的 ，我们是这样写的

//*[@resource-id='io.manong.developerdaily:id/tab_bar']//android.widget.RelativeLayout[4]

所以开发者头条里面的我的，是下面整个 tab bar 的后代元素，可以这样

code = 'new UiSelector().resourceId("io.manong.developerdaily:id/tab_bar").childSelector(new UiSelector().className("android.widget.TextView").instance(3))'
ele = driver.find_element_by_android_uiautomator(code)
print(ele.text)
ele.click()