Uiautomator 2.0之UiDevice新增API学习小记

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.tommyxie.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 tommyxie 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 运行结果

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.tommyxie.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 tommyxie 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);


    }

}