android app自动化测试之UIAutomator

摘要:
输入项目名称后,单击“下一步”进入下一步。界面如下:不要关注源代码下的内容,单击“库”。由于要调用Java附带的UIAutomator,因此必须首先导入UIAutomater使用的包。
一、UIAutomator

Android自动化测试工具有很多,但是要免费、易上手,本人觉得就直接使用Eclipse自带的UIAutomator就不错。测试人员无需跟开发要代码信息,只要手机上有安装之后的APP自己就能做出自动测试用例,况且一通百通,就算是不满足于UI测试的,找个简单易上手的先明白原理,再深入了解其它复杂工具也会轻松很多。何乐而不为呢?

UIAutomator是Eclipse自带的用于UI自动化测试工具,可仿真APP上的单击、滑动、输入文本等操作。

在使用之前,需要安装好java有关的JDK,SDK,然后配置java环境变量。关于安装JDK,SDK,配置JAVA环境变量网上有数不清的教程,这里就不废话了。直接进入主题。

还是简单介绍一下自动化测试代码中使用到的类关系:现在还不清楚也没有关系,先让程序跑起来,然后在使用API的过程中自然就理解了。

android app自动化测试之UIAutomator第1张

1、创建java工程

打开Eclipse,操作步骤: 点击“File—>New—>java Project”,然后打开如下图的界面:

android app自动化测试之UIAutomator第2张

其它的先不用管,既然要求必须输入Project name,那就输入。请用英文命名,很多时候中文会带来许多意想不到的问题。

输入Project name之后,点击“Next”进入下一步,看到的界面如下:

android app自动化测试之UIAutomator第3张

Source下的东西无需关注,点击“Libraries”,既然是调用java自带的UIAutomator,就要先引入UIAutomator使用到的包。导入uiautomator相关包:点击“Add External JARs”

先要找到自己的android.jar 和 Uiautomator.jar 包的位置,一般在安装文件下的adt-bundle-windows-x86-20130917sdkplatformsandroid-18 下,具体要找到自己电脑上的jar位置哦,

android app自动化测试之UIAutomator第4张

选中两个jar文件,“打开”导入。

此外还需要再加入本地库,点击“Add Library”,选择Junit,后点击“next”,使用默认的JUit3。点击“Finish”。

android app自动化测试之UIAutomator第5张

回到New Java Project,点击“Finish”即可创建工程成功。

android app自动化测试之UIAutomator第6张

2、创建class文件

刚刚创建的工程,Src下还没有任何东西,我们需要创建一个Class文件,用来写自动化程序代码。

创建class文件:项目名称右键——NEW——class,写class内容如下

android app自动化测试之UIAutomator第7张

2.1 import UIautomator两个包

2.2 class 名称必须和XXX.java名称相同

2.3每一个public开头,且以test命名开始的函数,系统就视为一个case,运行时方法的调用顺序并不是代码中的位置顺序,而是根据方法名的ASCII码大小顺序调用的。

2.4每一个class都必须继承自UiAutoMatorTestCase

3、生成xml 文件

android app自动化测试之UIAutomator第8张

找到target版本:>android list targets

Id:1

android app自动化测试之UIAutomator第9张

创建build.xml到测试工程中去,用于生成.jar文件:>Android create UItest-project –n testprojectname –t 1 –p testprojectpath

android app自动化测试之UIAutomator第10张

4.build jar 文件

4.1 Update Ant to 1.9

4.2 配置ant使用的javac版本:

右键build.xml—》RUN AS —》 External Tools Configurations。

main Tab 下输入Argumens: -Dbuild.compiler=javac1.7——》

Apply。

android app自动化测试之UIAutomator第11张

4.3配置sdk中的build.xml 文件E:Androidandroidadt-bundle-windows-x86-20130917sdk oolsantuild.xml: 找到javac,添加includeantruntime="false"

<javac encoding="${java.encoding}"

source="${java.source}" target="${java.target}"

debug="true" extdirs="" includeantruntime="false"

