UI Automator 常用 API 整理
2018-07-10 22:34 虫师 阅读(8583) 评论(1) 编辑 收藏 举报主要类:
import android.support.test.uiautomator.UiDevice;
作用:设备封装类,测试过程中获取设备信息和设备交互。
import android.support.test.uiautomator.UiObject;
作用:所有控件抽象,用于表示一个Android控件。
import android.support.test.uiautomator.UiObjectNotFoundException;
作用:异常处理机制,在预期控件不存在时抛出。
import android.support.test.uiautomator.UiSelector;
作用:控制选择器,利用控制属性描述目标控件,用于控件匹配使用。
import android.support.test.uiautomator.Configurator;
所用:配置基类,用以控制测试过程的事件等超时、控件可见超时等。
import android.support.test.uiautomator.UiCollection;
作用:控件集合,用于控件遍历。
import android.support.test.uiautomator.UiScrollable;
作用:滚动控件,当目标控件存在于屏幕之外时使用。
import android.support.test.uiautomator.UiWatcher;
作用:界面观察者,用于处理弹窗中断逻辑。
### 定位控件 ```Java import android.support.test.uiautomator.By; 作用:可以更简洁的方式使用ByScelector 选择器。 用法: findObject(By.text(“text”))
import android.support.test.uiautomator.BySelector;
作用: BySelector 调用findObject 时匹配UI 元素
用法:
findObject(new BySelector().text(“text”))
<br>
### By类常用定位方法
```Java
/**
* 通过文本 text 定位控件
* 例如: text = "hello world"
*/
device.findObject(By.text("text"));
device.findObject(By.textContains("llo wor"));
device.findObject(By.textStartsWith("hello"));
device.findObject(By.textEndsWith("world"));
/**
* 通过内容描述 content-dec 定位控件
* 例如: desc = "content-dec"
*/
device.findObject(By.desc("content-dec"));
device.findObject(By.descContains("tent"));
device.findObject(By.descStartsWith("content"));
device.findObject(By.descEndsWith("-dec"));
/**
* 通过包名package定位控件
* 例如: package = "com.android.calculator2"
*/
device.findObject(By.pkg("com.android.calculator2"));
/**
* 通过资源名 resource 定位控件
* 例如: resource = "com.android.calculator2:id/digit_0"
*/
device.findObject(By.res("com.android.calculator2:id/digit_0"));
/**
* 通过类名 class定位控件
* 例如: class = "android.widget.Button"
*/
device.findObject(By.clazz("android.widget.Button"));
### UiDevice类常用方法
// home键
device.pressHome();
// back 键
device.pressBack();
// 显示最近打开并置于后台的App
device.pressRecentApps();
// 快速设置键
device.openQuickSettings();
// 打开通知
device.openNotification();
// 虚拟键盘,参考appium
device.pressKeyCode(17);
// 获得屏幕高度和宽度
int x = device.getDisplayWidth();
int y = device.getDisplayHeight();
String xs =String.valueOf(x);
String ys =String.valueOf(y);
Log.e("xxxxxxxxxx", xs);
Log.e("yyyyyyyyyy", ys);
// 向下滑显示通知栏
device.swipe(200,0,200, 300,180);
// 向左滑显示右一屏
device.swipe(20,400,460, 400,180);
// 获取当前应用活动名 和 包名
String activity = device.getCurrentActivityName();
String packagea = device.getCurrentPackageName();
Log.e("activity", activity);
Log.e("packagea", packagea);
// 休眠屏幕
device.sleep();
// 如果屏幕熄灭,点亮
device.wakeUp();
### UiObject2类常用方法
UiObject2 element = device.findObject(By.text("text"));
//清除元素,针对输入框
element.clear();
// 点击
element.click();
// 长按
element.longClick();
// 获取元素文本
element.getText();
//设置元素文本,相当于输入
element.setText("new text");
//获取元素scrollable属性,判断是否可滚动
element.isScrollable();
// 判断两个对象是否一致
UiObject2 element2 = device.findObject(By.text("text"));
element.equals(element2);
//获取元素content_desc属性
element.getContentDescription();
// 获取包名 package 属性
element.getApplicationPackage();
// 获取元素的子元素集合
element.getChildren();
// 获取元素的子元素的个数
element.getChildCount();
// 获取元素的class属性
element.getClassName();
// 获取元素的 resource-id 属性
element.getResourceName();
// 将元素拖动到指定位置
Point desPoint = new Point();
desPoint.x = 200;
desPoint.y = 20;
element.drag(desPoint, 2000);
// 点击并等待新窗口
element.clickAndWait(Until.newWindow(), 2000);
###Configurator类
Configurator configurator = Configurator.getInstance();
//动作,设置延时, 默认3s
configurator.setActionAcknowledgmentTimeout(1000);
//键盘输入,设置延时,默认0s
configurator.setKeyInjectionDelay(1500);
// 滚动,设置延时, 默认200ms
configurator.setScrollAcknowledgmentTimeout(2000);
// 空闲,设置延时,默认10s
configurator.setWaitForIdleTimeout(2500);
// 组件查找, 设置延时, 默认10s
configurator.setWaitForSelectorTimeout(3000);
###UiWatcher 类用法
final UiObject2 ui = mDevice.findObject(By.text("Messenger"));
//注册监听器
mDevice.registerWatcher("testWatcher", new UiWatcher() {
@Override
public boolean checkForCondition() {
if(mDevice.hasObject(By.text("Contact"))){
ui.click();
Log.i("testWatcher", "监听器被触发了");
return true;
}
Log.i("testWatcher", "监听器未被触发");
return false;
}
});
//重置监听器
mDevice.resetWatcherTriggers();
//移除监听器
mDevice.removeWatcher("testWatcher");
//运行所有的监听器
mDevice.runWatchers();
###UiScrollable 类的常用方法
UiScrollable scroll = new UiScrollable( new UiSelector()
.scrollable(true));
// 以步长为5快速向后滑动
scroll.flingBackward();
//以步长为5快速向前滑动
scroll.flingForward();
// 是否允许滚动获取具备UiSelector条件元素集合后, 再以text属性的查找对象
scroll.getChildByText(
new UiSelector().resourceId("android:id/title"), "About emulated device", true);
// 是否允许滚动获取具备UiSelector条件元素集合后, 再以content-desc属性搜索子元素
scroll.getChildByDescription(new UiSelector().text("text"), "content-desc", true);
//通过实例查找子元素,资源id为"android:id/title"下的第1个实例
scroll.getChildByInstance(new UiSelector().resourceId("android:id/title"),0);
// 获取执行搜索滑动过程中的最大滑动次数,默认常量为30
scroll.getMaxSearchSwipes();
//设置最大可扫动次数
scroll.setMaxSearchSwipes(50);
/**
* 设置listview校准常量为0.15,即距离listview顶部15%和底部15%的区域不可滑动,只有控件中部70%的区域可滑动。
* 当校准常量设置为0.5时,控件的可滑动区域为0,滑动的动作效果将和单击的效果一样。
*/
scroll.setSwipeDeadZonePercentage(0.15);
// 获得校准常量,校准常量默认值为0.1(10%)
scroll.getSwipeDeadZonePercentage();
//设置滚动方向设置为水平滚动
scroll.setAsHorizontalList();
// 设置滚动方向设置为纵向滚动
scroll.setAsVerticalList();
// 滚动到某个元素上
scroll.scrollIntoView(new UiSelector().text("abc"));
//滚动到文本对象所在位置
scroll.scrollTextIntoView("abc");
//自定义最大滚动次数,滚动到开始/结束位置
scroll.scrollToBeginning(30);
scroll.scrollToEnd(30);
//以步长(速率)5滚动到列表底部,最多滚动10次。
scroll.scrollToEnd(10, 5);
### UiCollection 类的常用方法
UiCollection coll = new UiScrollable(new UiSelector()
.resourceId("android:id/title"));
// 查找元素下面子元素的数量
coll.getChildCount();
// 获取元素集合,再以text属性的查找对象
coll.getChildByText(new UiSelector().text("Display"), "Display");
// 获取元素集合,再查找其下面第1个元素
coll.getChildByInstance(new UiSelector().text("Display"), 0);
// 获取元素集合,再以content_desc属性的查找对象
coll.getChildByDescription(new UiSelector().text("Display"), "content_desc");
// 获得指定的子元素
coll.getChild(new UiSelector().text("aaa"));