2.UiSelector API 详细介绍
一、UiSelector类介绍
//通过各种属性与节点关系定位组件 简单实例: public void testDemo2() throws UiObjectNotFoundException{ UiSelector l= new UiSelector().text("相机");//搜索条件 UiObject object=new UiObject(l);//一句搜索条件找到对象 object.click();//操作对象 }
二、Androiud的布局与组件及组件属性介绍
1.Android常用布局
Tables | Are |
---|---|
线性布局 | linearLayout |
表格布局 | TableLayout |
相对布局 | RelativelLayout |
帧布局 | FrameLayout |
网格布局 | GridLayout |
绝对布局 | AbsoluteLayout |
2.Android常用组件
//文本框、编辑框、按钮、单选按钮、复选框、状态开关按钮、拖动条等等
3.Android组件属性介绍
属性值 | 值类型 | 例子 |
---|---|---|
index | int | 0 |
instance | int | 5 |
class | String | android.widget.TextView |
package | String | com.jian.test |
Content desc | String | string |
checkable | boolean | false |
clecked | boolean | false |
clickable | boolean | true |
enabled | boolean | false |
focusable | boolean | false |
focused | boolean | false |
Scrollable | boolean | false |
Long-clickable | boolean | false |
password | boolean | false |
selected | boolean | false |
bounds | Rect | [366,999][708,1197] |
三、四种匹配关系的介绍
1.四种匹配关系介绍
完全匹配(默认)
包含匹配(Contains)
正则匹配(Matches)–可以包含完全匹配、包含匹配、起始匹配
起始匹配(StartWith)
2.例子
匹配字符串:0123456789
完全匹配:0123456789
包含匹配:45678
正则匹配:\d{10}
起始匹配:01234
四、节点关系介绍
五、对象搜索-文本与描述
1.文本属性定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | text(String text) | 文本 |
UiSelector | textContains(String text) | 文本包含 |
UiSelector | textMatches(String regex) | 文本正则 |
UiSelector | textStartsWith(String text) | 文本起始匹配 |
实例:
public void testDemo1() throws UiObjectNotFoundException{ //完全匹配:浏览器 UiSelector l1= new UiSelector().text("浏览器"); UiObject object1=new UiObject(l1); object1.click(); //包含匹配:览器 UiSelector l2= new UiSelector().textContains("览器"); UiObject object2=new UiObject(l2); object2.click(); //正则匹配:.*览.* UiSelector l3= new UiSelector().textMatches(".*览.*"); UiObject object3=new UiObject(l3); object3.click(); //起始匹配:浏览 UiSelector l4= new UiSelector().textStartsWith("浏览"); UiObject object4=new UiObject(l4); object4.click(); }
2.描述属性定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | description(String desc) | 描述 |
UiSelector | descriptionContains(String desc) | 描述包含 |
UiSelector | descriptionMatches(String regex) | 描述正则 |
UiSelector | descriptionStartsWith(String desc) | 描述开始字符匹配 |
实例:
public void testDesc() throws UiObjectNotFoundException{ //完全匹配:应用 UiSelector selector=new UiSelector().description("应用"); UiObject object=new UiObject(selector); object.click(); //包含匹配: UiSelector selector1=new UiSelector().descriptionContains("用"); UiObject object1=new UiObject(selector1); object1.click(); //正则匹配: UiSelector selector2=new UiSelector().descriptionMatches("应.*"); UiObject object2=new UiObject(selector2); object2.click(); //起始匹配: UiSelector selector3=new UiSelector().descriptionStartsWith("应"); UiObject object3=new UiObject(selector3); object3.click(); }
六、对象搜索-类名与包名
1.类名属性定位:
返回值 | API | 说明 |
---|---|---|
UiSelector | className(String className) | 类名 |
UiSelector | classNameMatches(String regex) | 正则类名 |
- 快速书写方式:
(1)class.getName(推荐书写方式)
(2)完整类名方式:android.widger.LinearLayout
(3)正则方式
(4)常量方式
例如:
public void testDemo2() throws UiObjectNotFoundException{ //完全匹配 UiSelector selector =new UiSelector().className("android.view.View") .instance(3);//instance(3)表示界面上从上到下第4-1个view UiObject object=new UiObject(selector); object.click(); //正则匹配 UiSelector selector =new UiSelector().classNameMatches(".*View") .instance(4);//instance(3)表示界面上从上到下第5-1个view UiObject object=new UiObject(selector); object.click(); //class.getName输入方式 UiSelector selector =new UiSelector().className(View.class.getName()) .instance(3);//instance(3)表示界面上从上到下第5-1个view UiObject object=new UiObject(selector); object.click(); }
2.包名属性定位
返回值 | API | 说明 |
---|---|---|
UiSelector | packageName(String name) | 包名 |
UiSelector | packageNameMatches(String regex) | 包名正则 |
例如:
public void testDemo3() throws UiObjectNotFoundException{ UiSelector selector =new UiSelector().packageName("com.android.deskclock"); UiObject object=new UiObject(selector); object.click(); }
七、对象搜索-索引与实例
1.索引与实例说明
1)索引index:指在同级中的编号,在兄弟类中的主键的编号
2)实例instance:整个布局文件中的编号,同一个类(比如6.2中的view类)的同级编号
2.索引与实例属性定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | index(int index) | 索引 |
UiSelector | instance(int instance) | 实例 |
例如:
public void testIndex() throws UiObjectNotFoundException{ //index UiSelector selector =new UiSelector().className("android.widget.ImageButton").index(1); UiObject object=new UiObject(selector); object.click(); UiDevice.getInstance().pressBack(); //instance UiSelector selector1 =new UiSelector().className("android.widget.ImageButton").instance(2); UiObject object1=new UiObject(selector1); object1.click(); }
八、对象搜索-特殊属性与节点
1.特殊属性定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | checked(booleean val) | 选择属性 |
UiSelector | clickable(boolean val) | 可点击属性 |
UiSelector | enabled(boolean val) | enabled属性 |
UiSelector | focusable(boolean val) | 焦点属性 |
UiSelector | focused(boolean val) | 当前焦点属性 |
UiSelector | longClickable(boolean val) | 长按属性 |
UiSelector | scrollable(boolean val) | 滚动属性 |
UiSelector | selected(boolean val) | 背景选择属性 |
例如:
public void testDemo4() throws UiObjectNotFoundException{ //checkable[开启wifi(界面默认在设置界面的情况下),由于有wifi和蓝牙两个可点击属性,instance定位] UiObject swtitichObj=new UiObject(new UiSelector().checkable(true).instance(0)); swtitichObj.click(); //checked[关闭了wifi(界面默认在设置界面的情况下)] UiObject swtitichObj=new UiObject(new UiSelector().checked(true).instance(0)); swtitichObj.click(); //enable[界面默认在无编辑的信息框,buttom为发送按钮] UiObject send=new UiObject(new UiSelector().enabled(false)); System.out.println(send.getClassName());//获取并输出这个属性的类名 //focused[在发送消息界面,光标默认停放位置在联系人或信息框] UiObject focusedObj=new UiObject(new UiSelector().focused(true)); focusedObj.setText("Jian");//输入字符"Jian" //longClickable[界面默认位置为桌面首页,多条件定位] UiObject longclick=new UiObject(new UiSelector().longClickable(true).index(4)); longclick.click(); //scrollable[界面默认位置为文件管理器界面] UiScrollable scrollable=new UiScrollable(new UiSelector().scrollable(true)); scrollable.scrollForward();//向下滚动一下 scrollable.scrollBackward();//向上滚动一下 }
2.节点属性定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | childSelector(UiSelector selector) | 从当前类中往下递归找符合条件的子类组件 |
UiSelector | formPrent(UiSelector selector) | 从父类往下递归找符合条件的组件 |
例如:
public void testDemo5() throws UiObjectNotFoundException{ //childSelector[界面停留在文件管理界面]例一: UiScrollable scrollable=new UiScrollable(new UiSelector().scrollable(true) .childSelector(new UiSelector().text("Android"))); scrollable.click(); //childSelector[界面停留在文件管理界面]例二: UiObject focusedObj=new UiObject(new UiSelector().childSelector(new UiSelector().text("Android"))); focusedObj.click(); //formPrent[界面停留在文件管理界面]先定位父类再定位主类 UiObject PrentObj=new UiObject(new UiSelector() .resourceId("com.cyanogenmod.filemanager:id/navigation_view_details_item") .fromParent(new UiSelector().className("android.widget.LinearLayout").index(1)));//先定位父类再定位主类 PrentObj.click(); }
九、对象搜索-资源ID(推荐使用)
1.资源ID说明
1)资源ID属性:
每一个组件都会的编号,也就是资源ID
2)对应Android属性:
XML文件下的Android:ID属性
2.资源ID定位对象
返回值 | API | 说明 |
---|---|---|
UiSelector | resourceId(String id) | 资源ID |
UiSelector | resourceIdMatches(String regex) | 资源ID正则 |
例如:
public void testDemo6() throws UiObjectNotFoundException{ //resourceId(String id) //定位不同ID的组件 UiObject resoursId=new UiObject(new UiSelector().resourceId("com.cyanogenmod.filemanager:id/ab_filesystem_info")); resoursId.click(); //定位相同ID的组件 UiObject resoursId1=new UiObject(new UiSelector() .resourceId("com.cyanogenmod.filemanager:id/navigation_view_details_item") .index(3));//通过增加多个条件来定位(这里使用index) resoursId1.click(); //resourceIdMatches(String regex) UiObject resoursId2=new UiObject(new UiSelector().resourceIdMatches(".*/navigation_view_details_item").index(3)); resoursId2.click(); }
- 本文为博主学习笔记,未经博主允许不得转载
- 本文仅供交流学习,请勿用于非法途径
- 本文仅是个人意见,如有想法,欢迎交流