destdir="${out.classes.absolute.dir}"

bootclasspathref="project.target.class.path"

verbose="${verbose}"

classpathref="project.javac.classpath"

fork="${need.javac.fork}" includeantruntime="false">

<src path="${source.absolute.dir}" />

<src path="${gen.absolute.dir}" />

<compilerarg line="${java.compilerargs}" />

</javac>

5. push jar文件到手机

Cmd环境下需要先找到adb.exe所在位置目录,完整的命令语句:

adb push <path_to_output_jar> /data/local/tmp

“<path_to_output_jar>”即要放到手机里的jar文件名及路径

android app自动化测试之UIAutomator第12张

相反的如果是从手机复制文件到电脑:

android app自动化测试之UIAutomator第13张

6. 运行测试

Cmd环境下需要先找到adb.exe所在位置目录,完整的命令语句:

adb shell uiautomator runtest XXX.jar -c XXXClassname

备注:XXX.jar需要运行的jar文件名,

Classname: 需要运行jar中的哪个类的名字

android app自动化测试之UIAutomator第14张

7.测试结果

运行结果如下:

android app自动化测试之UIAutomator第15张

Current: 当前运行的测试编号,与方法名称相关

Class:当前运行的函数所在的类

Numtests:测试的总数,每一个public testXX就是一个测试数

Test: 当前测试的函数名称

INSTRUMENTAION_STATUS_CODE:测试状态码,1表示正在执行,0表示执行成功,-1编辑运行错误

二、使用UIAUTOMATORVIEWER获取APP控件

1.手机打开app

使用UIAutomator获取手机app控件时,先在手机上运行起对应app

2 .电脑连接手机

确保电脑与手机已连通。

先在cmd界面到达java的adb.exe所在位置,

运行命令“ >adb shell ”获取当前连接电脑的设备,如下图,如果adb shell 运行正常,会弹出“shell@hwH30-C00:/$”

有多个设备连接开发机器时(模拟器或真机),通过设置ANDROID_SERIAL环境变量指定需要截图的设备。比如下图的:shell@hwH30-C00:/$ set ANDROID_SERIAL= hwH30-C00,设置连接成功后,返回:“set ANDROID_SERIAL=hwH30-C00”

adb devices命令查看连接中的设备编号

android app自动化测试之UIAutomator第16张

如果当前只连接了一个设备,则不用再在Cmd中执行连接命令

3.运行uiautomatorviewer.bat

找到uiautomatorviewer.bat安装目录,本机中的位置如下:

E:Androidandroidadt-bundle-windows-x86-20130917sdk oolsuiautomatorviewer.bat

双击运行uiautomatorviewer.bat,打开界面如下图:

android app自动化测试之UIAutomator第17张

上图中左半部分显示当前手机的呈现界面,若要获取其它界面的控件,需要在手机上后,点击上图左上角顶部的刷新,重新获取新界面。

上图右半部分显示当前界面的所有ui元素层即控件信息。右上半部分显示层级,右下部分显示指定层级上具体的控件属性,比如当前属性“class”:当前控件的所在class

“Package”:显示当前控制所在包

“Resource-id”:这个属性有最好了,有些Android开发人员没有为每个控件单独命名,在抓取的时候就非常不方便。如果有Resource-id,在抓取控件时,直接用Resource-id就能获取到正确的控件,并且操作正确,如果没有Resource-id,就只能通过查找同类控件后再按顺序获取了。比如先找到所有的textbox控件,再从所有的textbox控件中按序取几个,才能抓取到对应控件。

还有一些控件属性显示是否可见,是否checked,有实际应用需要时,可以获取

这里附上一个简单的测试java源代码,供参考代码格式

import com.android.uiautomator.core.UiDevice;

import com.android.uiautomator.core.UiObject;

import com.android.uiautomator.core.UiObjectNotFoundException;

import com.android.uiautomator.core.UiScrollable;

import com.android.uiautomator.core.UiSelector;

import com.android.uiautomator.testrunner.UiAutomatorTestCase;

publicclass MyTestCase extends UiAutomatorTestCase {

publicvoid testDemo() throws UiObjectNotFoundException {

//点击home回到桌面

UiDevice device = getUiDevice();

device.pressHome();

// 点击并等待打开app

UiObject czmApp = new UiObject(new UiSelector().className(android.widget.TextView.class.getName()));

czmApp.clickAndWaitForNewWindow();

sleep(1000);

//登录;instan从0开始,

UiObject username= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/login_username_edit"));

username.clearTextField();

username.setText("15300000018");

UiObject pwd= new UiObject(new UiSelector().className("android.widget.EditText").enabled(true).resourceId("com.wlyc.warehousechampions:id/login_password_edit"));

pwd.clearTextField();

pwd.setText("00OA8C");

device.pressBack();

sleep(500);

UiObject enter= new UiObject(new UiSelector().className("android.widget.Button").resourceId("com.wlyc.warehousechampions:id/login_btn"));

enter.click();

sleep(5000);

//跳转到“我的”

UiObject My= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/personcenter"));

My.clickAndWaitForNewWindow();

sleep(500);

//检查认证状态

UiObject result= new UiObject(new UiSelector().className("android.widget.TextView").resourceId("com.wlyc.warehousechampions:id/personcenter_apply_status"));

int n=result.getText().length();

//认证审核中

n=Dur_verify(n);

//认证失败 或者认证成功

if(n==4)

{

UiObject failed= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/apply_certificate_layout"));

failed.click();

UiObject isedit= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/titlebar_right_layout"));

//认证失败

if(isedit.exists())

{

isedit.click();

write();

sleep(500);

}

else //认证成功

{

UiObject backtoMy= new UiObject(new UiSelector().className("android.widget.LinearLayout").resourceId("com.wlyc.warehousechampions:id/titlebar_left_layout"));

backtoMy.click();

Release();

}

}

n=result.getText().length();

n=Dur_verify(n);

Release();

}

//录入并提交企业认证

publicvoid write()throws UiObjectNotFoundException

{

//跳转到企业认证

UiObject Company= new UiObject(new UiSelector().className("android.widget.RadioButton").resourceId("com.wlyc.warehousechampions:id/company_certificate"));

Company.click();

//录入企业认证信息

UiObject CompanyName=new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/cettificate_companyname_edit"));

CompanyName.setText("test");

sleep(500);

//拍照

UiObject photo= new UiObject(new UiSelector().className("android.widget.ImageView").resourceId("com.wlyc.warehousechampions:id/uploadimage_image"));

photo.click();

sleep(500);

UiObject takephoto= new UiObject(new UiSelector().className("android.widget.TextView").instance(1));

takephoto.click();

sleep(500);

UiObject phototake= new UiObject(new UiSelector().className("android.widget.ImageView").resourceId("com.android.gallery3d:id/shutter_button"));

phototake.click();

sleep(500);

UiObject photook= new UiObject(new UiSelector().className("android.widget.ImageView").resourceId("com.android.gallery3d:id/btn_done"));

photook.click();

sleep(500);

//提交认证

UiObject commit= new UiObject(new UiSelector().className("android.widget.Button").resourceId("com.wlyc.warehousechampions:id/commit_btn"));

commit.click();

sleep(500);

}

//发布仓库

publicvoid Release() throws UiObjectNotFoundException

{

UiObject wh_release= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/warehouse_distribute"));

wh_release.click();

UiObject wh_name= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_name_edit"));

wh_name.setText("nametest");

UiObject wh_ctg= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/spinnerview_layout"));

wh_ctg.clickAndWaitForNewWindow();

UiObject wh_ctg1= new UiObject(new UiSelector().className("android.widget.TextView").resourceId("com.wlyc.warehousechampions:id/spinnerview_listitem_text"));

wh_ctg1.click();

UiObject wh_mod= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/spinnerview_layout").instance(1));

wh_mod.click();

sleep(500);

UiObject wh_mod1= new UiObject(new UiSelector().className("android.widget.TextView").enabled(true).instance(0));

wh_mod1.click();

sleep(500);

UiObject wh_area= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_area_edit"));

wh_area.setText("5000");

UiObject wh_area_low= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_rentarea_edit"));

wh_area_low.setText("500");

UiObject wh_area_cpb= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_availrentarea_edit"));

wh_area_cpb.setText("1000");

UiObject wh_pric= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_price_edit"));

wh_pric.setText("26");

UiObject wh_etpris= new UiObject(new UiSelector().className("android.widget.EditText").resourceId("com.wlyc.warehousechampions:id/warehouse_company_edit"));

wh_etpris.setText("companyname");

UiObject wh_floor= new UiObject(new UiSelector().className("android.widget.CheckBox").enabled(true).instance(0));

wh_floor.click();

sleep(500);

//向下滑动屏幕

UiScrollable wh_scroll=new UiScrollable(new UiSelector().className("com.wlyc.warehousechampions:id/pulltorefresh_listview"));

wh_scroll.setAsVerticalList();

;

UiObject wh_addre= new UiObject(new UiSelector().className("android.widget.TextView").resourceId("com.wlyc.warehousechampions:id/warehousedetail_hightemperature_unit"));

wh_addre.click();

}

//认证审核中等待

publicint Dur_verify(int n) throws UiObjectNotFoundException

{

while (n!=4) {

UiObject My= new UiObject(new UiSelector().className("android.widget.RelativeLayout").resourceId("com.wlyc.warehousechampions:id/personcenter"));

My.clickAndWaitForNewWindow();

sleep(5000);

UiObject result= new UiObject(new UiSelector().className("android.widget.TextView").resourceId("com.wlyc.warehousechampions:id/personcenter_apply_status"));

n=result.getText().length();

}

return n;

}

}

三、Uiautomator Api分析

UiAutomator主要涉及以下几个类,大多数位于源码包的com.android.uiautomator.core下,其中粗体字部分为主要会接触到的类,熟知这5个类的作用,就可以大体顺畅的写出UiAutomator的测试用例。

UiAutomatorTestCase

UiDevice

UiSelector

UiScrollable

UiObject

UiCollection

UiTestAutomationBridge, UiAutomatorBridge

InteractionController, QueryController

UiWatcher

1、UiAutomatorTestCase

TestCase (Junit) -> UiAutomatorTestCase -> App Test

每个测试用例(类)都需要继承UiAutomatorTestCase,以实现测试环境的setup,teardown(拆卸)等同能。而UiAutomatorTestCase则是通过继承Junit3中的TestCase类,并在其中的setUp() 、tearDown() 、getParams() 函数中。其中主要是用Bundle实现Android Activity之间的通讯。在UiAutomatorTestCase,还加入了getUiDevice()等关于UiDevice的 函数,以实现在测试的任意地方均可调用UiDevice()。

2UiDevice

此类主要包含了获取设备状态信息,和模拟用户至于设备的操作两类api。

可以通过getDisplaySizeDp(), getDisplayWidth() , getDisplayHeight() ,getProductName() ,getCurrentActivityName(), getCurrentPackageName() 等获取设备相关信息。

pressMenu(), pressBack(), pressHome(), pressSearch() ,pressDPadCenter(), pressDPadRight(), pressDPadLeft(), pressDPadUp(), pressDPadDown() ,pressDelete(), pressEnter(), pressKeyCode(), pressRecentApps(),click(),swipe(),getDisplayRotation() setOrientationLeft()… wakeUp(), sleep() ,dumpWindowHierarchy(), waitForWindowUpdate()等API可以灵活的操纵设备。

而takeScreenshot() 允许随时对设备截屏。

3UiSelector

主要是通过一定查询方式,定位到所要操作的UI元素。

一般UI元素均可通过以下API定位:text(), textMatches(String regex), textStartsWith(), textContains() ,className() ,classNameMatches(String regex), className(Class type) ,Description(), descriptionMatches(String regex),descriptionStartsWith(),descriptionContains() ,packageName(), packageNameMatches(String regex)。

