UiAutomator自动化测试框架介绍

环境搭建

1         必要条件

1.1       JDK

1.2       SDK(API高于15)

1.3       Eclipse

2         简要步骤

2.1       安装JDK并添加bin目录到环境变量

2.2       添加SDK中的tools目录和platform-tools到环境变量

2.3       安装Eclipse并安装ADT插件

建立工程

1         用eclipse建立Java project

2         添加Junit库

3         添加Android库

找到sdk/platforms/android-19/下面的android.jar和uiautomator.jar并添加进来

4         添加完成后如下图

在工程中编写case

1         分析Device当前界面的UI内容

在编写Case之前，需要找到界面上不同控件的id,text,class或者description等等，来定位具体的点击事件。我们可以使用uiautomatorviewer工具来分析界面的组织架构。

2         官方用例

package com.uia.example.my;

// Import the uiautomator libraries
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;

public class LaunchSettings extends UiAutomatorTestCase {

public void testDemo() throws UiObjectNotFoundException {  
    
      // Simulate a short press on the HOME button.
      getUiDevice().pressHome();
      
      // We’re now in the home screen. Next, we want to simulate 
      // a user bringing up the All Apps screen.
      // If you use the uiautomatorviewer tool to capture a snapshot 
      // of the Home screen, notice that the All Apps button’s 
      // content-description property has the value “Apps”.
 We can 
      // use this property to create a UiSelector to find the
button. 
      UiObject allAppsButton = new UiObject(new UiSelector()
         .description("Apps"));
      
      // Simulate a click to bring up the All Apps screen.
      allAppsButton.clickAndWaitForNewWindow();
      
      // In the All Apps screen, the Settings app is located in 
      // the Apps tab. To simulate the user bringing up the Apps
tab,
      // we create a UiSelector to find a tab with the text 
      // label “Apps”.
      UiObject appsTab = new UiObject(new UiSelector()
         .text("Apps"));
      
      // Simulate a click to enter the Apps tab.
      appsTab.click();

// Next, in the apps tabs, we can simulate a user swiping
until
      // they come to the Settings app icon.  Since the
container view 
      // is scrollable, we can use a UiScrollable object.
      UiScrollable appViews = new UiScrollable(new UiSelector()
         .scrollable(true));
      
      // Set the swiping mode to horizontal (the default is
vertical)
      appViews.setAsHorizontalList();
      
      // Create a UiSelector to find the Settings app and simulate
     
      // a user click to launch the app. 
      UiObject settingsApp = appViews.getChildByText(new
UiSelector()
       
 .className(android.widget.TextView.class.getName()), 
         "Settings");
      settingsApp.clickAndWaitForNewWindow();
      
      // Validate that the package name is the expected one
      UiObject settingsValidation = new UiObject(new
UiSelector()
       
 .packageName("com.android.settings"));
      assertTrue("Unable to detect Settings", 
         settingsValidation.exists());   
  }   
}

Build工程

1        
产生build工程所需要的配置文件

<android-sdk>/tools/android create
uitest-project -n <name> -t 1 -p <path>

name:
build jar文件的名字

1: 使用命令android list可以查看

path:
工程目录

2        
build工程jar文件

2.1配置文件创建完成后，刷新工程目录，将会产生三个文件：build.xml、local.properties和project.properties

2.2    打开build.xml，将default值改成build，如下图

2.3    build工程

运行工程

1        
导入

将build好的jar文件，push到手机目录/data/local/tmp/下

2        
运行命令

adb shell uiautomator runtest
LaunchSettings.jar(build出来的文件) -c com.uia.example.my.LaunchSettings(class名)

如果想要运行class类里具体的方法，可以在类后面加上#方法名即可

如果想手机单独运行程序，不受数据线的约束，可以使用--nohup

API详解

1        
UiDevice

提供关于设备的状态信息。你也可以使用这个类来模拟设备上的用户的行为，如按方向键或者按菜单键

如若获取UiDevice的对象,请使用UiDevice.getInstance()方法

2        
UiSelector

用于按照一定的条件，定位界面上的控件元素。UiObject对象通过UiSelector来选取

3        
UiObject

UiObject主要对对象进行操作

4        
UiScrollable

5        
UiCollection

UiCollection继承UiObject，用于枚举一个容器的用户界面(UI)元素计数的目的，或安装子元素的文本或描述条件获取子元素对象。

6         UiWatcher

监听器要在中断代码之前运行，我们首先要注册一个监听器，然后运行。注册监听器的方法，在UiDevice的API中有介绍，

注册监听器的结构方法如下：

UiDevice.getInstance().registerWatcher(“register watcher method”, new UiWatcher(){

Public boolean checkForCondition{

//在此方法体内定义监听的方法

}

});

编写用例的注意事项

1.每一个类都要继承UiAutomatorTestCase

2.最好在每个类里都定义setUp和tearDown方法，用于初始化（最好都以Home界面为测试开始点）和结束测试（最好也以Home界面为测试结束点）

3.因为此套测试框架式继承与Junit3的，所以每个方法最好都要以test开头，运行单个类时，程序会run以test开头的方法。当然这不是强制的，也可以以#方法run用例。