Android UIAutomator2.0入门

Android UIAutomator2.0入门

Uiautomator是由谷歌推出的用于UI自动化测试的工具,花了一天时间研究了下,总体来说还是非常简单,api非常简洁,今天主要帮助大家入门。对于安卓环境搭建我就不多讲了,我们直接进入Uiautomator讲解。

1 创建工程

直接用android studio创建一个空工程。启动studio,点击start a new Android Studio project,在application name处填上工程名,点击 Next, 在target android devices页面,选择默认最小的sdk,点next,在点add no activity,点finish,这样就创建好了一个新工程。

2 添加配置

在Module:app里的build.gradle的dependencies方法中,添加

implementation'com.android.support.test.uiautomator:uiautomator-v18:2.1.2'。复制代码

最后点击refresh all gradle按钮,更新uiautomator。

3 基础api

主要用到的两个对象device(直接操作设备),UiObject2(ui节点对象)。所有的ui测试都是基于设备或者节点对象,进行相关操作。只要吃透了这些方法的用法,写代码就可以信手拈来。

1.UiDevice使用

UiDevice按键

返回值方法名说明

booleanpressBack()模拟短按返回back键

booleanpressDPadCenter()模拟按轨迹球中点按键

booleanpressSPadDown()模拟轨迹球向下按键

booleanpressDPadLeft()模拟轨迹球向左按键

booleanpressDPadRight()模拟轨迹球向右按键

booleanpressDPadUp()模拟轨迹球向上按键

booleanpressDelete()模拟短按删除delete按键

booleanpressEnter()模拟短按回车enter键

booleanpressHome()模拟短按home键

booleanpressKeyCode(int keyCode,int metaState)模拟短按键盘代码keycode

booleanpressKetCode(int keyCode)模拟短按键盘代码keycode

booleanpressMenu()模拟短按menu键

booleanpressRecentApps()模拟短按最近使用程序

booleanpressSearch()模拟短按搜索键

主要用到的按键方法

UiDevice.getInstance().pressBack();//点击返回键UiDevice.getInstance().pressHome();//点击Home键UiDevice.pressKeyCode(KeyEvent.KEYCODE);//键盘按键复制代码

手势操作

click() 点击dragTo() 拖动当前元素swipe() 向上下左右滑动复制代码

其它高级用法暂时不做讨论,需要用到的话直接调用即可,例如唤醒屏幕,截屏等

2.UiObject2使用

基础动作模拟API

返回API说明

voidclear()清除编辑框中的内容

voidclick()点击一个对象

RclickAndWait(EventCondition condition, long timeout)点击一个对象,然后等待在超时时间内条件成立则通过,否则抛出异常

voiddrag(Point dest, int speed)自定义速度拖拽一个对象到指定位置,速度:像素/秒

voiddrag(Point dest)拖拽一个对象到指定位置

voidlongClick()长时间点击对象

booleanscroll(Direction direction, float percent)滚动操作

booleanscroll(Direction direction, float percent, int speed)自定义速度的滚动操作

voidsetText(String text)设置文本内容

手势API

返回API说明

voidpinchClose(float percent, int speed)自定义速度关闭手势

voidpinchOpen(float percent, int speed)自定义速度打开手势

voidpinchOpen(float percent)打开手势

booleanfling(Direction direction)滑动手势

booleanfling(Direction direction, int speed)自定义速度滑动手势

voidswipe(Direction direction, float percent, int speed)自定义速度滑动手势

voidswipe(Direction direction, float percent)自滑动手势

组件属性API

返回API说明

StringgetApplicationPackage()返回应用包名

StringgetClassName()返回对象类名

StringgetContentDescription()返回内容描述

StringgetResourceName()返回资源id

StringgetText()返回文本

RectgetVisibleBounds()返回对象可见范围内的屏幕坐标

PointgetVisibleCenter()返回可见范围的中心

booleanisCheckable()返回Checkable属性

booleanisChecked()返回Checked属性

booleanisClickable()返回Clickable属性

booleanisEnabled()返回Enabled属性

booleanisFocusable()返回Focusable属性

booleanisFocused()返回isFocused属性

booleanisLongClickable()返回LongClickable属性

booleanisScrollable()返回Scrollable属性

booleanisSelected()返回Selected属性

层级关系API

返回API说明

UiObject2findObject(BySelector selector)在该对象层级之下,返回第一个与条件匹配的对象

