一、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")));

 

上面这段代码是一个场景

UiAutomator笔记之UiSelector API(三)

 

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

UiAutomator笔记之UiSelector API(三)

 

那段代码的思路是,使用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"));

相关文章: