解放程序猿宝贵的右手（或者是左手）
——Android自动化测试技巧
Google大神镇楼 ： http://developer.android.com/tools/testing-support-library/index.html#UIAutomator
前言：
觉得文章太长不想往后翻的朋友，你们会后悔的，当然，你也可以选择先看后面的，你会觉得很爽，但是相信我，你还是会回来看前面的。那么，还是慢慢往后翻吧。
导入：
人们懒的走路，才创造了汽车；
人们懒的爬楼，才创造了电梯；
人们懒的扫地，才创造了自动扫地机器人。
人类的进步，离不开这些喜欢偷懒的人，现在，程序猿将偷懒上升到了一个新的高度——利用程序来进行自动化软件测试，将测试工程师从繁琐的测试用例中解脱出来，从此可以一边喝着咖啡，一边看着程序自动测试，不必看着测试用例重复无数次的测试步骤，也不必担心操作失误而导致不必要的错误，更不用担心压力测试而导致的身心俱疲。想了解程序猿是如何实现自动化测试的吗，这里有你想要的答案。
声明
转载真的请注明出处：
http://blog.csdn.net/eclipsexys
顺便打个广告：
我的慕课网视频： http://www.imooc.com/space/teacher/id/347333
为啥要测试
- 发现错误、为程序员提供修改意见
- 验证软件是否满足设计需求和技术需求
- 验证生产环境下真实的用户使用过程，分析用户体验
——总而言之一句话——软件测试，决定着软件的质量。
以前在TCL的时候，每个软件版本都要不停的跑MonkeyTest，一个是检测系统ROM的稳定性，一个是检测各种第三方应用在ROM上的使用情况，所以经常会报出很多Monkey跑出来的Bug，这些Bug经过我们分析，会初步判断是第三方App的问题还是系统的ROM问题，如果是第三方的问题，我们也会提交给App的运营商，但是大部分的运营商给我们的回复都是，我们的App不支持跑Monkey，其实Monkey可以发现一些潜在的问题，特别是一些很难复现的问题，我以前的leader曾经说过一句话我觉得非常好，没有什么bug是不能复现的，没有复现，只是没有找到必先的步骤，所以每一个bug都不是偶然的，我们应该尽量严谨的分析每一个可能存在的bug。
再以前的时候，对日的公司对测试更是无比看重，各种UT测试式样书，不仅仅是要写好怎么测试、测试什么，而且测试的数据、中间过程还要截图，保留证据。
有哪些测试
- Google CTS测试：兼容性测试，测试ROM的兼容性标准
- Google GTS测试
- 实验室机器人测试、机械臂自动化模拟测试
- Monkey Test压力测试
- End User终端用户测试
对于美国的手机运营商，例如T-Mobile、Sprite、AT&T，他们都有一系列的手机性能测试，他们的测试项目、测试方法、测试过程，其实都是他们的商业机密，一个是保证测试结果的严谨性，一个也保证了手机厂商能够不作弊的完成测试，所以，千万不要学华X手机，在T-Mobile实验室偷拍手机测试机器人的软件、技术参数及其他机密信息，而被T-Mobile列入北美黑名单。逗比新闻
Android自动化测试工具
自动化测试是把以人为驱动的测试行为转化为机器执行的一种过程
- 将大量重复的测试步骤用脚本代替，让机器完成重复工作
- 规范测试用例，保证测试质量
- 高——大——上
自动化测试的工具
MonkeyRunner
monkeyrunner工具提供一个API来控制Android设备。可以写一个python脚本来安装应用，运行应用，发送键值，截图。monkeyrunner对python进行了封装，加入了一些针对Android设备的类。可以完全用python脚本来实现这些功能。Instrumentation
基于Android单个Activitiy的测试框架。Robotium
一个优秀的测试框架，基于Instrumentation的二次封装。QTP
一个Web上的自动化测试工具，通过录制脚本来实现自动化测试。UiAutomator
目前最佳的UI自动化测试框架。基于Android 4.X+系统，专业UI自动化测试，可以模拟用户对手机的各种行为。编写快速、可以使用大部分的Android API、无需签名，无任何Activity限制。
各个测试框架的优缺点如下表所示：
测试框架 | 使用语言 | 运行方式 | 限制 | 适用环境
-------- | ---
MonkeyRunner| Python | ADB、Python | 测试靠坐标 | 压力测试
Instrumentation | Java | ADB | 只能单个Activity测试，且需要应用相同签名，代码量大 | 白盒测试
Robotium | 同上 | 同上 | 同上 | 同上
UiAutomator | Java | ADB或者脱机| Android 4.X+| UI测试
综上所述，我们使用UiAutomator作为我们Android自动化测试的首选框架。
UiAutomator环境搭建
开发环境：eclipse（非常抱歉，还没学会如何使用AS来开发Java代码、进行jar打包，请了解的朋友留言！！！）
编译环境：Ant、Java、Android SDK
UiAutomator基本对象之UiDevice
通常用于获取系统的设备信息、系统按键、全局操作等。
获取坐标参数
返回值 | 方法 | 解释
-------- | ---
boolean| click(int x, int y) | 在点(x, y)点击
int | getDisplayHeight() | 获取屏幕高度
int | getDisplayWidth() | 获取屏幕宽度
Point | getDisplaySizeDp() | 获取显示尺寸大小
系统信息
返回值 | 方法 | 解释
-------- | ---
void | getCurrentPackageName() | 获取当前界面包名
void | getCurrentActivityName() | 获取当前界面Activity
void | dumpWindowHierarchy(fileName) | dump当前布局文件到/data/local/tmp/目录
滑动、拖拽
返回值 | 方法 | 解释
-------- | ---
boolean | drag(startX, startY, endX, endY, steps)| 拖拽坐标处对象到另一个坐标
boolean | swipe(segments, segmentSteps) | 在Points[]中以segmentSteps滑动
boolean | swipe(startX, startY, endX, endY, steps) | 通过坐标滑动
系统按键
返回值 | 方法 | 解释
-------- | ---
void | wakeUp() | 按电源键亮屏
void | sleep() | 按电源键灭屏
boolean | isScreenOn() | 亮屏状态
void | setOrientationLeft() | 禁用传感器，并左旋屏幕，固定
void | setOrientationNatural() | 禁用传感器，恢复默认屏幕方向，固定
void | setOrientationRight() | 禁用传感器，并右旋屏幕，固定
void | unfreezeRotation() | 启用传感器，并允许旋转
boolean | isNaturalOrientation() | 检测是否处于默认旋转状态
void | getDisplayRotation() | 返回当前旋转状态，0、1、、2、3分别代表0、90、180、270度旋转
void | freezeRotation() | 禁用传感器，并冻结当前状态
boolean | takeScreenshot(storePath) | 当前窗口截图、1.0f缩放、90%质量保存在storePath
void | takeScreenshot(storePath, scale, quality) | 同上，但指定缩放和压缩比率
void | openNotification() | 打开通知栏
void | openQuickSettings() | 打开快速设置
等待窗口
返回值 | 方法 | 解释
-------- | ---
void | waitForIdle() | 等待当前窗口处于空闲状态、默认10s
void | waitForIdle(long timeout) | 自定义超时等待当前窗口处于空闲状态
boolean | waitForWindowUpdate(packageName, timeout) | 等待窗口内容更新
示例代码
// 输入按键
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_A);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_B);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_C);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_A,1);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_B,1);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_C,1);
// 点击
UiDevice.getInstance().click(400, 400);
int h=UiDevice.getInstance().getDisplayHeight();
int w=UiDevice.getInstance().getDisplayWidth();
UiDevice.getInstance().click(w/2, h/2);
// Swipe、Drag
int startX, startY, endX, endY, steps;
startX=300;
startY=400;
endX=startX;
endY=startY + 200;
steps=100;
UiDevice.getInstance().drag(startX, startY, endX, endY, steps);
int h=UiDevice.getInstance().getDisplayHeight();
int w=UiDevice.getInstance().getDisplayWidth();
UiDevice.getInstance().swipe(w, h/2, 30, h/2, 10);
Point p1=new Point();
Point p2=new Point();
Point p3=new Point();
Point p4=new Point();
p1.x=250;p1.y=300;
p2.x=600;p2.y=350;
p3.x=800;p3.y=800;
p4.x=200;p4.y=900;
Point[] pp={p1,p2,p3,p4};
UiDevice.getInstance().swipe(pp, 50);
// 灭屏、亮屏
UiDevice.getInstance().sleep();
UiDevice.getInstance().wakeUp();
// Notification
UiDevice.getInstance().openNotification();
sleep(3000);
UiDevice.getInstance().openQuickSettings();
UiDevice.getInstance().dumpWindowHierarchy("ui.xml");
送个视频，让大家真实体验下：
视频代码：
UiDevice.getInstance().pressBack();
UiDevice.getInstance().pressBack();
UiDevice.getInstance().pressHome();
sleep(1000);
UiDevice.getInstance().pressMenu();
sleep(1000);
UiDevice.getInstance().pressBack();
sleep(1000);
UiDevice.getInstance().pressRecentApps();
sleep(1000);
UiDevice.getInstance().pressHome();
sleep(1000);
UiDevice.getInstance().click(240, 1100);
sleep(2000);
UiDevice.getInstance().click(670, 1100);
sleep(2000);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_H);
sleep(1000);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_H, 1);
sleep(1000);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_J);
sleep(1000);
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_J, 1);
sleep(1000);
UiDevice.getInstance().swipe(30, 400, 600, 400, 10);
sleep(1000);
UiDevice.getInstance().pressHome();
sleep(1000);
UiDevice.getInstance().drag(660, 860, 360, 360, 50);
sleep(1000);
UiDevice.getInstance().sleep();
sleep(1000);
UiDevice.getInstance().wakeUp();
sleep(1000);
UiDevice.getInstance().swipe(370, 1000, 370, 200, 50);
sleep(1000);
UiDevice.getInstance().takeScreenshot(new File("/sdcard/uidevice.png"));
UiAutomator基本对象之UiSelector
通常使用UiSelector，通过各种属性节点和关系来定位组件，类似SQL语句的where条件。
uiautomatorviewer
要查看界面UI元素的层级关系，我们需要使用SDK/tools/下面的uiautomatorviewer工具来帮助我们进行查看，运行uiautomatorviewer，点击dump，我们就可以获取当前界面的UI快照。
下面这张图就是一个示例：
通过uiautomatorviewer，我们可以找到很多对象的属性，上图右下角的方框中的，都是对象所具有的属性。我们可以通过这些属性来定位需要的元素对象，这里要注意的是，uiautomator可以使用链式查找，即一个条件无法定位，那么可以通过多个条件组合，来定位一个元素。
通过text、description属性定位
返回值 | 方法 | 解释
-------- | ---
UiSelector | text(text) | 通过text完全定位
UiSelector | textContains(text) | 通过text包含定位
UiSelector | textMatches(regex) | 通过text正则定位
UiSelector | textStartsWith(text) | 通过text起始文字定位
UiSelector | description(text) | 通过text完全定位
UiSelector | descriptionContains(text) | 通过description包含定位
UiSelector | descriptionMatches(regex) | 通过description正则定位
UiSelector | descriptionStartsWith(text) | 通过description起始文字定位
通过resourceId定位
返回值 | 方法 | 解释
-------- | ---
UiSelector | resourceId(id) | 通过resourceId定位
UiSelector | resourceIdMatches(regex) | 通过resourceId正则定位
通过class、package定位
这种方式适用于当前页面上只有一种类型的组件的情况，例如只有一个ListView。
返回值 | 方法 | 解释
-------- | ---
UiSelector | className(className) | 通过class定位
UiSelector | classNameMatches(regex) | 通过class正则定位
UiSelector | packageName(name) | 通过package定位
UiSelector | packageNameMatches(regex) | 通过package正则定位
通过index、instance定位
返回值 | 方法 | 解释
-------- | ---
UiSelector | index(index) | 通过index定位
UiSelector | instance(instance) | 通过instance定位
通过其它属性定位
返回值 | 方法 | 解释
-------- | ---
UiSelector | enabled(val) | 通过enabled属性定位
…… | …… | ……
对象的所有属性都可以使用，这里不再列举。
示例代码
// 找到对象 点击对象
UiSelector l=new UiSelector().text("联系人");
UiObject object=new UiObject(l);
object.click();
// 匹配方式
// 完全匹配：联系人
// 包含匹配：系人
// 正则匹配：.*系.*
// 起始文字匹配：联系
UiSelector l=new UiSelector().textContains("系人");
UiSelector l=new UiSelector().textMatches(".*系.*");
UiSelector l=new UiSelector().textStartsWith("联系");
UiObject object=new UiObject(l);
object.click();
UiAutomator基本对象之UIObject
UIObject是UiAutomator的核心属性之一。它代表了整个UI界面中的所有对象元素。
它的功能包括：获取UI元素，点击、拖拽、滑动、对象属性判断、手势等。
点击与长按
返回值 | 方法 | 解释
-------- | ---
boolean | click() | 点击对象
boolean | clickAndWaitForNewWindow() | 点击对象并等待新窗口出现
boolean | clickAndWaitForNewWindow(timeout) | 点击对象并等待新窗口出现，指定延迟
boolean | clickBottomRight() | 点击对象右下角
boolean | clickTopLeft() | 点击对象左上角
boolean | longClick() | 长按对象
boolean | longClickBottomRight() | 点击对象右下角
boolean | longClickTopLeft() | 点击对象左上角
拖拽与滑动
返回值 | 方法 | 解释
-------- | ---
boolean | dragTo(destObj, steps) | 以steps拖动对象到destObj
boolean | dragTo(destX, destY, steps) | 以steps拖动对象到坐标
boolean | swipeDown(steps) | 向下拖动
boolean | swipeLeft(steps) | 向左拖动
boolean | swipeRight(steps) | 向右拖动
boolean | swipeTop(steps) | 向上拖动
文本输入与清除
返回值 | 方法 | 解释
-------- | ---
boolean | setText(text) | 设置内容为text
boolean | clearTextField() | 清除文本
获取对象属性
返回值 | 方法 | 解释
-------- | ---
Rect| getBounds() | 获取对象矩形范围
int | getChildCount() | 获取子View数量
……| …… | ……
还有很多，不列举了。
获取对象属性状态
返回值 | 方法 | 解释
-------- | ---
boolean | isCheckable() | 获取对象checkable状态
……| …… | ……
还有很多，不列举了。
获取对象存在状态
返回值 | 方法 | 解释
-------- | ---
boolean | waitForExists(timeout) | 等待对象出现
boolean | waitUntilGone(timeout) | 等待对象消失
boolean | exists() | 对象是否存在
手势状态
返回值 | 方法 | 解释
-------- | ---
boolean | performMultiPointerGesture(touches) | 执行单指手势
boolean | performTwoPointerGesture(startPoint1, startPoint2, endPoint1, endPoint2, steps) | 执行双指手势
boolean | pinchIn(percent, steps) | 双指向内收缩
boolean | pinchOut(percent, steps) | 双指向外张开
示例代码
// 拖拽
UiObject object1=new UiObject(new UiSelector().text("联系人"));
UiObject object2=new UiObject(new UiSelector().text("图库"));
object1.dragTo(300,1200, 10);
object1.dragTo(object2, 30);
object1.swipeUp(5);
// 输入、清空
UiObject edit=new UiObject(new UiSelector()
.resourceId("com.hjwordgames:id/edit_password"));
edit.setText("xuyisheng");
sleep(2000);
edit.clearTextField();
// 判断
UiObject wlan=new UiObject(new UiSelector()
.resourceId("com.android.settings:id/switchWidget"));
if(!wlan.isChecked()){
wlan.click();
}
// 手势
UiObject object=new UiObject(new UiSelector()
.resourceId("com.android.gallery3d:id/photopage_bottom_controls"));
object.pinchIn(80, 20);
object.pinchOut(80, 20);
Point startPoint1, startPoint2, endPoint1, endPoint2;
startPoint1=new Point();
startPoint2=new Point();
endPoint1=new Point();
endPoint2=new Point();
startPoint1.x=150;startPoint1.y=200;
startPoint2.x=100;startPoint2.y=500;
endPoint1.x=900;endPoint1.y=200;
endPoint2.x=950;endPoint2.y=500;
object.performTwoPointerGesture(startPoint1, startPoint2, endPoint1, endPoint2, 50);
再送一个视频、不收费：
视频代码：
UiObject word = new UiObject(new UiSelector().text("沪江开心词场"));
word.clickAndWaitForNewWindow();
UiObject username = new UiObject(new UiSelector().text("沪江用户名/邮箱/手机"));
username.setText("xuyisheng");
sleep(1000);
UiObject pwd = new UiObject(
new UiSelector().resourceId("com.hjwordgames:id/edit_password"));
pwd.setText("123465");
sleep(2000);
pwd.clearTextField();
sleep(1000);
pwd.setText("123465");
UiDevice.getInstance().pressBack();
sleep(1000);
UiObject login = new UiObject(new UiSelector().text("登 录"));
login.clickAndWaitForNewWindow();
UiDevice.getInstance().pressBack();
UiDevice.getInstance().pressBack();
word.dragTo(300, 300, 50);
sleep(1000);
word.swipeDown(50);
UiAutomator基本对象之UIScrollable
专业处理滚动一百年。
滚动
返回值 | 方法 | 解释
-------- | ---
boolean | flingBackward() | 步长为5快速向后滑动
boolean | flingForward() | 步长为5快速向前滑动
boolean | flingToBeginning(maxSwipes) | 不超过maxSwipes滑动到最前，步长为5
boolean | flingToEnd(maxSwipes) | 不超过maxSwipes滑动到最后，步长为5
boolean | flingToEnd(maxSwipes) | 不超过maxSwipes滑动到最后，步长为5
……| …… | 同样还可以使用Scroll，不一一列举
获取列表子元素
返回值 | 方法 | 解释
-------- | ---
boolean | getChildByDescription(childPattern, text) | 默认滚动，查找childPattern UiSelector所对应的text子元素
boolean | getChildByDescription(childPattern, text, allowScrollSearch) | 是否允许滚动，查找childPattern UiSelector所对应的text子元素
…… | …… | 还有text、instance同样可以使用，不一一列举。
boolean | scrollIntoView(obj) | 滚动到obj所处的位置
boolean | scrollIntoView(selector) | 滚动到条件元素所处的位置
boolean | scrollTextIntoView(text) | 滚动到文本对象所处的位置
boolean | scrollToBeginning(maxSwipes) | 滚动到开始位置
boolean | scrollToBeginning(maxSwipes, steps) | 指定步长，滚动到开始位置
boolean | scrollToEnd(maxSwipes) | 滚动到最后位置
boolean | scrollToEnd(maxSwipes, steps) | 指定步长，滚动到最后位置
boolean | setMaxSearchSwipes(swipes) | 设置最大可扫动次数
boolean | getMaxSearchSwipes() | 获取最大可扫动次数、默认30
UiScrollable | setSwipeDeadZonePercentage(swipeDeadZonePercentage) | 设置滑动无效区域（到顶部的百分比）
double | getSwipeDeadZonePercentage() | 获取滑动无效区域（到顶部的百分比）
滚动方向
返回值 | 方法 | 解释
-------- | ---
boolean | setAsHorizontalList() | 设置水平滚动
boolean | setAsVerticalList() | 设置垂直滚动
示例代码
// 滑动
UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
scroll.flingBackward();
scroll.flingForward();
scroll.flingToBeginning(20);
scroll.flingToEnd(30);
// 滑动到某元素
UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
UiObject baiQiang=scroll.getChildByText(new UiSelector().className("android.widget.TextView"), "zhujia");
baiQiang.click();
scroll.getChildByInstance(new UiSelector().className("android.widget.TextView"), 25).click();
// 滑动到某元素
UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
UiSelector selector=new UiSelector().text("zhujia");
UiObject object=new UiObject(selector);
scroll.scrollIntoView(selector);
scroll.scrollIntoView(object);
scroll.scrollTextIntoView("zhujia");
scroll.scrollDescriptionIntoView("zhujia");
scroll.scrollToBeginning(50,5);
scroll.scrollToEnd(50,5);
// 滑动方向
UiScrollable scroll=new UiScrollable(new UiSelector().className("android.support.v4.view.ViewPager"));
scroll.setAsHorizontalList();
scroll.scrollBackward();
sleep(2000);
scroll.scrollForward();
sleep(2000);
scroll.setAsVerticalList();
scroll.scrollForward();
视频大放送：
视频代码：
UiScrollable scrollable = new UiScrollable(
new UiSelector().className("android.widget.ListView"));
scrollable.flingForward();
sleep(500);
scrollable.flingBackward();
sleep(500);
scrollable.flingForward();
UiObject target = new UiObject(new UiSelector().text("德国工业就是这么强大！不得不服"));
scrollable.scrollIntoView(target);
target.click();
UiAutomator基本对象之UICollection
通常用于获取满足某种搜索条件的组件集合，通过链式搜索确定最终需要的组件。
先按照一定的条件枚举容器内的子元素，再从符合条件的子元素中进一步定位。
一般使用容器类组件作为父类，用于寻找不好定位的子元素。
示例代码
UiCollection collection=new UiCollection(new UiSelector().className("android.widget.ListView"));
UiSelector childPattern=new UiSelector().className("android.widget.TextView");
String text="Music";
UiObject music=collection.getChildByText(childPattern, text);
music.click();
UiAutomator基本对象之UiWatcher
通常我们会让脚本来按照我们所需要的顺序来执行，但有时候，总有一些天灾人祸，比如10086发短信来了。
所以，我们的脚本必须要有一定的容错性。
UiWatcher正是这样一个容错的对象，当我们在顺序执行脚本时，如果中间突然插入了一些不明事件，我们可以使用UiWatcher来拦截异常，处理完异常后，再返回原来的脚本执行顺序。
UiAutomator基本对象之Configuration
Configuration，自然是对默认操作的配置，通常情况下，我们使用默认的Configuration就足够了，当然，如果你有一些特殊需求，就可以通过Configuration类来设置。它能更改我们前面提到的所有默认属性的设置。包括默认延迟、输入延迟、等待超时等等。
UiAutomator基本对象之查看报告
下面是一个典型的UiAutomator测试报告：
INSTRUMENTATION_STATUS: numtests=1
INSTRUMENTATION_STATUS: stream=
com.hj.autotest.AutoTest:
INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
INSTRUMENTATION_STATUS: test=testDevice
INSTRUMENTATION_STATUS: class=com.hj.autotest.AutoTest
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: numtests=1
INSTRUMENTATION_STATUS: stream=.
INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
INSTRUMENTATION_STATUS: test=testDevice
INSTRUMENTATION_STATUS: class=com.hj.autotest.AutoTest
INSTRUMENTATION_STATUS: current=1
INSTRUMENTATION_STATUS_CODE: 0
INSTRUMENTATION_STATUS: stream=
Test results for WatcherResultPrinter=.
Time: 31.489
OK (1 test)
INSTRUMENTATION_STATUS_CODE: -1
这些报告被INSTRUMENTATION_STATUS_CODE分为了三个部分，1表示运行前，-1表示运行完成。
如果出错了，你可以在报告中找到相应的错误信息。
你同样需要知道的是，UiAutomator也是JUnit工程，你同样可以在里面使用断言来进行某些变量、结果值的测试，这些同样会在报告中体现出来。
最后，UiAutomator大部分内容都讲完了，最后一个视频：
视频代码：
UiDevice.getInstance().pressHome();
new UiObject(new UiSelector().description("Apps"))
.clickAndWaitForNewWindow();
UiScrollable scrollable = new UiScrollable(
new UiSelector()
.resourceId(
"com.google.android.googlequicksearchbox:id/apps_customize_pane_content"));
scrollable.setAsHorizontalList();
UiObject word = new UiObject(new UiSelector().text("沪江开心词场"));
while (!word.exists()) {
scrollable.scrollForward();
}
word.clickAndWaitForNewWindow();
UiObject username = new UiObject(new UiSelector().text("沪江用户名/邮箱/手机"));
username.setText("xys10086");
sleep(1000);
UiObject pwd = new UiObject(
new UiSelector().resourceId("com.hjwordgames:id/edit_password"));
pwd.setText("Aa123465");
sleep(1000);
UiObject login = new UiObject(new UiSelector().text("登 录"));
login.clickAndWaitForNewWindow();
if (new UiObject(new UiSelector().className(
"android.widget.FrameLayout").index(1)).exists()) {
new UiObject(new UiSelector().text("注册"))
.clickAndWaitForNewWindow();
new UiObject(
new UiSelector()
.resourceId("com.hjwordgames:id/registerEditUsername"))
.setText("xys100861");
new UiObject(
new UiSelector()
.resourceId("com.hjwordgames:id/registerEditPassword"))
.setText("Aa123456");
new UiObject(
new UiSelector()
.resourceId("com.hjwordgames:id/regiserEditEmail"))
.setText("[email protected]");
new UiObject(new UiSelector().text("确认注册"))
.clickAndWaitForNewWindow();
UiObject ok = new UiObject(
new UiSelector().resourceId("com.hjwordgames:id/btnOK"));
if (ok.waitForExists(500)) {
ok.clickAndWaitForNewWindow();
}
}
如何使用UiAutomator
配置工程环境
在Eclipse中创建一个java工程，并添加platforms文件夹下面的android.jar和uiautomator.jar 两个引用。如下图：
创建测试用例
UiAutomator中的测试类都要继承UiAutomatorTestCase，每个测试用例的方法的方法名都要以test开头。如下图：
在测试用例的方法中，我们就可以编写测试脚本代码。
生成build.xml文件
在终端中，输入：
android create uitest-project -n -t -p
这里的android sdk id指的是在终端中，输入android list返回的你使用的sdk的id。
这里还要PS下，一定要配置好环境变量，这是我们后面一键自动化的基础。
例如：
android create uitest-project -n Demo -t 30 -p "F:\EclipseWorkSpace\AutoTest"
如下图：
修改build.xml文件
生成的build.xml文件我们还无法直接使用，我们需要修改它的一个属性，打开build.xml文件，将help改为build，如下图：
打包Jar
使用Ant，我们利用build.xml打包生成jar，命令如下：
ant -buildfile "F:\EclipseWorkSpace\AutoTest"
编译过程如下图：
Push Jar包到手机
我们需要将jar包push到手机中的/data/local/tmp/目录才能启动测试。如下图：
adb push "F:\EclipseWorkSpace\AutoTest\bin\Demo.jar" /data/local/tmp/
执行测试用例
在终端中输入启动测试命令（#后如果不指定具体的用例名，则测试所有的方法），如下：
adb shell uiautomator runtest Demo.jar --nohup -c com.hj.autotest.AutoTest#testBrowser
到此为止，整个测试用例的测试就全部结束了。
让自动化测试自动起来
看完前面的步骤，相信很多人已经不想再看下去了，好吧，那你们损失大了，所谓自动化测试，就是为了减少人工的操作，像这样反复的编译、修改、push、运行，这跟手动去测试又有什么区别呢？
OK，让自动化再上升一个境界。
我们可以发现，其实这些操作，与我们进行测试一样，也是一些机械动作，ok，那么我们完全可以使用同样的思路——使用脚本来解决这些问题。
我们创建一个脚本工具——UiAutomatorTool，来封装这些机械的步骤。代码非常简单，无非是使用Java调用终端命令，来执行前面的各种操作。
代码如下：
package com.hj.autotest;
import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileWriter;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
public class UiAutomatorTool {
// 工作空间目录
private static String WORKSPACE_PATH;
/**
* 指定自动测试的参数
*
* @param jarName
* 生成jar的名字
* @param testPackageclass
* 测试包名+类名
* @param testFunction
* 测试方法名，空字符串代表测试所有方法
* @param androidId
* SDK id
*/
public UiAutomatorTool(String jarName, String testPackageclass,
String testFunction, String androidId) {
System.out.println("*******************");
System.out.println(" --AutoTest Start--");
System.out.println("*******************");
// 获取工作空间目录路径
WORKSPACE_PATH = getWorkSpase();
System.out.println("自动测试项目工作空间:\t\n" + getWorkSpase());
// ***********启动测试*********** //
// 创建Build.xml文件
creatBuildXml(jarName, androidId);
// 修改Build.xml文件中的Build类型
modfileBuild();
// 使用Ant编译jar包
antBuild();
// push jar到手机
pushJarToAndroid(WORKSPACE_PATH + "\\bin\\" + jarName + ".jar");
// 测试方法，为空则测试全部方法
if (androidId.equals("")) {
runTest(jarName, testPackageclass);
} else {
runTest(jarName, testPackageclass + "#" + testFunction);
}
// ***********启动测试*********** //
System.out.println("*******************");
System.out.println("---AutoTest End----");
System.out.println("*******************");
}
/**
* 创建build.xml文件
*/
public void creatBuildXml(String jarName, String androidID) {
System.out.println("--------创建build.xml 开始---------");
execCmd("cmd /c android create uitest-project -n " + jarName + " -t "
+ androidID + " -p " + "\"" + WORKSPACE_PATH + "\"");
System.out.println("--------创建build.xml 完成---------");
}
/**
* 修改build.xml文件位build type
*/
public void modfileBuild() {
System.out.println("--------修改build.xml 开始---------");
StringBuffer stringBuffer = new StringBuffer();
try {
File file = new File("build.xml");
if (file.isFile() && file.exists()) {
InputStreamReader read = new InputStreamReader(
new FileInputStream(file));
BufferedReader bufferedReader = new BufferedReader(read);
String lineTxt;
while ((lineTxt = bufferedReader.readLine()) != null) {
if (lineTxt.matches(".*help.*")) {
lineTxt = lineTxt.replaceAll("help", "build");
}
stringBuffer = stringBuffer.append(lineTxt).append("\t\n");
}
read.close();
} else {
System.out.println("找不到build.xml文件");
}
} catch (Exception e) {
System.out.println("读取build.xml内容出错");
e.printStackTrace();
}
// 重新写回build.xml
rewriteBuildxml("build.xml", new String(stringBuffer));
System.out.println("--------修改build.xml 完成---------");
}
/**
* 使用Ant编译jar包
*/
public void antBuild() {
System.out.println("--------编译build.xml 开始---------");
execCmd("cmd /c ant -buildfile " + "\"" + WORKSPACE_PATH + "\"");
System.out.println("--------编译build.xml 完成---------");
}
/**
* adb push jar包到Android手机
*
* @param localPath
* localPath
*/
public void pushJarToAndroid(String localPath) {
System.out.println("--------push jar 开始---------");
localPath = "\"" + localPath + "\"";
System.out.println("jar包路径:" + localPath);
String pushCmd = "adb push " + localPath + " /data/local/tmp/";
execCmd(pushCmd);
System.out.println("--------push jar 完成---------");
}
/**
* 测试方法
*
* @param jarName
* jar包名
* @param testName
* testName
*/
public void runTest(String jarName, String testName) {
System.out.println("--------测试方法 开始---------");
String runCmd = "adb shell uiautomator runtest ";
String testCmd = jarName + ".jar " + "--nohup -c " + testName;
execCmd(runCmd + testCmd);
System.out.println("--------测试方法 完成---------");
}
/**
* 获取WorkSpace目录
*
* @return WorkSpace目录
*/
public String getWorkSpase() {
File directory = new File("");
return directory.getAbsolutePath();
}
/**
* Shell命令封装类
*
* @param cmd
* Shell命令
*/
public void execCmd(String cmd) {
System.out.println("ExecCmd:" + cmd);
try {
Process p = Runtime.getRuntime().exec(cmd);
// 执行成功返回流
InputStream input = p.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(
input, "GBK"));
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
// 执行失败返回流
InputStream errorInput = p.getErrorStream();
BufferedReader errorReader = new BufferedReader(
new InputStreamReader(errorInput, "GBK"));
String eline;
while ((eline = errorReader.readLine()) != null) {
System.out.println(eline);
}
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 重新写回Build.xml
*
* @param path
* path
* @param content
* content
*/
public void rewriteBuildxml(String path, String content) {
File dirFile = new File(path);
if (!dirFile.exists()) {
dirFile.mkdir();
}
try {
BufferedWriter bw1 = new BufferedWriter(new FileWriter(path));
bw1.write(content);
bw1.flush();
bw1.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
那我们怎么使用呢？拿一个测试类来说：
public class AutoTest extends UiAutomatorTestCase {
public static void main(String[] args) {
new UiAutomatorTool("Demo", "com.hj.autotest.AutoTest", "testUiSelector", "30");
}
……
}
我们只需要在测试类中new一个UiAutomatorTool，并指定jar包名、包名、用例名、Android id即可。
接下来，只需要运行这样Java程序，就完成了整个过程的自动化，一键编译、一键运行。
好吧，再来一个视频：
让偷懒更进一步
前面我们已经让编译、push、运行自动化了，但是说到底，就连编写脚本也是一件非常繁琐的事情啊。OK，我们同样可以创建一个H5的页面，通过编写图形化的页面，来替代我们每个动作脚本的编写，毕竟这些脚本也是死的啊。
让偷懒发扬光大
这些脚本可不仅仅能做测试。
经过前面一系列的代码、演示，我们已经可以通过脚本来进行测试用例的自动化测试，但是，自动化不仅仅可以用来测试，当我们在调试程序的时候，经常需要登陆App以后才能进行测试，我们同样可以把这些操作放到脚本中，启动调试后，直接运行脚本，完成这样繁琐的输入、登陆步骤。