UiAutomator笔记之UiSelector API（三）

一、UiSelector相关知识

1、UiSelector功能
UiSelector可通过控件的各种属性与节点关系定位组件。

2、Android常用组件

TextView 文本框

EditView 编辑框

Button 按钮

RadioButton 单选按钮

CheckBox 复选框

ToggleButton 状态开关按钮

Switch 开关

SeekBar 拖动条

AnalogClock DigitalClock 时钟

Chronometer 计时器

ListView 列表视图

GridView 网格视图

ProgressBar 进度条

RatingBra 星际评分条

Toast 提示信息框
ScrollView 滚动视图

3、Android组件的属性

属性值	值类型	说明
index	int	索引：同级组件的下标；从0开始计
instance	int	界面中同一类View的所有实例的下标；从0开始计
class	String	组件的类名，如 android.widget.TextView
package	String	包名
Content-desc	String	描述
checkable	boolean	是否可选，一般只对 单选或 复选框有用。
checked	boolean	单选或 复选框 是否被选中
clickable	boolean	是否可点击
enabled	boolean	是否可操作，如 按钮置灰不可操作状态
focusable	boolean	是否可获取焦点
focused	boolean	是否获取到焦点
Scrollable	boolean	是否可滚动，一般是list
Long-clickable	boolean	是否可长按
password	boolean	是否密码
selected	boolean	是否具有背景选择属性，如按钮点击后背景色变化
bounds	Rect	坐标，如 [366,999][708,1197]表示控件的矩形区域左上和右下坐标点

4、查找组件的匹配方式（4种）
（1）默认：完全匹配
（2）Contains:包含匹配
（3）StartsWith:起始匹配
（4）Matches:正则匹配（完全匹配、包含匹配、起始匹配）

5、XML文档节点关系
（1）父 Patent:父控件
（2）子 Children:子控件
（3）同胞 Sibling：同级控件
（4）先辈 Ancestor:父控件的上一级、上上级...
（5）后代 Descendant:子控件的下一级、下下级...

二、依据属性查找组件

1、 属性-文本

（1）相关API

返回值	API	说明
UiSelector	text(String text)	文本
UiSelector	textContains(String text)	文本包含
UiSelector	textMatches(String regex)	文本正则
UiSelector	textStartsWith(String text)	文本起始匹配

（2）示例
UiSelector uiSelector = new UiSelector().text("微信红包");//查找文本为“微信红包”的所有组件

2、 属性-描述

（1）相关API

返回值	API	说明
UiSelector	description(String desc)	描述
UiSelector	descriptionContains(String desc)	描述包含
UiSelector	descriptionMatches(String regex)	描述正则
UiSelector	descriptionStartsWith(String desc)	描述开始字符匹配

3、属性-类名

（1）相关API

返回值	API	说明
UiSelector	className(String className)	类名
UiSelector	classNameMatches(String regex)	正则类名

（2）输入参数className的快速书写方式

<1>class.getName方式
<2>完整类名方式：android.widget.LinearLayout
<3>正则方式
<4>常量方式

4、 属性-包名

（1）相关API

返回值	API	说明
UiSelector	packageName(String name)	包名
UiSelector	packageNameMatches(String regex)	包名正则

5、属性-索引与实例

（1）相关API

返回值	API	说明
UiSelector	index(int index)	索引
UiSelector	instance(int instance)	实例

（2）示例

UiSelector uiSelector = new UiSelector().className("android.widget.ImagView").index(1);//查找ImageView在同级中下标为1的组件

UiSelector uiSelector = new UiSelector().text("微信红包").instance(2);//查找界面中文本为“微信红包”的第3个组件

6、特殊属性

（1）相关API

返回值	API	说明
UiSelector	checked(boolean val)	选择属性
UiSelector	clickable(boolean val)	可点击属性
UiSelector	enabled(boolean val)	可操作属性
UiSelector	focusable(boolean val)	焦点属性
UiSelector	focused(boolean val)	当前焦点属性
UiSelector	longClickable(boolean val)	长按属性
UiSelector	scrollable(boolean val)	滚动属性
UiSelector	selected(boolean val)	背景选择属性

7、节点

（1）相关API

返回值	API	说明
UiSelector	childSelector(UiSelector selector)	从当前组件往下查找其子子孙孙中符合条件的所有组件
UiSelector	fromParent(UiSelector selector)	从当前组件往上查找其长辈中符合条件的所有组件

8、 属性-资源ID

（1）相关API

返回值	API	说明
UiSelector	resourceId(String id)	资源ID
UiSelector	resourceIdMatches(String regex)	资源ID正则

（2）说明

android4.3及以上系统才可通过资源ID的方式定位控件。

 

通过伪xpath定位：

 UISelector类提供了一些方法根据控件在界面的XML布局中的层级关系来进行定位，但是UIAutomator又没有真正的提供类似Appium的findElementWithXpath相关的方法，所以这个位置我们叫它伪xpath,其实就是通过层级一层一层去定位控件，通常用于Listview中定位id相同的控件

 

UiSelector.fromParent或UiObject.getFromParent方法

例：UiObject uio=new UiObject(new UiSelector().text("Cache junk").fromParent(new UiSelector().className("android.widget.CheckBox")));

 

上面这段代码是一个场景

 

这是一个android里面常见的listview,它里面有很多的layout,可是如果我只想获取到cache junk这一条目中的checkbox，又没有id,index又不固定的情况下，怎么办呢，就使用上面那段代码,以下是UI和层级关系

 

那段代码的思路是，使用text定位cache junk这个UI中的唯一性控件，然后.fromParent定位到cache junk控件的父控件，就是index为1的那个RelativeLayout控件，再在RelativeLayout控件中通过classname定位这个layout中的唯一一个checkbox控件，大家可以想一下这个思路，你小儿子踢足球把我家玻璃打碎了，逃逸了，我认识你大儿子，我通过你大儿子找到你爸爸，再通过你爸爸找到小儿子，揍一顿~

 

通过UiSelector.childSelector或UiObject.getChild方法

刚才是一个通过孩子找父亲再找兄弟的思路，那么这个方法就是我知道你爸爸是谁，我直接通过你爸爸找到儿子

例：UiObject parentView = new UiObject(new UiSelector().className("android.view.View"));

      save = parentView.getChild(new UiSelector().text("Save"));