【转】UiAutomator简要介绍

原文地址：http://blog.csdn.net/g19920917/article/details/16131565

3.1、必备条件：

1、JDK
    2、SDK（API高于15）
    3、Eclipse（安装ADT插件）
    4、ANT（用于编译生成jar）

3.2、简要步骤：

1、安装JDK并添加环境变量。
        安装后，一定要通过JAVA_HOME的方式添加环境变量，即先建立JAVA_HOME变量，然后在path中添加%JAVA_HOME%\bin;
    2、添加SDK环境变量。
        一定要先建立ANDROID_HOME，然后把%ANDROID_HOME%\tools添加到path中；
    3、安装Eclipse，并安装ADT插件。
    4、安装ANT工具，并添加环境变量。

同样一定要先建立%ANT_HOME%变量，然后在path中添加%ANT_HOME%\bin

四、详细操作

4.1、建立工程

用Eclipse新建Java Project，注意，不是Android Project！

4.2、添加JUnit库

next->Libraries->Add Library

4.3、添加Android库

Add External JARs:

找到路径Android-sdk\platforms\android-17\下面的android.jar和uiautomator.jar添加进来：

所有库添加完应该是这个样子：

4.4、在src中添加包，然后添加class文件

文件内容为：

[java] view plaincopy

  1. package com;
  2. import com.android.uiautomator.core.UiObject;
  3. import com.android.uiautomator.core.UiObjectNotFoundException;
  4. import com.android.uiautomator.core.UiScrollable;
  5. import com.android.uiautomator.core.UiSelector;
  6. import com.android.uiautomator.testrunner.UiAutomatorTestCase;
  7. public class Runner extends UiAutomatorTestCase {
  8. public void testDemo() throws UiObjectNotFoundException {
  9. getUiDevice().pressHome();
  10. // 进入设置菜单
  11. UiObject settingApp = new UiObject(new UiSelector().text("Settings"));
  12. settingApp.click();
  13. //休眠3秒
  14. try {
  15. Thread.sleep(3000);
  16. } catch (InterruptedException e1) {
  17. // TODO Auto-generated catch block
  18. e1.printStackTrace();
  19. }
  20. // 进入语言和输入法设置
  21. UiScrollable settingItems = new UiScrollable( new UiSelector().scrollable(true));
  22. UiObject languageAndInputItem = settingItems.getChildByText(
  23. new UiSelector().text("Language & input"), "Language & input", true);
  24. languageAndInputItem.clickAndWaitForNewWindow();
  25. }
  26. }

上面工程路径在e:\workspace\AutoRunner，类全名为com.Runner，至于具体的作用我们现在不去关心。

4.5、找到SDK ID

CMD进入\Android-sdk\tools\目录下，运行命令：

android list

查看对应android版本的SDK的ID值，当前是60；

4.6、创建build文件

仍然在\Android-sdk\tools\目录下，运行命令：
    android create uitest-project -n <name> -t <android-sdk-ID> -p <path>
    比如：
    android create uitest-project -n AutoRunner -t 60 -p e:\workspace\AutoRunner
    上面的name就是将来生成的jar包的名字，可以自己定义，android-sdk-ID就是上面看到的6；path是Eclipse新建的工程的路径；运行命令后，将会在工程的根目录下生成build.xml文件。如果没生成，检查上面的步骤。

4.7、编译生成jar

CMD进入项目的工程目录，然后运行ant build，将使用ant编译生成jar，成功将会提示：
    
    然后会在bin目录下生成jar文件。

4.8、push并运行jar

adb push <jar文件路径> data/local/tmp
    adb shell uiautomator runtest <jar文件名> -c <工程中的类名，包含包名>
    比如：
    adb push e:\workspace\AutoRunner\bin\AutoRunner.jar data/local/tmp
    adb shell uiautomator runtest AutoRunner.jar -c com.Runner

然后就能看到手机会按照Runner中的步骤自动执行。具体效果就是，进入设置菜单，然后再进入“语言和输入法”菜单

