转载的该文章详细描述了uiautomation的使用, 对于初学者有很大的帮助。
在Android 4.1发布的时候包含了一种新的测试工具– uiautomator ,uiautomator是用来做UI测试的。也就是普通的手工测试,点击每个控件元素 看看输出的结果是否符合预期。比如 登陆界面 分别输入正确和错误的用户名密码然后点击登陆按钮看看是否能否登陆以及是否有错误提示等。
功能性或者黑盒UI测试不需要测试人员了解程序如何实现的,只需要验证各种操作的结果是否符合预期即可。这样的测试可以分离团队的开发人员和测试人员。大家各干各的没有太多的交集。
常用的UI测试方式就是人工验证啦,就是测试人员拿着各种手机分别安装要测试的程序然后看看是否能正确完成各种预定的功能。但是这种验证方式是非常耗时间的,每次回归都要全部验证一边,并且还容易出现人为错误。比较高效和可靠的UI测试方式就是自动化测试。自动化UI测试创建测试代码来执行测试任务,各种测试任务分别覆盖不同的使用场景,然后使用测试框架来运行这些测试任务。
uiautomator 就是你的自动化UI测试工具。
Android SDK在4.1中提供了如下工具来支持UI自动化测试:
要使用该工具,需要满足如下条件:
下面是uiautomator 工作流程概述:
在开始编写测试案例代码之前,需要熟悉待测应用的UI元素。可以通过uiautomatorviewer 工具来获取应用的界面截图并分析。uiautomatorviewer 工具提供了一个便利的方式来查看UI布局结构,并且可以查看各个控件的相关属性。利用这些信息可以用来创建UI测试代码。
uiautomatorviewer 工具截图
分析待测应用UI界面的步骤如下:
1. 把Android手机连接到电脑上
2. 打开命令行窗口并导航到目录 /tools/
运行如下命令:$ uiautomatorviewer
windows下运行 uiautomatorviewer.bat 命令
PS:或者在tools目录下双击该文件
3. 点击uiautomatorviewer 工具右上角文件夹按钮旁边的“Device Screenshot”按钮来获取当前 屏幕界面信息。
注意:如果当前电脑连接了多个设备,通过设置ANDROID_SERIAL环境变量来指定要分析的设备。步骤如下:
a.运行如下命令获取连接到电脑的设备序列号
$ adb devices
b.设置ANDROID_SERIAL为需要测试的设备序列号
Windows:set ANDROID_SERIAL=
Unix: export ANDROID_SERIAL=
如果电脑只连接一个设备则无需设置ANDROID_SERIAL 环境变量。
4. 查看待测应用的UI界面元素属性
把鼠标放到uiautomatorviewer工具左边的截图中的控件上来查看该控件的属性。属性显示在右侧界面下方,上方显示当前界面的布局结构。
点击右侧上方的黄三角按钮(Toggle NAF Nodes)来查看不能被uiautomator测试工具访问到的控件。这些控件只设置了有限的属性,所以导致uiautomator无法获取到这些控件。所以你可能很难测试这些控件。这种情况下你可以要求开发者为这些控件添加必要的属性,比如 如果是ImageView或者ImageButton应该添加android:contentDescription属性。
在开始使用uiautomator 之前需要完成如下准备工作:
当你准备测试的时候,待测的应用可能还没有发布到市场上。但是你应该具有该应用的APK安装文件,你可以通过ADB工具来安装待测应用到手机中,或者通过其他工具来安装Apk。
在开始编写uiautomator测试代码之前,需要先辨别待测应用的UI控件元素。一般而言,优秀的待测应用的UI元素应该是可见的并且用户可以操作的。这些UI元素也应该具有可见的文本标签、android:contentDescription值或者二则兼具。
通过uiautomatorviewer 工具可以查看应用的可见控件。具体使用情况见上面所述。
由于uiautomator 工具依赖Android设备的可访问行来获取UI控件,所以这不是非常重要的。要支持uiautomator 工具需要一下条件:
如果你使用的是Eclipse(Adt),则Android SDK提供了额外的工具来帮助你编写uiautomator测试代码和打包测试项目。在Eclipse中创建uiautomator测试项目的过程如下:
uiautomator项目类路径设置
如果你不使用Eclipse,则需要确保/platforms/目录中的uiautomator.jar 和 android.jar 位于项目Build path中。
配置好开发环境后就可以开始编写测试代码了。
uiautomator 测试案例(Test case)需要继承至UiAutomatorTestCase 类。而UiAutomatorTestCase 类继承至junit.framework.TestCase类,所以可以用JUnit的Assert类来比较测试结果。
UI测试的首要任务就是访问测试手机。一般都是从手机的主屏开始测试的。通过uiautomator 提供的API可以从主屏来模拟用户的操作。下面会介绍具体示例。
uiautomator API在 uiautomator.jar 文件中。这些API分别如下:
代表设备状态。在测试中,可以通过UiDevice实例来检测设备的各种属性,例如当前的屏幕方向以及屏幕尺寸。同时还可以通过UiDevice实例来执行设备级别的操作,例如 把设备设置为横屏或者竖屏、按下Home按键等。
如下是模拟按下Home按键的代码:
getUiDevice().pressHome();
代表一个搜索UI控件的条件。如果发现多个满足条件的控件则会返回第一个控件。返回的结果为UiObject对象。在构造UiSelector的时候可以组合使用多个属性来定位具体的控件。如果没有找到控件则会抛出 UiAutomatorObjectNotFoundException 异常。还可以使用childSelector()函数来嵌套UiSelector 对象。例如,下面的代码演示了如何在当前界面中查找第一个ListView中的带有文本属性为Apps的子控件。
UiObject appItem = new UiObject(new UiSelector() .className("android.widget.ListView").instance(1) .childSelector(new UiSelector().text("Apps")));
代表一个UI控件。通过UiSelector来查找UiObject。
如下示例代码演示了如何查找当前显示界面中的取消按钮和确认按钮:
UiObject cancelButton = new UiObject(new UiSelector().text("Cancel")); UiObject okButton = new UiObject(new UiSelector().text("OK"));
查找到的UiObject实例可以在其他测试代码中重用。需要注意的是:每次使用UiObject做操作的时候uiautomator 都会在当前屏幕重新查找该控件。
例子:如下代码uiautomator 工具在当前界面查找文本内容为“OK”的控件。如果存在并且可用则模拟用户点击该控件。
if(okButton.exists() && okButton.isEnabled()) { okButton.click(); }
例子:还可以限制仅仅查找特定类型的控件。例如 如下代码只查找文本为“Cancel”和“OK”的android.widget.Button类型控件。
UiObject cancelButton = new UiObject(new UiSelector().text("Cancel") .className("android.widget.Button")); UiObject okButton = new UiObject(new UiSelector().text("OK") .className("android.widget.Button"));
代表控件的集合。获取UiCollection的方式和UiObject一样,通过 UiSelector查找。 UiCollection对应Android系统中的ViewGroup以及子控件。
例子:如下代码演示如何通过UiSelector来获取包含视频集合的UiCollection。
UiCollection videos = new UiCollection(new UiSelector() .className("android.widget.FrameLayout"));
例子:如果每个视频是放到LinearLayout中的,则可以通过如下方式获取视频的数目:
int count = videos.getChildCount(new UiSelector() .className("android.widget.LinearLayout"));
例子:如果需要查找标签为“Cute Baby Laughing”的视频,并点击。则可以通过如下方式:
UiObject video = videos.getChildByText(new UiSelector() .className("android.widget.LinearLayout"), "Cute Baby Laughing"); video.click();
例子:同样还可以模拟其他用户操作。例如,模拟选择视频的操作如下:
UiObject checkBox = video.getChild(new UiSelector() .className("android.widget.Checkbox")); if(!checkBox.isSelected()){ checkbox.click(); }
代表可滚动的控件。可以用UiScrollable来模拟水平或者垂直滚动的UI元素。如果需要操作的元素在屏幕外需要滚动屏幕才能看到的情况下需要使用UiScrollable。
例子,下面的代码显示了如何模拟滚动到“Settings ”菜单并点击“About tablet”菜单的操作。
UiScrollable settingsItem = new UiScrollable(new UiSelector() .className("android.widget.ListView")); UiObject about = settingsItem.getChildByText(new UiSelector() .className("android.widget.LinearLayout"), "About tablet"); about.click()
其他API参考uiautomator api文档。
如下是一个简单的测试案例代码,模拟了点击Home键回到主屏,然后点击所以应用按钮打开所有应用列表,并滚动到时钟应用。打开时钟应用 并选择闹铃界面的第一个闹钟设置,修改该设置的开关。然后返回到时钟界面再进入倒计时界面。
package com.uia.example.my; import android.widget.ListView; import android.widget.Switch; 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 { // <span style="color:#009900;">TODO 重要注意: 在运行该测试代码的时候 需要先把手机语言环境设置为英文。</span> public void testDemo() throws UiObjectNotFoundException { // <span style="color:#009900;">模拟 HOME 键点击事件</span> getUiDevice().pressHome(); // 现在打开了主屏应用,模拟<span style="color:#009900;">点击所有应用按钮</span>操作来启动所有应用界面。 // 如果你使用了uiautomatorviewer来查看主屏,则可以发现“所有应用”按钮的 // <span style="color:#009900;">content-description 属性为“Apps”</span>。可以使用该属性来找到该按钮。 UiObject allAppsButton = new UiObject(new UiSelector().<span style="color:#3333FF;">description</span>("Apps")); // <span style="color:#009900;">模拟点击所有应用按钮,并等待所有应用界面起来</span> allAppsButton.clickAndWaitForNewWindow(); <span style="color:#990000;">//1——下面的步骤可以省略,原因未知</span> // 在所有应用界面,时钟应用位于Apps tab界面中。下面模拟用户点击Apps tab操作。 // 找到 Apps tab 按钮 UiObject appsTab = new UiObject(new UiSelector().<span style="color:#3333FF;">text</span>("Apps")); // 模拟点击 Apps tab. appsTab.click(); <pre name="code" class="prettyprint java" style="padding:0.5em; font-family:Monaco,Menlo,Consolas,'Courier New',monospace; color:rgb(51,51,51); margin-top:0px; margin-bottom:1.5em; font-size:16px; line-height:1.5em; word-break:break-all; word-wrap:break-word; white-space:pre-wrap; background-color:rgb(248,248,255); overflow-y:auto"><pre name="code" class="prettyprint java" style="padding:0.5em; font-family:Monaco,Menlo,Consolas,'Courier New',monospace; color:rgb(51,51,51); margin-top:0px; margin-bottom:1.5em; font-size:16px; line-height:1.5em; word-break:break-all; word-wrap:break-word; white-space:pre-wrap; background-color:rgb(248,248,255); overflow-y:auto"> <span style="color:#990000;">//1——上面的步骤可以省略,原因未知</span> <span style="color:#009900;">// 然后在 Apps tab界面,模拟用户滑动到时钟应用的操作。</span> // 由于Apps界面是可以滚动的,所以用 // UiScrollable 对象. UiScrollable appViews = new UiScrollable(new UiSelector().<span style="color:#009900;">scrollable</span>(true)); // <span style="color:#009900;">设置滚动模式为水平滚动(默认为垂直滚动)</span> <span style="color:#000000;">appViews.setAsHorizontalList();</span> if(allAppsButton.exists() && allAppsButton.isEnabled()) { <span style="color:#009900;">// allAppsButton在当前界面已经不可见了 所以这里不会执行</span> allAppsButton.click(); } <span style="color:#009900;">// 查找时钟应用并点击</span> UiObject settingsApp = appViews.<span style="color:#3333FF;">getChildByText</span>( <span style="color:#3333FF;">new UiSelector().className(android.widget.TextView.class.getName())</span>, <span style="color:#3333FF;">"Clock"</span>); settingsApp.clickAndWaitForNewWindow(); <span style="color:#009900;">// 验证当前显示 的应用包名为时钟</span> UiObject settingsValidation = new UiObject(new UiSelector().<span style="color:#3333FF;">packageName</span>("com.google.android.deskclock")); <span style="color:#009900;">// 如果不存在则出错提示</span> <span style="color:#3333FF;">assertTrue</span>("Unable to detect Clock", <span style="color:#3333FF;">settingsValidation.exists()</span>); <span style="color:#009900;">// 模拟点击时间tab</span> UiObject clock = new UiObject(new UiSelector().<span style="color:#3333FF;">description</span>("Clock")); clock.clickAndWaitForNewWindow(); <span style="color:#009900;">// 模拟点击下方的闹钟图标</span> UiObject alarms = new UiObject(new UiSelector().<span style="color:#3333FF;">description</span>("Alarms")); alarms.clickAndWaitForNewWindow(); UiScrollable list = <span style="color:#3333FF;">new UiScrollable</span>(new UiSelector().<span style="color:#3333FF;">className</span>(ListView.class.getName())); if(list.getChildCount() > 0) {<span style="color:#009900;">//如有过设置闹钟,则使用第一个闹钟,且index是从0计数</span> UiObject listIndex0 = list.<span style="color:#3333FF;">getChild</span>(new UiSelector().<span style="color:#3333FF;">index</span>(0)); UiObject switchBtn = listIndex0.getChild(new UiSelector().<span style="color:#3333FF;">className</span>(Switch.class.getName())); boolean isChecked = switchBtn.isChecked(); switchBtn.click(); } <span style="color:#009900;">// 模拟点击返回键,此处有可能直接退出clock应用</span> getUiDevice().pressBack(); UiObject timer = new UiObject(new UiSelector().<span style="color:#009900;">description</span>("Timer")); timer.clickAndWaitForNewWindow(); } }
如下步骤打包测试代码并在测试机运行的步骤:
1.创建打包测试代码的Build脚本。通过如下命令来生成Build脚本:
<android-sdk>/tools/android create uitest-project -n <name> -t 1 -p <path>
<name>是包含测试代码的项目名称,path是包含测试代码的项目文件路径。-t后面的1是Android sdk版本id。
注意: 在创建Build脚本之前,已经创建好了测试项目并编写好了测试代码。只不过该测试项目还没有包含打包脚本所以无法打包运行。在创建Build脚本的时候,<name>属性就是测试项目的名称、<path>就是已经创建的测试项目在电脑中的文件夹路径。 如果电脑上安装了多个版本的Android sdk,则需要运行/tools/android list target 来查看每个SDK的id。选择4.1以上的id即可。
2. 设置ANDROID_HOME 环境变量。
Windows:set ANDROID_HOME=
Unix:export ANDROID_HOME=
3. 打开命令行创建,导航到第一步中的目录中,运行 ant build 来打包。
4. 通过adb push命令把上一步打包出来的jar文件复制到测试手机中。
adb push <path>/bin/<name>.jar /data/local/tmp/
类似如下代码:
adb push ~/dev/workspace/LaunchSettings/bin/LaunchSettings.jar /data/local/tmp/
adb shell uiautomator runtest LaunchSettings.jar -c com.uia.example.my.LaunchSettings
关于uiautomator 的更多信息参考这里:http://developer.android.com/tools/help/uiautomator/index.html
下面是一些使用uiautomator 做UI测试的最佳实践