【monkeyrunner】monkeyrunner 的的方法介绍

1.用法：MonkeyRunner.alert(message,title,okTitle)

执行当前脚本弹出一个警示对话框，用户关闭对话框后脚本才结束。

message：会话弹出的内容
title：会话标题，默认为alert
okTitle：会话确认按钮，默认为ok
返回值：nothing。
2、com.android.monkeyrunner.MonkeyDevice.broadcastIntent
对设备发送一个广播信号。
用法：MonkeyDevice.broadcastIntent(uri,action,data,mimetype,categories,extras,component,flags)
uri：信号的uri
action：
data
mimetype
categories
extras
component
flags
返回值: nothing。
3、com.android.monkeyrunner.MonkeyRunner.choice
显示一个对话框，让用户从一列选项中选择一个单一的选项。
用法：MonkeyRunner.choice(message,choices,title)
message：显示在对话框中的提示信息。
choices：一个迭代的包含一系列选择的python类型
title：对话框的标题，默认为input
返回值: The 0-based numeric offset of the selected item in the iterable.
4、com.android.monkeyrunner.MonkeyImage.convertToBytes
将图片转换为其他特殊的格式，将结果作为字符串返回，用这个方法将像素存取为特殊的格式，输出的字符串是一种更好的表现。
用法：MonkeyImage.convertToBytes(format)
format：目标格式，默认值为png。
返回值: 目标图片格式的字符串
5、com.android.monkeyrunner.MonkeyDevice.drag
在设备屏幕上模拟拖曳。
用法：MonkeyDevice.drag(start,end,duration,steps)
start：拖曳开始坐标 - The starting point for the drag (a tuple (x,y) in pixels)
end：拖曳结束坐标点- The end point for the drag (a tuple (x,y) in pixels
duration：持续时间 - Duration of the drag in seconds (default is 1.0 seconds)
steps：拖曳步骤- The number of steps to take when interpolating points. (default is 10)
Returns: returns nothing.
6、com.android.monkeyrunner.MonkeyDevice.getHierarchyViewer
获取设备的显示层次。
用法：MonkeyDevice.getHierarchyViewer()
返回值：一个HierarchyViewer类型的对象。
7、com.android.monkeyrunner.MonkeyDevice.getProperty
在设备上给出变量的名称，返回变量的值。
用法：MonkeyDevice.getProperty(key)
key：变量的名称（key列表参加）
返回值：变量的值The variable's value
8、com.android.monkeyrunner.MonkeyImage.getRawPixel
在x,y位置处获取一个单个的ARGB像素，参数x，y都是基于0坐标，表示一个像素尺寸，x向右增益，y向下增益，这个方法返回一个数组。
用法：MonkeyImage.getRawPixel(x,y)
x：x偏移
y：y偏移
Returns: A tuple of (A, R, G, B) for the pixel. Each item in the tuple has the range 0-255.
9、com.android.monkeyrunner.MonkeyImage.getRawPixelInt
同上.getRawPixel，只是返回的是一个整型。
用法：MonkeyImage.getRawPixelInt(x,y)
x：x偏移
y：y偏移
Returns: An unsigned integer pixel for x,y. The 8 high-order bits are A, followedby 8 bits for R, 8 for G, and 8 for B.
10、com.android.monkeyrunner.MonkeyImage.getSubImage
复制一个图片的矩形区域。
用法：MonkeyImage.getSubImage(rect)
rect：A tuple (x, y, w, h)，x，y指定矩形区域的左上角，w为矩形宽，h为矩形高
返回：一个表示复制区域的图形对象。a MonkeyImage object representing the copied region.
11、com.android.monkeyrunner.MonkeyDevice.getSystemProperty
getProperty的同义。
用法：MonkeyDevice.getSystemProperty(key)
key：系统变量的名称。
返回：系统变量的值
12、com.android.monkeyrunner.MonkeyRunner.help
显示monkeyrunner的API。
用法：MonkeyRunner.help(format)
format：The desired format for the output, either 'text' for plain text or 'html' for HTML markup.
Returns: A string containing the help text in the desired format
13、com.android.monkeyrunner.easy.By.id
id - The identifier of the object.
Returns: returns nothing.
14、com.android.monkeyrunner.MonkeyRunner.input
显示一个接受的对话框，用户点击对话按钮中的一个菜结束。
用法：MonkeyRunner.input(message,initialValue,title,okTitle,cancelTitle)
message：对话框显示的信息。The prompt message to display in the dialog.
initialValue：提供给用户的初始化值，默认为空字符串。The initial value to supply to the user. The default is an empty string)
title：对话标题，默认为input。The dialog's title. The default is 'Input'
okTitle：The text to use in the dialog's confirmation button. The default is 'OK'.
cancelTitle：The text to use in the dialog's 'cancel' button. The default is 'Cancel'.
返回: The test entered by the user, or None if the user canceled the input;。
15、com.android.monkeyrunner.MonkeyDevice.installPackage
在设备上安装应用包，如果该包已经存在，那么体会掉原来的。
用法：MonkeyDevice.intallPackage(path)
path：安装包在本地的路径已经文件名。
返回值：如果安装成功返回true，否则false。
16、com.android.monkeyrunner.MonkeyDevice.instrument
运行测试设备的指定包。
用法：MonkeyDevice.instrument(className,args)
className：测试设备要执行的类，格式为packagename/classname，
args：不会翻译。A map of strings to objects containing the arguments to pass to this instrumentation (default value is None).
返回：单个键值对，key-value，key为steam，value为包含测试输出的字符串。
17、com.android.monkeyrunner.MonkeyRunner.loadImageFromFile
Loads a MonkeyImage from a file.不会翻译
用法：MonkeyRunner.loadImageFromFile(path)
path：文件的路径，路径为电脑端路径。
返回：表示指定文件的MonkeyImage对象。
18、com.android.monkeyrunner.MonkeyDevice.press
给指定key发送一个key事件。
用法：MonkeyDevice.press(name,type)
name：keycode（参考android.view.KeyEvent）
type：触摸事件类型，如DOWN_AND_UP。
return：nothing。
19、com.android.monkeyrunner.MonkeyDevice.reboot
重启指定设备进入指定加载模式。
用法：MonkeyDevice.reboot(into)
into：bootloader, recovery, or None
return：nothing
20、com.android.monkeyrunner.MonkeyDevice.removePackage
从设备删除指定的包，包括相关的数据已经缓存。
用法：MonkeyDevice.removePackage(package)
package：指定要删除的包名
return：删除成功则返回true。
21、com.android.monkeyrunner.MonkeyImage.sameAs
Compare this MonkeyImage object to aother MonkeyImage object.
用法：MonkeyImage.sameAs(other,percent)
other：其他MonkeyImage对象
percent：百分比，取值为0.0-1.0
return：如果一致返回true
22、com.android.monkeyrunner.MonkeyDevice.shell
执行adb shell命令并返回结果。
用法：MonkeyDevice.shell(cmd)
cmd：要执行的adb shell命令
return：命令的输出
23、com.android.monkeyrunner.MonkeyRunner.sleep
暂停当前运行进程指定的时间。
用法：MonkeyRunner.sleep(seconds)
seconds：暂停时间
return：nothing
24、com.android.monkeyrunner.MonkeyDevice.startActivity
在设备上开始一个活动，
用法：MonkeyDevice.startActivity(uri,action,data,mimetype,categories,extras,component,flags)
uri：
action：
data：
mimetype：
categories：
extras：
component：
flags：
return：nothings
25：com.android.monkeyrunner.MonkeyDevice.takeSnapshot
获取设备的屏幕缓存
用法：MonkeyDevice.takeSnapshot()
return：一个MonkeyImage对象。
26、com.android.monkeyrunner.MonkeyDevice.touch
对指定位置发送一个触摸事件
用法：MonkeyDevice.touch(x,y,type)
x：
y：
type：触摸事件类型。
return：nothing
27、com.android.monkeyrunner.MonkeyDevice.type
从键盘键入指定的字符串，这相当于字符串的每一个字符都执行一次press（keycode，DOWN_AND_UP）方法。
用法：MonkeyDevice.type(message)
message：发送到键盘的字符串
Returns: returns nothing.
28、com.android.monkeyrunner.MonkeyRunner.waitForConnection
等待电脑连接到设备。
用法：MonkeyRunner.waitForConnection(timeout,deviceId)
timeout：等待的时间，默认为无限期
deviceId：指定设备名称的一个规定表达式
Returns: 一个表示已经连接的设备对象，A MonkeyDevice object
29、com.android.monkeyrunner.MonkeyDevice.wake
唤醒设备的屏幕
用法：MonkeyDevice.wake()
Returns: returns nothing.
30、com.android.monkeyrunner.MonkeyImage.writeToFile
将MonkeyImage对象写入一个文件，
用法：MonkeyImage.writeToFile(path,format)
path：输入的文件名，可选择的包含路径
format：目标格式，默认为png。
return：如果输出成功返回true。