值得注意的是index()和 instance() 两个函数,其中index()是当前页面的ID编号,instance()则表示在一定的搜索结果下,获取的子元素集的第几个元素。如:

new UiSelector().className("android.widget.ImageView").enabled(true).instance(2);

另有enabled(), focused(), focusable(), scrollable(), selected(), checked(), clickable() ,longClickable() ,childSelector()等检索条件,顾名思义。

4UiObject

UiObject可代表页面的任意元素,它的各种属性定位通常通过UiSelector来完成。

比较常用的Api如clickAndWaitForNewWindow(),表示点击该元素,并且等待新窗口的展示完毕。这一过程是Android UI Testing框架支持的,不需要额外的控制等待时间。

UiObject允许点击该元素的具体一个部分,Api如clickTopLeft(), longClickBottomRight(),…

通过getText(), getContentDescription(), getVisibleBounds(),… 等api可获取UiObject的相关属性,getPackageName() 可用来明确是否打开了目标测试的App.

setText(), clearTextField() 可以 用来设置以及清空所关联的输入框。

waitForExists() 可以用来操纵相关等待或验证。

5UiCollection

UiCollection一般与UiSelector连用,如它的构造函数也要求提供Uiselector: UiCollection(UiSelector selector)。

它的api较少,主要用以从Uiselector筛选出的元素集中挑出所要的元素:getChildByDescription(), getChildByInstance(), getChildByText() ,以及统计元素集的个数getChildCount()

6UiScrollable

UiObject -> UiCollection ->UiScrollable

UiScrollable 用来表示可以滑动的界面元素,其继承关系如上图所示。

其Api中,setAsVerticalList(), setAsHorizontalList() 用以设置Ui元素列表是基于横向滚动还是纵向滚动。其后可以用getMaxSearchSwipes() ,flingForward(), flingBackward() ,scrollForward(),scrollBackward() ,scrollToEnd(), scrollToBeginning() 等函数控制滑动,以及getChildByDescription(), getChildByInstance(), getChildByText() ,scrollIntoView(), scrollTextIntoView(),… 来选择是否已经转换到具有目标元素的页面。如:

UiScrollable appViews = new UiScrollable(new UiSelector().scrollable(true));

appViews.setAsHorizontalList();

UiObject helperApp;

helperApp = appViews.getChildByText(new UiSelector()

.className(android.widget.TextView.class.getName()), " 91助手 "); 则若当前页面没有91助手APP, 测试会自动滑动页面,直到91助手App出现。

下面介绍下UI Testing Framework构成的重要类:

7UiTestAutomationBridge

这是整个Testing Framework的基础,此类负责连接系统了,记录最新的可链接事件(AccessibilityEvent) , 窗口内容查询Api等。可以被Android App调用,或者Java程序从shell调用。

这里需要注意两个概念:

7.1、AccessibilityEvent:所有的Ui元素可以被操纵,因为这些Event都是AccessibilityEvent。对于怎样令页面元素可以被操纵,使得相关的事件都是AccessibilityEvent,请参见Uiautomator 词条-"确认程序可以被测试" 部分。

7.2、AccessibilityNodeInfo:视窗中的组件树节点,也就是uiautomtorViewer中展示的各个节点。

Api中connect(), disconnect() 负责建立与设备的实际连接。

executeCommandAndWaitForAccessibilityEvent() performAccessibilityAction() findAccessibilityNodeInfosByText(), findAccessibilityNodeInfoByViewIdInActiveWindow() 都是其中重要的Api。

8UiAutomatorBridge

UiAutomatorBridge是UiTestAutomationBridge的子类,区别主要是在构造函数中加上了InteractionController 和QueryController 两大对象的调用。以及一些常量定义等。除了上述差异,UiAutomatorBridge还定义了executeCommandAndWaitForAccessibilityEvent() 、onAccessibilityEvent() 、waitForIdle() 、addAccessibilityEventListener() 等函数。

