UI Automator + Eclipse + Ant 编译安装运行

1 环境准备

• Android开发环境的准备，首先通过ui automator viewer的测试，可以获取到屏幕的元素
  见：http://blog.csdn.net/ericyue83/article/details/48375005
• Eclispe 和 Ant安装并配置
• 准备测试设备，本人通过真实设备小米手机作为测试对象

2 创建Eclipse项目

• 打开Eclispe，创建一个Java Project(项目名：UIAutomatorTestCaseDemo)
• 增加android.jar，uiautomator.jar到项目的external jar中
  ( jar在本机的如下类似目录：%android_home%\platforms\android-22)
• 新建一个class(类名：testcasedemo，extend UiAutomatorTestCase),包名为com.lewi.demo

3 生成对应的build.xml文件

找到项目的目录，通过如下命令生成ant需要的build.xml文件。

D:\android>android create uitest-project -n UIAutomatorTestCaseDemo -t 1 -p D:\EclipseWorkspace\UIAutomatorTestCaseDemo
Added file D:\EclipseWorkspace\UIAutomatorTestCaseDemo\build.xml

运行完成后，在Eclispe中刷新项目，会看到新产生的build.xml文件。

4 配置ant targets

右键build.xml，选择Run As…选择，可以配置此项目的Targets。如下图：

默认情况，Target只选择了help。根据需要，我选择了help, build, install,test。当运行到test target提示
Launching tests from Ant not supported yet
跳转到%android_home%/tools/ant/uibuild.xml查看到，是以为当前版本不支持ant test。
根据uibuild.xml里面的提示，更新了自己的需要测试内容，再次ant test，测试通过。
更新后的uibuild.xml中test部分如下：

    <target name="test" description="Runs tests">
        <!-- todo: fix this -->
        <!--
        <fail message="Launching tests from Ant not supported yet" />
        -->
         <exec executable="${adb}" failonerror="true">
            <arg line="${adb.device.arg}" />
            <arg value="shell" />
            <arg value="uiautomator" />
            <arg value="runtest" />
            <arg value="${out.filename}" />
            <arg value="-e" />
            <arg value="class" />
            <arg value="com.lewi.demo.testcasedemo" />
        </exec>
    </target>

目前已经搞定ant一键编译，安装和测试。在Eclipse 中，可以通过快捷方式Alt + Shift + X , Q 执行ant。

5 修改测试用例Demo，让其成为一个完成的用例。

• 需求：通过滑屏解锁手机，然后点击Home键，检查主屏是否出现。
• testcasedemo代码如下：

package com.lewi.demo;

import android.os.RemoteException;
import com.android.uiautomator.testrunner.UiAutomatorTestCase;
import com.android.uiautomator.core.UiObject;
import com.android.uiautomator.core.UiObjectNotFoundException;
import com.android.uiautomator.core.UiScrollable;
import com.android.uiautomator.core.UiSelector;

public class testcasedemo extends UiAutomatorTestCase {

    public void testDemo() throws UiObjectNotFoundException, InterruptedException, RemoteException {   
        if(!getUiDevice().isScreenOn()){
            getUiDevice().wakeUp();
            getUiDevice().swipe(250, 850, 250, 100, 2);
        }

        getUiDevice().waitForWindowUpdate(null, 2000);
        getUiDevice().pressHome();

        UiObject clockValidation = new UiObject(new UiSelector().packageName("com.miui.home")); 
        assertTrue("could not find clock",clockValidation.exists());    
    }
}

使用ant进行build, install,test后，输出如下：

......
compile:
    [javac] Compiling 1 source file to D:\EclipseWorkspace\UIAutomatorTestCaseDemo\bin\classes
-post-compile:
-dex:
      [dex] input: D:\EclipseWorkspace\UIAutomatorTestCaseDemo\bin\classes
      [dex] Found Deleted Target File
      [dex] Converting compiled files and external libraries into D:\EclipseWorkspace\UIAutomatorTestCaseDemo\bin\classes.dex...
-post-dex:
-jar:
      [jar] Building jar: D:\EclipseWorkspace\UIAutomatorTestCaseDemo\bin\UIAutomatorTestCaseDemo.jar
-post-jar:
build:
install:
     [exec] 666 KB/s (1364 bytes in 0.002s)
test:
     [exec] open: Permission denied
     [exec] open: Permission denied
     [exec] INSTRUMENTATION_STATUS: numtests=1
     [exec] INSTRUMENTATION_STATUS: stream=
     [exec] com.lewi.demo.testcasedemo:
     [exec] INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
     [exec] INSTRUMENTATION_STATUS: test=testDemo
     [exec] INSTRUMENTATION_STATUS: class=com.lewi.demo.testcasedemo
     [exec] INSTRUMENTATION_STATUS: current=1
     [exec] INSTRUMENTATION_STATUS_CODE: 1
     [exec] INSTRUMENTATION_STATUS: numtests=1
     [exec] INSTRUMENTATION_STATUS: stream=.
     [exec] INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
     [exec] INSTRUMENTATION_STATUS: test=testDemo
     [exec] INSTRUMENTATION_STATUS: class=com.lewi.demo.testcasedemo
     [exec] INSTRUMENTATION_STATUS: current=1
     [exec] INSTRUMENTATION_STATUS_CODE: 0
     [exec] INSTRUMENTATION_STATUS: stream=
     [exec] Test results for WatcherResultPrinter=.
     [exec] Time: 3.603
     [exec] OK (1 test)
     [exec] INSTRUMENTATION_STATUS_CODE: -1
BUILD SUCCESSFUL
Total time: 7 seconds

当我们使用Ecllipse调试通过后，我们也可以使用命令行去部署和运行：
上次Jar包到测试设备： adb push UIAutomatorTestCaseDemo.jar /data/local/tmp
运行测试用例： adb shell uiautomator runtest UIAutomatorTestCaseDemo.jar -c com.lewi.demo.testcasedemo

6 Reference

http://android.toolib.net/tools/testing/testing_ui.html#creating

7 Todo List:

• 如何处理中文信息
• 如何把Demo代码共享到github