首页手记 Android应用自动化工具 MonkeyRunner

Android应用自动化工具 MonkeyRunner

标签：

Android 测试

这篇我们介绍从Android早期版本的SDK中就自带的一个黑盒自动化测试工具-MonkeyRunner。虽然这个工具名字中也有Monkey，但是MonkeyRunner和Monkey基本没有太大关系。Monkey是运行在Adb shell中的，实际执行在设备本身。而MonkeyRunner则是通过PC端，由Android的API接口来控制设备，进行自动化测试的执行，其主要逻辑是在PC端完成的。
MonkeyRunner支持用Jython(Python脚本的java实现，语法和Python一致)脚本完成自动化测试脚本，可以实现Monkey工具无法提供的逻辑控制、校验等功能。

在Google的官网上有对MonkeyRunner的介绍,并提供了一个脚本示例，实现了应用的安装、启动并对启动后的界面完成截屏操作。

# Imports the monkeyrunner modules used by this program
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice

# Connects to the current device, returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection()

# Installs the Android package. Notice that this method returns a boolean, so you can test
# to see if the installation worked.
device.installPackage('myproject/bin/MyApplication.apk')

# sets a variable with the package's internal name
package = 'com.example.android.myapplication'

# sets a variable with the name of an Activity in the package
activity = 'com.example.android.myapplication.MainActivity'

# sets the name of the component to start
runComponent = package + '/' + activity

# Runs the component
device.startActivity(component=runComponent)

# Presses the Menu button
device.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP)

# Takes a screenshot
result = device.takeSnapshot()

# Writes the screenshot to a file
result.writeToFile('myproject/shot1.png','png')

MonkeyRunner主要由三大模块组成：MonkeyRunner、MonkeyDevice、MonkeyImage

MonkeyRunner -- 包含一些通用的静态方法
MonkeyDevice -- MonkeyRunner可以控制的设备或模拟器的实体类，可以完成发送UI事件、获取设备信息、安装卸载运行应用等工作
MonkeyImage -- 图像处理类，可以获取当前设备屏幕并完成基本校验。

MonkeyRunner工具位于Android SDK的tools目录下，通过运行monkeyrunner.bat（Linux下monkeyrunner.sh）即可启动MonkeyRunner的交互界面:

>monkeyrunner
Jython 2.5.3 (2.5:c56500f08d34+, Aug 13 2012, 14:54:35)
[Java HotSpot(TM) 64-Bit Server VM (Oracle Corporation)] on java1.8.0_91
>>>

MonkeyRunner模块的主要方法

返回类型	方法	作用
void	alert (string message, string title, string okTitle)	显示一个弹出警告对话框
integer	choice (string message, iterable choices, string title)	显示一个带下拉选择的对话框
void	help (string format)	根据给定的format格式显示MonkeyRunner工具的API说明
string	input (string message, string initialValue, string title, string okTitle, string cancelTitle)	显示说明输入对话框
void	sleep (float seconds)	终止程序运行指定时间
MonkeyDevice	waitForConnection (float timeout, string deviceId)	建立MonkeyRunner和android设备之间的连接

这里最常用的是waitforconnection方法，返回一个MonkeyDevice对象，用于建立和设备的连接。

另外help这个方法可以生成一个MonkeyRunner的帮助文档，但大家在执行的时候可能会出错。

这应该是MonkeyRunner工具的一个bug. 因为这个方法需要调用的资源文件没有包含在SDK中，所以要使用这个方法，需要把MonkeyRunner源码中的resource目录拷贝到MonkeyRunner工具所在SDK目录的lib文件夹下，再执行这个方法就可以了

其他的几个方法主要是用于执行交互的对话框操作，比如alert对话框

MonkeyDevice模块的主要方法

返回类型	方法	作用
void	broadcastIntent (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, iterable flags)	模拟application对象向设备广播 Intent.
void	drag (tuple start, tuple end, float duration, integer steps)	触发拖动操作
object	getProperty (string key)	获取给定系统环境变量值，可用的变量清单参见detailed description
object	getSystemProperty (string key)	开发者调试方法，用法和adb shell getprop <key>.相同
void	installPackage (string path)	向设备安装应用，如果应用已存在，则替换
dictionary	instrument (string className, dictionary args)	运行指定的 instrumentation组件，组件必须已经保存在设备上了
void	press (string name, dictionary type)	根据给定的keycode执行press操作
void	reboot (string into)	重启设备
void	removePackage (string package)	删除应用，包括缓存和数据
object	shell (string cmd)	执行一个adb shell 命令
void	startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags)	通过发送一个Intent来启动指定Activity
MonkeyImage	takeSnapshot()	获取整个屏幕界面并返回一个MonkeyImage对象
void	touch (integer x, integer y, integer type)	发送一个点击指定坐标的touch事件
void	type (string message)	发送一组字符输入事件，和使用press方法来输入字符并发送按键事件DOWN_AND_UP效果相同
void	wake ()	唤醒设备屏幕

这个模块下主要是设备控制的相关操作，也是MonkeyRunner中实际承担自动化操作的主要模块。如启动一个计算器应用

MonkeyImage模块的主要方法

返回类型	方法	作用
string	convertToBytes (string format)	将图像转换为二进制字节码内容并以string返回
tuple	getRawPixel (integer x, integer y)	给出指定坐标处像素点的 (a,r,g,b)像素值
integer	getRawPixelInt (integer x, integer y)	给出指定像素点处的整形像素值
MonkeyImage	getSubImage (tuple rect)	根据给定区域生成一个新的MonkeyImage对象
boolean	sameAs (MonkeyImage other, float percent)	比较对象相似度
void	writeToFile (string path, string format)	将MonkeyImage对象保存到指定格式的图像文件中