基础动作模拟API
| | 返回 | API | 说明 |
|---|
| void | clear() | 清除编辑框中的内容 |
| void | click() | 点击一个对象 |
<R> R | clickAndWait(EventCondition<R> condition, long timeout) | 点击一个对象，然后等待在超时时间内条件成立则通过，否则抛出异常 |
| void | drag(Point dest, int speed) | 自定义速度拖拽一个对象到指定位置，速度：像素/秒 |
| void | drag(Point dest) | 拖拽一个对象到指定位置 |
| void | longClick() | 长时间点击对象 |
| boolean | scroll(Direction direction, float percent) | 滚动操作 |
| boolean | scroll(Direction direction, float percent, int speed) | 自定义速度的滚动操作 |
| void | setText(String text) | 设置文本内容 |
手势动作API
| | 返回 | API | 说明 |
|---|
| void | pinchClose(float percent, int speed) | 自定义速度关闭手势 |
| void | pinchOpen(float percent, int speed) | 自定义速度打开手势 |
| void | pinchOpen(float percent) | 打开手势 |
| boolean | fling(Direction direction) | 滑动手势 |
| boolean | fling(Direction direction, int speed) | 自定义速度滑动手势 |
| void | swipe(Direction direction, float percent, int speed) | 自定义速度滑动手势 |
| void | swipe(Direction direction, float percent) | 自滑动手势 |
组件属性API
| | 返回 | API | 说明 |
|---|
| String | getApplicationPackage() | 返回应用包名 |
| String | getClassName() | 返回对象类名 |
| String | getContentDescription() | 返回内容描述 |
| String | getResourceName() | 返回资源id |
| String | getText() | 返回文本 |
| Rect | getVisibleBounds() | 返回对象可见范围内的屏幕坐标 |
| Point | getVisibleCenter() | 返回可见范围的中心 |
| boolean | isCheckable() | 返回Checkable属性 |
| boolean | isChecked() | 返回Checked属性 |
| boolean | isClickable() | 返回Clickable属性 |
| boolean | isEnabled() | 返回Enabled属性 |
| boolean | isFocusable() | 返回Focusable属性 |
| boolean | isFocused() | 返回isFocused属性 |
| boolean | isLongClickable() | 返回LongClickable属性 |
| boolean | isScrollable() | 返回Scrollable属性 |
| boolean | isSelected() | 返回Selected属性 |
层级关系API
| | 返回 | API | 说明 |
|---|
| UiObject2 | findObject(BySelector selector) | 在该对象层级之下，返回第一个与条件匹配的对象 |
List<UiObject2> | findObjects(BySelector selector) | 在该对象层级之下，返回所有匹配的对象 |
List<UiObject2> | getChildren() | 返回该对象的所有子元素的集合 |
| UiObject2 | getParent() | 返回该对象的父元素 |
| int | getChildCount() | 返回该对象的直接子元素的数量 |
条件判断API
| | 返回 | API | 说明 |
|---|
| boolean | equals(Object object) | 比较两个对象是否相等 |
| int | hashCode() | 获取对象的hashCode |
| boolean | hasObject(BySelector selector) | 返回对象是否存在 |
<R> R | wait(UiObject2Condition<R> condition, long timeout) | 等待的条件得到满足 |
<R> R | wait(SearchCondition<R> condition, long timeout) | 等待的条件得到满足 |
示例代码：
package mqqzt.myuitest5;
import android.app.Instrumentation;
import android.graphics.Point;
import android.support.test.InstrumentationRegistry;
import android.support.test.runner.AndroidJUnit4;
import android.support.test.uiautomator.By;
import android.support.test.uiautomator.Direction;
import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiObject2;
import android.support.test.uiautomator.Until;
import android.util.Log;
import android.widget.ListView;
import android.widget.TextView;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import java.util.List;
/**
* Created by mqqzt-yang on 2015/11/22.
*/
@RunWith(AndroidJUnit4.class)
public class UiObject2Test {
UiDevice uiDevice;
Instrumentation instrumentation;
@Before
public void setUp(){
instrumentation = InstrumentationRegistry.getInstrumentation();
uiDevice = UiDevice.getInstance(instrumentation);
}
@Test
public void testSetText(){
UiObject2 mmsSendObject = uiDevice.findObject(By.res("com.android.mms:id/embedded_text_editor"));
mmsSendObject.setText("我的东西在哪里？");
sleep(1000);
mmsSendObject.clear();
}
@Test
public void testDrag(){
UiObject2 settingsObj = uiDevice.findObject(By.text("Settings"));
Point p = new Point();
p.x = 116;
p.y = 497;
settingsObj.drag(p, 500);
sleep(2000);
settingsObj.clickAndWait(Until.newWindow(), 5000);
}
@Test
public void testScroll(){
UiObject2 listViewObj = uiDevice.findObject(By.clazz(ListView.class));
listViewObj.scroll(Direction.DOWN, 0.8f, 500);
}
@Test
public void testPinch(){
UiObject2 viewObj = uiDevice.findObject(By.res("com.android.gallery3d:id/gl_root_view"));
viewObj.pinchClose(0.8f, 500);
sleep(2000);
viewObj.pinchOpen(0.8f, 500);
}
@Test
public void testFling(){
UiObject2 msg = uiDevice.findObject(By.res("com.android.contacts:id/message"));
msg.fling(Direction.LEFT, 500);
}
@Test
public void testSwipe(){
UiObject2 msg = uiDevice.findObject(By.res("com.android.contacts:id/message"));
msg.swipe(Direction.RIGHT, 0.8f, 500);
}
@Test
public void testWifiSwitch(){
UiObject2 wifiSwitchObj = uiDevice.findObject(By.res("com.android.settings:id/switch_widget"));
if(!wifiSwitchObj.isChecked()){
wifiSwitchObj.click();
}
}
@Test
public void testChild(){
UiObject2 listViewObj = uiDevice.findObject(By.clazz(ListView.class));
UiObject2 child = listViewObj.findObject(By.clazz(TextView.class));
Log.i("mqqzt", child.getText());
List<UiObject2> listChild = listViewObj.findObjects(By.clazz(TextView.class));
Log.i("mqqzt", listChild.size() + "");
for(UiObject2 uiObject2 : listChild){
Log.i("mqqzt", uiObject2.getText());
}
List<UiObject2> getChild = listViewObj.getChildren();
Log.i("mqqzt", getChild.size() + "");
for(UiObject2 uiObject2 : getChild){
Log.i("mqqzt", uiObject2.getClassName());
}
Log.i("mqqzt", listViewObj.getParent().getClassName());
Log.i("mqqzt", listViewObj.getChildCount() + "");
UiObject2 childEqual = listViewObj.findObject(By.text("Alarms"));
Log.i("mqqzt", child.equals(childEqual) + "");
Log.i("mqqzt", child.hasObject(By.text("Alarms")) + "");
Log.i("mqqzt", child.hasObject(By.text("Alarms12")) + "");
childEqual.recycle();
childEqual = listViewObj.findObject(By.text("Alarms"));
childEqual.click();
}
public void sleep(int sleep){
try {
Thread.sleep(sleep);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