9InteractionController

介绍InteractionController,需要先提InteractionProvider,它负责注入用户事件(如点击、输入等) ,并且反应事件的对应坐标。

InteractionController则定义了几乎所有至于手机的基础操作,如runAndWaitForEvents(), clickAndWaitForEvents() ,click(), longTap(), scrollSwipe(),Swipe() ,clickAndWaitForNewWindow() ,touchUp(), touchDown(), TouchMove() ,isNaturalRotation(), setRotationRight(), setRotationLeft() ,freezeRotation() ,wakeDevice(), sleepDevice() 等。

10QueryController

QueryController负责把UiSelector 的查找信息转化为AccessibilityNodeInfo。

具体Api如下:findNodePatternRecursive(), translatePatternSelector(), translateReqularSelector(), translateCompoundSelector(), getRootNode() ,findAccessibilityNodeInfo()。

11UiWatcher

UiWatcher只在UiSelector无法找到匹配的结果时被调用,意在重试、等待页面更新 (如弹出对话框)等。其中只有一个主要函数:checkForCondition() 。

它的相关函数均在UiDevice中,如:UiDevice.registerWatcher() ,UiDevice. resetWatcherTriggers() ,UiDevice.runWatchers() ,UiDevice.removeWatcher()

免责声明:文章转载自《android app自动化测试之UIAutomator》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇通过mybatis向数据库中插入日期数据react-router-cache-router下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

android 检查网络连接状态实现步骤

获取网络信息需要在AndroidManifest.xml文件中加入相应的权限。 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 1)判断是否有网络连接 复制代码 代码如下: public boolean isNetworkConnected...

android平台中编写jni模块的方法(3)

这篇文章来说说ndk的使用方法,其实主要是关于ndk的一些编译选项的研究和翻译(其实人家google的文档已经说的很清楚了)。偶选用的测试环境是 slackware 12.0 + android 1.5 r1 for linux + jdk 1.6.0_12,ndk选用的是android 1.5 ndk r1这个版本的(直接解压就行,免安装的)。1、从nd...

Android Activity 切换动画(非原创)

在Android开发过程中,经常会碰到Activity之间的切换效果的问题,下面介绍一下如何实现左右滑动的切换效果,首先了解一下Activity切换的实现,从Android2.0开始在Activity增加了一个方法: public voidoverridePendingTransition(int enterAnim, int exitAnim) 其中:...

教你高速高效接入SDK——Unity统一接入渠道SDK(Android篇)

U8SDK的设计之初,就是为了可以支持各种游戏引擎开发的游戏,而不不过Android的原生平台。眼下一大半的手游,都是採用Unity3D和Cocos2dx开发,那么这里,我们就先来一步步给大家演示,用Unity开发的游戏,怎样通过U8SDK来高速地完毕多家渠道SDK的接入。 Unity研发的手游,仅仅须要调用U8SDK抽象层就可以完毕多家渠道SDK的接...

如何用Android Studio同时使用SVN和Git管理项目

本篇文章已授权微信公众号 dasu_Android(大苏)独家发布 这篇来讲讲如何在 Android Studio 上同时用 SVN 和 Git 来管理项目。我知道,你肯定会说我吃饱了撑着,没事找事做,为啥要同时用 SVN 和 Git 来管理项目。问题是,我也不想啊,我也很无奈啊(:(哭丧脸)。 为啥要同时用 SVN 和 Git 管理项目 这小题目也可以叫...

《ArcGIS Runtime SDK for Android开发笔记》——(15)、要素绘制Drawtools3.0工具DEMO

1、前言 移动GIS项目开发中点线面的要素绘制及编辑是最常用的操作,在ArcGIS Runtime SDK for iOS 自带AGSSketchLayer类可以帮助用户快速实现要素的绘制,图形编辑。但是在ArcGIS Runtime SDK for Android的版本中并没有提供类似的功能,实现过程相对较复杂。(10.2.8及以下版本需要用户自定义扩展...