MonkeyRunner常用类方法

MonkeyRunner的一些常用方法：

（详细参考：http://developer.android.com/tools/help/MonkeyRunner.html）

void alert (string message, string title, string okTitle)

弹出一个对话框，默认标题“警告”，按钮显示“确定”，可暂停当前的程序

例：MonkeyRunner.alert("hello world")

 

弹出一个hello world对话框

integer choice (string message, iterable choices, string title)

显示带有一列可选项的对话框,可暂停当前的程序，选择后返回integer对象，代表选择项的序列index

例：MonkeyRunner.choice("choice a sex",["man","women"])

 

弹出一个选择性别的对话框，选择man会返回0，选择women会返回2

string input (string message, string initialValue, string title, string okTitle, string cancelTitle)

显示一个输入框，接受输入后返回字符串

例：MonkeyRunner.input("enter text")

 

弹出一个输入框，输入后确认返回字符串

void sleep(float seconds)

暂停当前程序指定秒

例：MonkeyRunner.sleep(2)

暂停当前程序2秒

MonkeyDevice waitForConnection (float timeout, string deviceId)

timeout	等待连接时间，默认为一直等待.
deviceId	设备名，可通过adb devices查看当前连接设备名，一般可以不指定.

 

返回一个MonkeyDevice 实例

常用写法为：

device = MonkeRunner.waitForConnection()

通过获取到的device对象，可以调用MonkeyDevice的方法对设备进行操作。

MonkeyDevice的一些常用方法:

(详细参考：http://wiki.eoeandroid.com/MonkeyDevice)

void drag (tuple start, tuple end, float duration, integer steps)

例：device.drag((120,240),(200,240),1,10)

屏幕解锁操作，从（120,240）向（200,240）滑动，用时1秒，10为默认值

object getProperty (string key)

查询设备相关信息，参数参考：http://developer.android.com/tools/help/MonkeyDevice.html#table1

void installPackage (string path)

安装指定路径的APK文件。如果改文件已安装，则会覆盖安装

例：device.installPackage("d:/2100.apk")

安装D盘2100.apk，路径中使用 /

void press (string name, dictionary type)

模拟按钮操作。

name 为按键码，参考：http://docs.eoeandroid.com/reference/android/view/KeyEvent.html

type 为键盘事件类型. 可用的值有DOWN, UP, 和DOWN_AND_UP

void removePackage (string package)

删除指定的包，包括清除其数据和缓存

例：device.removePackage("evertone.Piano")

卸载piano程序，程序名通过aapt查看2100.apk文件，或者在shell模式下进入data/data目录下查找

void shell (string cmd)

执行shell命令并返回结果

例：device.shell("date")

执行shell命令，查询日期

void startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags)

启动一个应用，对于需要测试的应用需要知道应用名和入口activity名称。可以调用sdk\builds-tools目录下的aapt获取

aapt dump baging d:\2100.apk

 

startActivity常用形式为：

例：device.startActivity(component = "evertone.Piano/evertone.Piano.loading")

执行后启动手机弹钢琴

MonkeyImage takeSnapshot()

屏幕截图，返回包含当前显示截图的MonkeyImage对象

例：Pic = device.takeSnapshot()

手机屏幕截图，结果保存在Pic里。pic为MonkeyImage实例

void touch (integer x, integer y, integer type)

屏幕点击(x,y)。type 为键盘事件类型. 可用的值有DOWN, UP, 和DOWN_AND_UP

例：device.touch(93,143,"DOWN_AND_UP")

点击屏幕（93,143）位置。屏幕坐标获取可使用sdk\tools路径下的Hierarchyviewer工具

void type (string message)

向设备发送包含字符的信息，等同于多次调用press()方法。现在发现message中只能写数字、英文，不能有空格，否则会输入失败

例：device.type("123adc")

输入 123abc

void wake ()

唤醒屏幕。暂时没发现有什么用 =。=

MonkeyImage的一些常用方法：

（详细参考：http://wiki.eoeandroid.com/MonkeyImage）

MonkeyImage对象一般不用直接创建，在获取了MonkeyDevice对象后，调用takeSnapshot()方法即可

例：pic = MonkeyDevice.takeSnapshot()

string convertToBytes (string format)

将当前图像转换成特定格式，并且作为字符串返回

tuple getRawPixel (integer x, integer y)

返回图像位置坐标(x,y)上的单个像素点，作为一个整数元组，以(a,r,g,b)格式。可对特定点进行取色

MonkeyImage getSubImage (tuple rect)

从当前图片中取出部分区域，创建一个新的MonkeyImage对象。参数为元祖，指定截图区域

例：pic_new=pic.getSubImage((0,0,100,100))

boolean sameAs (MonkeyImage other, float percent)

对比两个MonkeyImage对象是否相等（比较截图是否一致）。参数percent指定两个图像之间差异在多少百分比之内可以看做“相等”。可进行自动化结果校验

例：pic2.sameAs(pic1,0.9)

pic2和pic1在90%范围内相似，则返回True，否则返回False

void writeToFile (string path, string format)

指定路径和格式，保存图片文件

例：pic1.writeToFile("d:/pic2.png","png")

指定图片格式为png，保存在本地d:/pic2.png路径。保存成功则返回True