一封给 Android 开发者 UI 自动化测试上手指南,前方高能
08 public void testAdd() throws Exception {
09
10 }
11 }
3、查看 Launcher UI
连接你的 Android 设备到电脑商,点击 home 按键,进入主界面。
返回到你的电脑,使用文件管理或者终端浏览你安装 Android SDK 的目录,进入到?tools?目录下,点击?uiautomatorviewer?。这个会启动?UI Automater Viewer?,你将看到如下界面:
点击上方手机图标来获取 Android 设备截屏。注意到此时获取到的截屏是可交互的。点击下面的 Apps 图标。在右方的?Node Detail?区域,你就可以看到根据选择图标的不同显示不同的详细信息,如下图所示:
与屏幕上的应用交互,UI 自动化测试需要能唯一识别它们。在这个教程中,可以使用应用的text
、content-desc
或者class
字段来唯一的区分。
从上图可以看到 Apps 图标没有text
字段,但有content-desc
。记下它的值,后面将用到这个值。
拿起 Android 设备,触摸 Apps 图标,进入设备安
装的所有应用界面。使用?UI Automater Viewe?获取另外一张屏幕截图。因为要写一个计算器应用的测试,点击计算器图标查看详细界面。
这次content-desc
是空的,但是text
的值为 Calculator,同样记住这个值。
如果你的 Android 设备运行不同的主界面或者不同的 Android 版本,界面和显示的细节会有所不同。这意味着后续代码中需要做一些修改,以匹配你的操作系统。
4、准备测试环境
返回到 Android Studio,给setUp
方法中添加代码。如同其名字,setUp
方法是用来准备测试环境的。换句话说,这个方法是在真正测试之前指定具体需要执行什么动作的。
现在需要写代码来模拟刚才在 Android 设备上执行的几个动作: 1、按 home 键进入主界面 2、按 Apps 图标进入应用界面 3、点击计算器图标启动它
在你的类中声明类型为UiDevice
的变量device
。它代表你的 Android 设备,后续使用它来模拟用户行为。
1 private UiDevice device;
在setUp
方法中,通过调用UiDevice.getInstance method
来初始化device
,传递Instrumentation
实例,如下所示:
1 device = UiDevice.getInstance(getInstrumentation());
模拟点击设备 home 键,需要调用pressHome
方法。
1 device.pressHome();
接下来,需要模拟点击 Apps 图标的动作。不能立即做这个动作,因为 Android 设备需要一个反应时间来加载界面。如果在屏幕显示出来之前执行这个动作就会引起运行时异常。
等待一些事情发生时,需要调用UiDevice
实例的wait
方法。等待 Apps 图标显示到屏幕,使用Until.hasObject
方法。
识别 Apps 图标需要使用By.desc
方法并传递值为 Apps 的参数。你还需要指定最长等待时间,单位为毫秒。此处设置为 3000。 至此形成如下代码段:
1 // Wait for the Apps icon to show up on the screen
2 device.wait(Until.hasObject(By.desc("Apps")), 3000);
要获取 Apps 图标的引用,需要使用findObject
方法。一旦有了 Apps 图标的引用,就可以调用click
方法来模拟点击动作了。
1 UiObject2 appsButton = device.findObject(By.desc("Apps"));
2 appsButton.click();
和前面一样,我们需要等待一些时间,保证计算器图标显示到屏幕上。在之前的步骤中,我们看到可以通过text
字段唯一的识别计算器图标。我们调用By.text
方法来找到图标,传递参数为Calculator
。
1 // Wait for the Calculator icon to show up on the screen
2 device.wait(Until.hasObject(By.text("Calculator")), 3000);
5、检查计算器 UI
在你的 Android 设备上启动计算器应用,使用?UI Automater Viewer?来查看显示。获取到一个截屏后,点击不同的按钮来观察使用何值可以唯一的区分它们。
在本次测试用例中,使用计算器计算?9+9=?的值并确认结果是否为?18。这意味着你需要知道怎么区分按键?9、+?和?=。
在我的设备上,如下是我收集到的信息:
数字按键匹配
text
值+?和?=?使用
content-desc
值,分别对应?plus?和?equals返回值显示在
EditText
控件中
如果你使用不同版本的计算器应用,请注意这些值有可能不一样。
6、创建测试类
在前面几步操作中,你已经学会了使用findObject
方法通过By.text
或者By.desc
来获取屏幕上不同对象的引用。还学会了通过click
方法来模拟点击对象的动作。下面的代码使用这些方法来模拟?9+9=。添加这些到类CalculatorTester
的方法testAdd
中。
01 // Wait till the Calculator's buttons are on the screen
02 device.wait(Until.hasObject(By.text("9")), 3000);
03
04 // Select the button for 9
05 UiObject2 buttonNine = device.findObject(By.text("9"));
06 buttonNine.click();
07
08 // Select the button for +
09 UiObject2 buttonPlus = device.findObject(By.desc("plus"));
10 buttonPlus.click();
11
12 // Press 9 again as we are calculating 9+9
13 buttonNine.click();
14
15 // Select the button for =
16 UiObject2 buttonEquals = device.findObject(By.desc("equals"));
17 buttonEquals.click();
现在就等待运行结果。此处不能使用Until.hasObject
,因为包含计算结果的EditText
已经显示在屏幕上了。取而代之,我们使用waitForIdle
方法来等待计算完成。同样,最长等待时间是 3000 毫秒。
1 device.waitForIdle(3000);
使用findObject
和By.clazz methods
方法获取EditText
对象的引用。一旦有了此引用,就可以调用getText
?方法来确定计算结果是否正确。
1 UiObject2 resultText = device.findObject(By.clazz("android.widget.EditText"));
2 String result = resultText.getText();
最后,使用assertTrue
来检验范围值是否为 18。
1 assertTrue(result.equals("18"));
测试到此结束。
评论