代码改变世界

如何使用UIAutomation进行iOS 自动化测试(Part II)

2012-08-17 15:34  知平软件  阅读(10853)  评论(4编辑  收藏  举报

接着上一篇《如何使用UIAutomation进行iOS 自动化测试(Part I)

 

3. 经验分享(让你生活变得更简单)

类库Tune-up介绍

现在你应该基本上知道如何编写测试代码了。但你慢慢地会发现,你会经常写到一些重复的,冗余的,黏糊糊的代码,像下面一样:

var target = UIATarget.localTarget();
var app = target.frontMostApp();
var window = app.mainWindow();

这也是为什么我们会用到一个小的Javascript类库来简化我们写的UIAutomation测试的原因。你可以去 https://github.com/alexvollmer/tuneup_js获取这个类库,然后将它复制到你的测试目录下面。现在让我们使用Tune-Up类库来重新编写我们的Test1.js:

#import "tuneup/tuneup.js"

test("Test 1", function(target, app) {
	var window = app.mainWindow();
	app.logElementTree();

	//-- select the elements
	UIALogger.logMessage( "Select the first tab" );
	var tabBar = app.tabBar();
	var selectedTabName = tabBar.selectedButton().name();

	if (selectedTabName != "First") {
		tabBar.buttons()["First"].tap();
	}

	//-- tap on the text fiels
	UIALogger.logMessage( "Tap on the text field now" );
	var recipeName = "Unusually Long Name for a Recipe";
	window.textFields()[0].setValue(recipeName);
	target.delay( 2 );

	//-- tap on the text fiels
	UIALogger.logMessage( "Dismiss the keyboard" );
	app.logElementTree();
	app.keyboard().buttons()["return"].tap();
	var textValue = window.staticTexts()["RecipeName"].value();
	assertEquals(recipeName, textValue);
});

Tune-Up可以避免你编写重复的代码,同时还给你提供了各种好用的断言方法:

ssertTrue(expression, message),
assertMatch(regExp, expression, message),
assertEquals(expected, received, message),
assertFalse(expression, message),
assertNull(thingie, message),
assertNotNull(thingie, message),
assertNull(thingie, message),
assertNotNull(thingie, message)

等等

你也可以很容易的扩展这个类库:例如,你可以通过将方法加入到uiautomation-ext.js:里面来为UIATarget类加一个logDevice方法:

extend(UIATarget.prototype, {
		logDevice: function(){
		UIALogger.logMessage("Dump Device:");
		UIALogger.logMessage(" model: " + UIATarget.localTarget().model());
		UIALogger.logMessage(" rect: " + JSON.stringify(UIATarget.localTarget().rect()));
		UIALogger.logMessage(" name: "+ UIATarget.localTarget().name());
		UIALogger.logMessage(" systemName: "+ UIATarget.localTarget().systemName());
		UIALogger.logMessage(" systemVersion: "+ UIATarget.localTarget().systemVersion());
	}
});

然后当你调用target.logDevice()就可以看到:

Dump Device:
model: iPhone Simulator
rect: {"origin":{"x":0,"y":0},"size":{"width":320,"height":480}}
name: iPhone Simulator

导入外部脚本

你也可以看到如何在一个脚本文件里引用另一个脚本,即通过#import指令。因此,你可以创建多个测试文件,然后将它们通过导入到单个文件的方式来链接并调用它们:

#import "Test1.js"
#import "Test2.js"
#import "Test3.js"
#import "Test4.js"
#import "Test5.js"

使用强大的命令行

如果你想让你的测试代码自动的运行起来,你还可以通过命令行来启动测试。其实,我比较推荐这种方式,而不是使用Instruments的图形界面程序。因为,Instruments的图形界面程序比较慢,而且即使你的测试代码跑完了它也还是会一直运行着。而通过命令行来启动和运行测试代码更快,它会在跑完测试后自动的停止。

为了可以在命令行终端运行你的脚本,你需要知道你设备的UDID和类型:

instruments -w your_ios_udid -t 
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Instruments/PlugIns/AutomationInstrument.bundle/Contents/Resources/Automation.tracetemplate 
name_of_your_app -e UIASCRIPT absolute_path_to_the_test_file 

例如,使用我自己的机子,就这么写的:

instruments -w a2de620d4fc33e91f1f2f8a8cb0841d2xxxxxxxx -t 
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Instruments/PlugIns/AutomationInstrument.bundle/Contents/Resources/Automation.tracetemplate 
TestAutomation -e UIASCRIPT 
/Users/jc/Documents/Dev/TestAutomation/TestAutomation/TestUI/Test-2.js 

clip_image002

如果你使用的Xcode版本低于4.3的话,你需要这样写:

instruments -w your_ios_device_udid -t /Developer/Platforms/iPhoneOS.platform/Developer/Library/Instruments/PlugIns/AutomationInstrument.bundle/Contents/Resources/Automation.tracetemplate TestAutomation -e UIASCRIPT /Users/jc/Documents/Dev/TestAutomation/TestAutomation/TestUI/Test-2.js 

一个小提示,不要忘了关闭你设备的密码验证,否则你会看到这样的日志信息的:remote exception encountered : ’device locked : Failed to launch process with bundle identifier ’com.manbolo.testautomation’. 的确,因为UIAutomation根本不知道你的密码啊。

命令行终端同样可以在模拟器上使用,但你需要知道待测应用程序在文件系统中的绝对路径。模拟器将目录~/Library/Application Support/iPhone Simulator/5.1/ “模拟”成了设备的文件系统。在这个目录下,你可以找到一个包含装在模拟器上的所有应用程序的沙盒的Applications文件夹。定位到TestAutomation程序的目录,然后:

instruments -t /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Instruments/PlugIns/AutomationInstrument.bundle/Contents/Resources/Automation.tracetemplate "/Users/jc/Library/Application Support/iPhone Simulator/5.1/Applications/C28DDC1B-810E-43BD-A0E7-C16A680D8E15/TestAutomation.app" -e UIASCRIPT /Users/jc/Documents/Dev/TestAutomation/TestAutomation/TestUI/Test-2.js

最后,如果你没有指定日志输入到哪里的话,你的测试结果会被放到你命令行当前指定(工作)的目录下。你可以通过加入 -e UIARESULTSPATH results_path 参数来指定日志输入目录。

我没有成功的将多个测试脚本并行着在命令行中运行起来。但是你可以将你的测试脚本串连进来,有一整晚去跑它,这样就真正的实现了“在你睡着的时候”,就完成了对应用程序的测试。

使用录制交互功能

除了手动的编写脚本,你还可以直接在设备上或者模拟器上录制脚本,然后替换掉原来的。下面是步骤:

1. 启动Instruments (⌘I)

2. 创建一个新的脚本

3. 选择脚本编辑器

clip_image003

4. 在脚本编辑器的底端,你是否看到了一个红色的按钮?点击它!

clip_image004

5. 现在,你可以操作你的应用程序;你将看到录制的交互操作出现在脚本窗口(甚至旋转事件)。点击方形按钮来停止录制。

clip_image005

当遇到问题时,加上“UIATarget.delay(1);

当你在编写脚本的时候,你总是在与时间,动画打交道。UIAutomation有很多方式去获取控件元素,然后等待它们变为可用状态,即使有时候它们还没有显示出来,但根据这篇文档里提到的,最好的建议是:

当遇到问题时,加上UIATarget.delay(1);!

4. 高级交互

处理非预期和预期的提示框(alerts

在写自动化测试过程中,处理提示框是很难的一件事情:你已经很认真的写好了你的测试用例,然后在你准备睡觉之前将它跑起来,然后,到第二天早上,你发现你的测试用例被一个未知消息提示框给毁了。然而,UIAutomation帮助你处理了这种情况。

通过下面代码来实现:

UIATarget.onAlert = function onAlert(alert){
	var title = alert.name();
	UIALogger.logWarning("Alert with title ’" + title + "’ encountered!");
	return false; // use default handler
}

它返回一个false,UIAutomation会自动的帮你销毁UIAlertView窗口,因此提示框就不会再影响你的测试了。你的测试脚本就永远不会有提示框弹出了。但是提示框可能是你应用程序的一部分,涉及到你测试的流程,所以,有时候,你不希望它被自动的处理掉。这时,你可以根据提示框的标题来决定,点击某个按钮,然后返回true。通过返回true,你向UIAutomation指定这个提示框必须作为测试的一部分来考虑。

例如,如果你想当提示框的标题为“Add Something”时,点击“Add”按钮,你可以这么写:

UIATarget.onAlert = function onAlert(alert) {
	var title = alert.name();
	UIALogger.logWarning("Alert with title ’" + title + "’ encountered!");
	if (title == "Add Something") {
		alert.buttons()["Add"].tap();
		return true; // bypass default handler
	}
	return false; // use default handler
}

容易吧?

多任务

测试你的应用程序的多任务是非常容易的事:假设你想测试每次启动一个疯狂的后台进程,将程序放到后台执行,并进入(void)applicationWillEnterForeground:(UIApplication *)application选择器代码段,你可以通过下面的代码来将它推至后台,然后等待10秒后自动返回活动状态。.

UIATarget.localTarget().deactivateAppForDuration(10);

deactivateAppForDuration(duration) 方法会暂停测试脚本的执行,模拟用户点击Home按钮,(即将程序放到后台),等待,然后为你重新激活程序和测试脚本,就这么一行代码而已!

屏幕方向

最后,你可以模拟你的iPhone的旋转方向。也是很直观很简单:

var target = UIATarget.localTarget();
var app = target.frontMostApp();
// set landscape left
target.setDeviceOrientation(UIA_DEVICE_ORIENTATION_LANDSCAPELEFT);
UIALogger.logMessage("Current orientation is " + app.interfaceOrientation());
// portrait
target.setDeviceOrientation(UIA_DEVICE_ORIENTATION_PORTRAIT);
UIALogger.logMessage("Current orientation is " + app.interfaceOrientation()); 

 

5. 总结

有用的链接

这篇文章有点儿长,但我希望你们能见识到UIAutomation是很强大的,且你的应用程序是可以得到质量的保障的。网上没有太多的UIAutomation的资料,但我还是列出了很多链接,也许能帮到你。

当然还有:

你需要一个免费的开发者账号去访问这些资源。

一个视频

在介绍完UIAutomation之后,我不反对向你们展示我们是如何使用在Meon中使用 UIAutomation的一段小视频。我们使用了各种测试,在这个视频中,我们测试了玩家可以从0级玩到120级。帮帮我,我的iPhone还活着呢!

http://player.vimeo.com/video/39888743?title=0&byline=0&portrait=0

jc

 

本文由知平软件的Dawson Liu翻译,转载请注明出处。

知平软件致力于移动平台自动化测试技术的研究,我们希望通过向社区贡献知识和开源项目,来促进行业和自身的发展。