ListfindObjects(BySelector selector)在该对象层级之下,返回所有匹配的对象

ListgetChildren()返回该对象的所有子元素的集合

UiObject2getParent()返回该对象的父元素

intgetChildCount()返回该对象的直接子元素的数量

条件判断API

返回API说明

booleanequals(Object object)比较两个对象是否相等

inthashCode()获取对象的hashCode

booleanhasObject(BySelector selector)返回对象是否存在

Rwait(UiObject2Condition condition, long timeout)等待的条件得到满足

Rwait(SearchCondition condition, long timeout)等待的条件得到满足

注意:进行手势操作的时候,最好需要进行Thread.sleep()延迟操作,执行动画以及更新ui操作都是需要时间的,如果执行下个方法查找节点时页面还未及时更新,则会出现获取对象失败导致直接跑出异常。此时需要用到hasObject()判断对象是否存在,可以处理多种状态的逻辑判断,例如登录和未登陆显示的ui不一样,则需要根据节点判断当前是否处于登录状态。

4 在androidTest目录下写代码

接下来我们就简单的写个case来熟悉下基本操作,就做个简单的打开微信(已登录状态下,未登陆的情况大家熟练后在自行编写),然后发送聊天对话。

package com.appiumtest;import android.content.ComponentName;import android.content.Context;import android.content.Intent;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 org.junit.Test;import org.junit.runner.RunWith;/** * Instrumentedtest,whichwill execute on an Android device. * * author tangge by 2018-04-16 * * @see Testing documentation */@RunWith(AndroidJUnit4.class)public class ExampleInstrumentedTest2 {    private UiDevice device = null;    private String packageName ="com.tencent.mm";    @Test    public voidstartUp(){        Context appContext = InstrumentationRegistry.getTargetContext();        try {            useAppContext(appContext);        } catch (Exception e) {            e.printStackTrace();            Log.e("UiDevice",e.getMessage());        }    }    private void useAppContext(Context context) throws Exception {        // Context of the app under test.        device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation());        device.pressHome();        startApp(context);        //已登录状态,点击列表中第一个对话        sleep(10);        swipe("b2m",Direction.LEFT);//左滑        swipe("b2m",Direction.RIGHT);//右滑        clickListView("c3p",0,1);//点击第一个对话        click("aaf");//点击输入框        getObjById("aaf",1).setText("你好");        click("aal",1);//发送        click("h9",1);//点击返回    }    //启动APP    private void startApp(Context context){        Intent intent = new Intent();        intent.setComponent(new ComponentName(packageName, packageName+".ui.LauncherUI"));        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);        context.startActivity(intent);    }    private UiObject2 getObjById(String id,floatsencend){returndevice.wait(Until.findObject(By.res(packageName, id)), sencend > 0 ? (long) (sencend * 1000) : 200);    }    //点击    private void click(String id) throws Exception{        click(id,0);    }    //延迟点击    private void click(String id,floatsencend) throws Exception{if(exitObj(id,sencend)){            getObjById(id,0).click();        }    }    //延迟点击    private voidsetText(String id, String text ,floatsencend) throws Exception{if(exitObj(id,sencend)){            getObjById(id,0).setText(text);        }    }    //判断是否存在该对象    private booleanexitObj(String id,floatsencend) throws Exception{        sleep(sencend);returndevice.hasObject(By.res(packageName,id));    }    //判断是否存在该对象    private booleanexitObjByText(String text,floatsencend) throws Exception{        sleep(sencend);returndevice.hasObject(By.text(text));    }    //延迟2秒滑动    private void swipe(String id, Direction direction) {        getObjById(id,3).swipe(direction,0.8f,4000);    }    //点击列表第几个元素    private void clickListView(String id,int position,floatsencend) {        //点击第几个        getObjById(id,sencend).getChildren().get(position).click();    }    private void sleep(floatsencend) throws Exception{        Thread.sleep(sencend > 0 ? (long) (sencend * 1000) : 500);    }}复制代码

右击测试文件,点击运行即可。代码中已经封装了点击,滑动,判断对象是否存在,点击list列表等方法。希望大家能通过这个简单case快速入门,然后编写出完整的一套测试流程。源码附上download.csdn.net/download/qq…

原创地址 https://juejin.im/post/5ad6e89451882555653507c8

你可能感兴趣的:(Android UIAutomator2.0入门)