五、代码分析

我们从几个最重要的对象来介绍。

5.1、UiDevice对象

getUiDevice()的方法可以得到一个UiDevice的对象，通过这个对象可以完成一些针对设备的动作：
    click(int x, int y)
    ----在(x,y)表示的像素地方点击
    pressBack()
    pressDelete()
    pressEnter()
    pressHome()
    pressMenu()
    pressSearch()
    ----点击相应的按键
    wakeUp()
    ----当手机处于灭屏状态时，唤醒屏幕，并解锁。
    swipe(startX, startY, endX, endY, steps)
    ----在手机上滑动，从(startX,startY)到(endX,endY)。steps表示滑动的这个距离分为几步完成，数目越少，滑动幅度越大。
    setOrientationLeft()
    setOrientationRight()
    ----将手机向相应方向旋转。
    setOrientationNatural()
    ----将手机旋转状态回归正常。

5.2、UiSelector对象

这个对象可以理解为一种条件对象，描述的是一种条件，经常配合UiObject使用，可以得到某个（某些）符合条件的控件对象。
    checked(boolean val)
    ----描述一种check状态为val的关系。
    className(className)
    ----描述一种类名为className的对象关系
    clickable(boolean val)
    ----与checked类似，描述clickable状态为val的关系
    description(desc)
    ----不解释
    descriptionContains(desc)
    ----与description类似
    focusable(boolean val)
    ----与checked类似
    index(index)
    ----用当前对象在父对象集中的索引作为描述
    packageName(String name)
    ----用包名作为条件描述
    selected(val)
    ----描述一种选择关系
    text(text)
    ----最为常用的一种关系，用控件上的文本即可找到当前控件，需要注意，所有使用text属性找到的控件，必须是英文的。也就是说，不支持通过中文查找控件！
    textContains(text)
    ----与text类似
    textStartsWith(text)
    ----与text类似

5.3、UiObject对象

这个对象可以理解为控件的对象。 一般一个UiObject对象可以通过一下形式得到：
    UiObject mItem = new UiObject(new UiSelector().text("English"));
    也就是配合一个UiSelector就可以得到一个控件。
    click()
    ----点击控件
    clickAndWaitForNewWindow()
    ----点击某个控件，并等待窗口刷新
    longClick()
    ----长按
    clearTextField()
    ----清除文本，主要针对编辑框
    getChildCount()
    ----这个方法可以看出，其实UiObject也可以是一个控件的集合
    getPackageName()
    ----得到控件的包名
    getSelector()
    ----得到当前控件的选择条件
    getText()
    ----得到控件上的Text
    isCheckable()
    isChecked()
    isClickable()
    isLongClickable()
    isScrollable()
    isScrollable()
    isSelected()
    ----判断是否具备某个属性

5.4、UiCollection对象

这个对象可以理解为一个对象的集合。因为UiSelector描述后得到的有可能是多个满足条件的控件集合，因此可以用来生成UiCollection:
    UiCollection mUiCollection = new UiCollection(new UiSelector().text("Settings"));
    getChild(selector)
    ----从集合中再次通过UiSelector选择一个UiObject对象
    getChildByDescription(childPattern, text)
    ----从一个匹配模式中再次以text为条件选择UiObject
    getChildByText(childPattern, text)
    ----与上面类似。
    getChildCount()
    ----得到当前集合中控件的个数

5.5、UiScrollable对象

UiScrollable可以生成一个滚动动作的对象，其最大的作用就是可以实现滚动的查找某个元素。比如在“设置”菜单中，“语言和输入法”这个菜单比较靠下，需要滚动后才可以看到（找到），因此就用上了UiScrollable：

[java] view plaincopy

  1. UiScrollable settingItems = new UiScrollable( new UiSelector().scrollable(true));
  2. UiObject languageAndInputItem = settingItems.getChildByText(
  3. new UiSelector().text("Language & input"), "Language & input",
  4. true);

