Uiautomator 2.0

1. InstrumentationRegistry类

1.1. 类说明：

一个暴露的注册实例，持有instrumentation运行的进程和参数，还提供了一种简便的方法调用instrumentation, application context和instrumentation参数。

1.2 相关API

返回类型	API
static Bundle	getArguments(): 返回一个instrumentation参数副本
static Context	getContext():  返回instrumentation对应包的Context
static Instrumentation	getInstrumentation(): 返回当前运行的instrumentation
static Context	getTargetContext(): 返回一个目标应用程序的Context
static void	registerInstance(Instrumentation instrumentation, Bundle arguments):记录或暴露当前instrumentation运行和instrumentation参数包的副本，存储在注册中心

1.3 简单示例

1.3.1 

package com.test.auto.hellouiautomator;  
  
import android.app.Instrumentation;  
import android.content.Context;  
import android.content.Intent;  
import android.net.Uri;  
import android.os.Bundle;  
import android.support.test.InstrumentationRegistry;  
import android.support.test.runner.AndroidJUnit4;  
import android.support.test.uiautomator.UiDevice;  
  
import org.junit.Before;  
import org.junit.Test;  
import org.junit.runner.RunWith;  
  
import java.io.IOException;  
  
/** 
 * Created by auto on 16/3/3. 
 */  
  
@RunWith(AndroidJUnit4.class)  
public class TestClass01 {  
    public UiDevice mDevice;  
    public Instrumentation instrumentation;  
  
    @Before  
    public void setUp(){  
        instrumentation = InstrumentationRegistry.getInstrumentation();  
        mDevice = UiDevice.getInstance(instrumentation);  
    }  
  
    @Test  
    public void testCase01() throws IOException {  
        //获取运行时的参数  
        Bundle args = InstrumentationRegistry.getArguments();  
        //输出到运行报告中  
        instrumentation.sendStatus(100, args);  
  
        //获取测试包的Context  
        Context testContext = InstrumentationRegistry.getContext();  
        //获取被测应用的Context  
        Context testedContext = InstrumentationRegistry.getTargetContext();  
  
        //通过Context来启动一个Activity,e.g.浏览器  
        String url = "https://www.baidu.com";  
        Intent i1 = new Intent(Intent.ACTION_VIEW);  
        i1.setData(Uri.parse(url));  
        i1.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
        testContext.startActivity(i1);  
          
        //通过目标Context来启动拨号功能  
        Intent i2 = new Intent(Intent.ACTION_CALL,Uri.parse("tel:" + 10086));  
        i2.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
        testedContext.startActivity(i2);  
          
        Bundle inputBundle = new Bundle();  
        inputBundle.putString("key", "value");  
        //注入一个Bundle  
        InstrumentationRegistry.registerInstance(instrumentation, inputBundle);  
        //获取运行参数  
        Bundle outBundle = InstrumentationRegistry.getArguments();  
        //输出到结果报告中  
        instrumentation.sendStatus(110,outBundle);  
  
  
    }  
  
}  

　　

1.3.2 运行结果

am instrument -w -r -e test 123 com.test.auto.hellouiautomator

2. UiDevice新增API

2.1 API 介绍

返回类型	API
void	dumpWindowHierarchy(OutPutStream out): 获取当前页面层级到输出流
String	executeShellCommand(String cmd): 执行一个shell命令。备注：此方法只支持api21以上，手机需要5.0系统以上
UiObject2	findObject(BySelector selector): 返回第一个匹配条件的对象
UiObject	findObject(UiSelector selector): 返回一个匹配条件的代表视图的UiObject对象
List<UiObject2>	findObjects(BySelector selector): 返回所有匹配条件的对象
<R> R	wait(SearchCondition<R> condition, long timeout): 等待的条件得到满足

2.2 代码示例

package com.test.auto.hellouiautomator;  
  
import android.app.Instrumentation;  
import android.os.Bundle;  
import android.os.Environment;  
import android.support.test.InstrumentationRegistry;  
import android.support.test.runner.AndroidJUnit4;  
import android.support.test.uiautomator.By;  
import android.support.test.uiautomator.UiDevice;  
import android.support.test.uiautomator.UiObject;  
import android.support.test.uiautomator.UiObject2;  
import android.support.test.uiautomator.UiObjectNotFoundException;  
import android.support.test.uiautomator.UiSelector;  
import android.support.test.uiautomator.Until;  
import android.widget.TextView;  
  
import org.junit.Before;  
import org.junit.Test;  
import org.junit.runner.RunWith;  
  
import java.io.File;  
import java.io.FileOutputStream;  
import java.io.IOException;  
import java.io.OutputStream;  
import java.util.List;  
  
/** 
 * Created by auto on 16/3/3. 
 */  
  
@RunWith(AndroidJUnit4.class)  
public class TestClass01 {  
    public UiDevice mDevice;  
    public Instrumentation instrumentation;  
  
    @Before  
    public void setUp(){  
        instrumentation = InstrumentationRegistry.getInstrumentation();  
        mDevice = UiDevice.getInstance(instrumentation);  
    }  
  
    @Test  
    public void testCase01() throws IOException, UiObjectNotFoundException {  
  
        //dumpWindowHierarchy(OutPutStream out)  
        File file = new File(Environment.getExternalStorageDirectory()+File.separator+"dump.xml");  
        if(file.exists()){  
            file.delete();  
        }  
        file.createNewFile();  
        OutputStream outputStream = new FileOutputStream(file);  
        mDevice.dumpWindowHierarchy(outputStream);  
  
        //executeShellCommand(String cmd)  
        mDevice.executeShellCommand("am start -n com.tencent.mobileqq/.activity.SplashActivity ");  
  
        //findObject(BySelector selector)  
        mDevice.wait(Until.findObject(By.text("联系人")),2000);  
        UiObject2 uiObject2 = mDevice.findObject(By.text("联系人"));  
        uiObject2.click();  
  
        //findObject(UiSelector selector)  
        UiObject uiObject = mDevice.findObject(new UiSelector().text("短信"));  
        uiObject.click();  
  
        //findObjects(BySelector selector)  
        List <UiObject2> uiObject21 = mDevice.findObjects(By.clazz(TextView.class));  
        Bundle bundle = new Bundle();  
        for (UiObject2 a:uiObject21) {  
            bundle.putString("TextView", a.getText());  
        }  
        instrumentation.sendStatus(123,bundle);  
  
  
    }  
  
}  

　　

　　2  UiAutomator2 - UiObject2 

  

 

3 UiObject2 API

 

返回	API [ 基础动作 ]	说明
void	clear()	清除编辑框里的内容
void	click()	点击一个对象
<R> R	clickAndWait(EventCondition<R> condition, long timeout)	点击一个对象然后等待在超时时间内条件成立则通过，否则抛出异常
void	drag(Point dest)	拖拽这个对象到指定位置
void	drag(Point dest, int speed)	自定义速度拖拽这个对象到指定位置,速度：像素数/秒
void	longClick()	执行一个长时间点击这个对象动作
boolean	scroll(Direction direction, float percent)	对该对象执行一个滚动动作
boolean	scroll(Direction direction, float percent, int speed)	自定义滚动速度对该对象执行一个滚动动作
void	legacySetText(java.lang.String text)	设置文本内容通过发送keycode
void	setText(java.lang.String text)	设置文本内容如果这个对象是一个可编辑的字段
返回	API [ 手势 ]	说明
void	pinchClose(float percent)	对该对象执行关闭手势
void	pinchClose(float percent, int speed)	自定义速度对该对象执行关闭手势
void	pinchOpen(float percent)	对该对象执行打开手势
void	pinchOpen(float percent, int speed)	自定义速度对该对象执行打开手势
boolean	fling(Direction direction)	对该对象执行一个滑动的手势,Direction代表从哪个方向作为起点
boolean	fling(Direction direction, int speed)	自定义速度对对象执行一个滑动的手势
void	swipe(Direction direction, float percent)	执行一个滑动手势
void	swipe(Direction direction, float percent, int speed)	执行一个滑动手势，可定义滑动速度
void	setGestureMargin(int margin)	以像素为单位设置边缘用于手势
void	setGestureMargins(int left, int top, int right, int bottom)	以像素为单位设置边缘用于手势
返回	API [ 获取属性 ]	说明
String	getApplicationPackage()	返回应用程序的包名称
String	getClassName()	返回对象的类名称
String	getContentDescription()	返回该对象的内容描述
String	getResourceName()	返回这个对象的完全限定的资源名的id
String	getText()	返回此对象的文本值
Rect	getVisibleBounds()	返回该对象的可见范围在屏幕坐标
Point	getVisibleCenter()	返回一个指向这个对象的可见范围的中心
返回	API [ 属性判断 ]	说明
boolean	isCheckable()	返回此对象是否具有checkable属性
boolean	isChecked()	返回此对象是否具有checked属性
boolean	isClickable()	返回此对象是否具有clickable属性
boolean	isEnabled()	返回此对象是否具有enabled属性
boolean	isFocusable()	返回此对象是否具有focusable属性
boolean	isFocused()	返回此对象是否具有focused属性
boolean	isLongClickable()	返回此对象是否具有longclickable属性
boolean	isScrollable()	返回此对象是否具有scrollable属性
boolean	isSelected()	返回此对象是否具有selected属性
返回	API [ 获取子元素 ]	说明
UiObject2	findObject(BySelector selector)	搜索所有的元素在这个对象层级之下,并返回第一个对象与搜索条件相匹配
List<UiObject2>	findObjects(BySelector selector)	搜索所有的元素在这个对象层级之下,并返回所有对象与搜索条件相匹配
List<UiObject2>	getChildren()	返回这个对象下的直接子元素的集合
UiObject2	getParent()	返回该对象的父类
int	getChildCount()	返回这个对象直属子元素的数量
boolean	equals(java.lang.Object object)	比较两个对象是否相等
int	hashCode()	获取对象的hashCode
boolean	hasObject(BySelector selector)	返回该对象是否存在
void	recycle()	回收这个对象
<R> R	wait(SearchCondition<R> condition, long timeout)	等待的条件得到满足
<R> R	wait(UiObject2Condition<R> condition, long timeout)	等待的条件得到满足