上面的形式就可以在滚动中查找显示有“Language & input”的控件，也就是“语言和输入法”的设置项。

5.6、等待操作和添加Log的方法

如果是对于一个标准的UiObject对象，可以通过clickAndWaitForNewWindow的方法在点击之后主动等待一段事件，但是如果需要额外的等待一段时间，特别对于getUiDevice().pressHome();这种操作，可能需要很长的事件去为下一步操作获取更多的事件，此时我们可以使用线程的sleep方法去实现：

[java] view plaincopy

  1. //等待3秒
  2. try {
  3. Thread.sleep(3000);
  4. } catch (InterruptedException e1) {
  5. e1.printStackTrace();
  6. }

而添加Log的方法也可以通过Java标准的println来实现：
    System.out.println("This used to print some log!!!" + setLanItem.getText());
    以上Log将会在jar被运行时通过CMD窗口打印出来。

六、一个相对完整的测试case

下面就用一个相对连贯的测试用例来串一下上面的知识点，这个case用例要做的就是进入系统设置菜单，然后选择“语言和输入法”菜单，然后进入“语言设置”菜单，然后在第一项上点击，把当前语言设置为“简体中文”：

[java] view plaincopy

    1. public void setChineseLan() throws UiObjectNotFoundException {
    2. //进入操作前，先用Home键进入待机界面
    3. getUiDevice().pressHome();
    4. //进入“系统设置”菜单。也可以通过点击menu按键来实现
    5. UiObject settingApp = new UiObject(new UiSelector().text("Settings"));
    6. settingApp.click();
    7. //等待3秒
    8. try {
    9. Thread.sleep(3000);
    10. } catch (InterruptedException e1) {
    11. e1.printStackTrace();
    12. }
    13. //用滚动的方式查找并进入“语言和输入法设置”菜单
    14. UiScrollable settingItems = new UiScrollable(
    15. new UiSelector().scrollable(true));
    16. UiObject languageAndInputItem = settingItems.getChildByText(
    17. new UiSelector().text("Language & input"), "Language & input",
    18. true);
    19. languageAndInputItem.clickAndWaitForNewWindow();
    20. //找到“English”的可点击项（因为当前是英文环境）
    21. UiObject setLanItem = new UiObject(new UiSelector().text("English"));
    22. setLanItem.clickAndWaitForNewWindow();
    23. //Log输出
    24. System.out.println("setLanItem-->" + setLanItem.getPackageName());
    25. //由于无法识别中文，因此我们这里使用坐标去选择“简体中文”项
    26. getUiDevice().click(350, 250);
    27. //点击返回键，回到待机界面
    28. getUiDevice().pressBack();
    29. getUiDevice().pressBack();
    30. getUiDevice().pressBack();
时间： 2024-10-08 01:44:42

【转】UiAutomator简要介绍的相关文章

0-Android编译系统简要介绍和学习计划

Android编译系统简要介绍和学习计划 来源:http://blog.csdn.net/luoshengyang/article/details/18466779 导语: 在Android源码环境中,我们开发好一个模块后,再写一个Android.mk文件,就可通过m/mm/mmm/make等命令进行编译.此外,通过make命令还可制作各种系统镜像文件,例如system.img.boot.img和recovery.img等.这一切都得益于Android编译系统,它为我们处理了各种依赖关系,以及提

FinalActivity的简要介绍与使用

之前的两篇文章介绍了AFinal框架下的图片加载与网络通信的部分,这篇文章主要简单介绍FinalActivity的使用. 首先,FinalActivity是基于IOC机制,通过依赖注入的方式完成控件的id绑定与事件绑定,从而实现代码量的精简.下面是FinalActivity的最简单的使用 public class MainActivity extends FinalActivity { @ViewInject(id = R.id.btn, click = "click") Button

Android运行时ART简要介绍和学习计划

Android在4.4就已推出新运行时ART,准备替代用了有些时日的Dalvik.不过当时尚属测试版,主角仍是Dalvik. 直到今年的Google I/O大会,ART才正式取代Dalvik.这个消息在科技界引起不小轰动,也吸引不少技术人员对它的"技术分析".可惜这些"技术分析"不过是引用了官方的数据和图表而已.这一系列文章将对ART进行真正的技术分析.老规矩,分析前先进行简要介绍和制定学习计划. 老罗的新浪微博:http://weibo.com/shengyang

SEAndroid安全机制简要介绍和学习计划

与iOS相比,Android最被人诟病的是其流畅性和安全性.然而,从4.0开始,Android不遗余力地改善其流畅性.特别是在即将发布的L版本中,用ART替换了Dalvik,相信会越来越流畅.至于安全性,Android也没有遗忘.从4.3开始,Android引入了一套基于SELinux的安全机制,称为SEAndroid,来加强系统安全性.接下来我们就对SEAndroid进行简要介绍和制定学习计划. 老罗的新浪微博:http://weibo.com/shengyangluo,欢迎关注! 在介绍SE

html5 拖拽的简要介绍

1,首先,你要告诉计算机那个元素可以拖动,或者是一张图,或者是一个盒子,在标签里面加上 draggable="true"  2,然后,监听该元素被拖动的函数 ondragstart="drag(event)" 3,drag 里面告诉计算机是那个元素被拖动的 ev.dataTransfer.setData("Text",ev.target.id); 4,接下来将拖动的元素放到哪个盒子,(或者是经过那个盒子,经过某个盒子的时候触法 ondragove

0-Broadcast机制原理简要介绍

Broadcast机制简要介绍 来源: http://blog.csdn.net/luoshengyang/article/details/6730748 导语 广播机制在Android系统中,也不算是什么创新的东西.如果读者了解J2EE或者COM,就会知道,在J2EE中,提供了消息驱动Bean(Message-Driven Bean),用来实现应用程序各个组件之间的消息传递:而在COM中,提供了连接点(Connection Point)的概念,也是用来在应用程序各个组间间进行消息传递.无论是J

Nginx学习笔记01Nginx简要介绍与目录说明

1.1. Nginx简要介绍 (1)Nginx是Web服务器. Apache.IIS:经典的通用Web服务器. Lighttpd.Nginx:轻量级Web服务器. Tomcat.Jetty:面向Java的Web服务器. (2)Nginx的优点. Nginx最吸引人的优点在于以下三个方面: (a)支持高并发. 单机10万并发. (b)低内存消耗.10000个非活跃连接仅消耗2.5MB内存. (c)热部署.24x7不间断服务. (3)Nginx的架构特点. (a)多进程架构:1个Master进程+N

Chromium网页渲染机制简要介绍和学习计划

作为一个浏览器,快速地将网页渲染出来是最重要的工作.Chromium为了做到这一点,费尽了心机,做了大量优化工作.这些优化工作是卓有成效的,代表了当今最先进的网页渲染技术.值得一提的是,这些渲染技术不仅适用于网页渲染,也可以应用在原生系统的UI渲染上.例如,在Android系统上,我们就可以看到两者在渲染技术上的相似之处.本文接下来就对Chromium的网页渲染机制进行简要介绍,并且制定学习计划. 老罗的新浪微博:http://weibo.com/shengyangluo,欢迎关注! Chrom

Android应用程序UI硬件加速渲染技术简要介绍和学习计划

Android系统的流畅性一直被拿来与iOS比较,并且认为不如后者.这一方面与Android设备硬件质量参差不齐有关,另一方面也与Android系统的实现有关.例如在3.0前,Android应用程序UI绘制不支持硬件加速.不过从4.0开始,Android系统一直以"run fast, smooth, and responsively"为目标对UI进行优化.本文对这些优化进行简要介绍和制定学习计划. 老罗的新浪微博:http://weibo.com/shengyangluo,欢迎关注!