Android测试之：MonkeyScript与MonkeyRunner常用API

MonkeyScript:一组可以被Monkey识别并执行的命令集合。目的是根据我们的需求完成重复固定的测试操作。MonkeyRunner:提供了一系统的API，通过这些API可以完成模拟事件及截图等操作。与Monkey的区别在于：通过API指定命令来控制设备，而Monkey是在adb shell中，生成伪随机事件，完成测试功能。

—常用MonkeyScript API——-

1，DispatchTrackball命令：用于向一个坐标点（即：x坐标，y坐标）发送跟踪球消息
DispatchTrackball(long downTime, long eventTime, int action, float x, float y, float pressure, float size, int metaState, float xPrecision, float yPrecision, int device, int edgeFlags)
参数介绍：
downTime //键最初被按下的时间

eventTime //事件发生的时间

action //ACTIVON事件类型比如ACTION_DOWN=0，ACTION_MOVE=1，ACTION_UP=2，ACTION_CANCEL=3

x //x坐标

y //y坐标

pressure //当前事件的压力，范围0-1

size //触摸的近似值，范围0-1

metaState //当前按下的meta键的标识

xPrecision //x坐标精确值

yPrecision //y坐标精确值

device //事件来源，范围0-x，0表示不来自物理设备

sedgeFlags // 通常写作0即可
2，DispatchPointer命令：用于向一个坐标点（即：x坐标，y坐标）发送手指点击事件消息
DispatchTrackball(long downTime, long eventTime, int action, float x, float y, float pressure, float size, int metaState, float xPrecision, float yPrecision, int device, int edgeFlags)
参数和上面方法一样。
3，DispatchKey 命令：发送键值
DispatchKey(long downTime, long eventTime, intaction, int code, int repeat, int metaState, int device, int scancode)
参数说明：
downTime，键最初被按下的时间

eventTime，事件发生的时间

action，action动作：ACTION_DOWN=0，ACTION_UP=1，ACTION_MULTIPLE=2

code，键值，参见附录A

repeat，重复次数

metaState，当前按下的meta键的标识

device，事件发生的设备id

scancode，上报点的信息

4，DispatchString命令：输入字符串事件命令
DispatchString(String text)
参数text:参数text不加引号，指输入字符串text到指定的输入框中。
5，LaunchActivity命令：启动应用命令
LaunchActivity(String pkgName, String clsName)
参数介绍 ：
pkgName：应用包名
clsName：要启动的Activity类名
6，UserWait命令：等待事件命令
UserWait(ong waittime);单位毫秒
7，DispatchPress命令：按下键盘上指定键的命令
DispatchPress(int keyCode)
参数：
keyCode:键对应的code值 ，比如回车键keyCode=66

8,DispatchFlip命令：开启软键盘命令
DispatchFlip(boolean open)：open表示是否打开软键盘，true为打开

—MonkeyRunner常用API：——-

1，watiForConnection：等待设备连接
waitForConnection(float fimeout,string deviceId)
参数介绍：
fimeout：超时时间，单位秒，浮点数。默认是无限期地等待。
deviceId：指定具体的设备id
2,alert:弹出警告框
alert(string message,string title,string okTitle)
参数介绍：
mesage:弹出框内容
title：弹出框标题
okTitle：弹出框确认键内容
3，drag:滑动（拖动）屏幕
drag(tuple start,tuple end,float duration,integer steps)
参数介绍：
start：开始位置
end：结束
duration：手势持续时间
steps：执行次数或步数，默认为10
4,press:模块按键按下操作
press(string keycode,dictionary type)
参数介绍：
keycode:按键code值，如menu键：KEYCODE_MENU，home键：KEYCODE_HOME，back键：KEYCODE_BACK，search键：KEYCODE_SEARCH等
type：类型：DOWN中UP，如果写DOWN_AND_UP则是按下和抬起两个动作
5，startActivity:启动Activity
startActivity(pkgNmae+”/”+activityName)
参数介绍：
pkgNmae+”/”+activityName：指格式为应用包名+“/”+启动的Activity名，如”com.ldm.test/.activity.FirstActivity”
6,touch:点击（触摸）操作
touch(integer x,integer y,integer type)
参数介绍：
x:x坐标值
y:y坐标值
type:类型，DOWN,UP及DOWN_AND_UP
7,type:输入内容操作
type(string content)
参数介绍：
content:输入的内容
8，takeSnapshot:截屏操作
takeSnapshot()
9,writeToFile:保存文件操作
writeToFile（string path,string format）
参数介绍：
path：保存路径
format：保存格式，如PNG,JEPG等
10，sameAs：图像对比操作。
学习中参考相关文章有：
http://www.51testing.com/html/81/22381-242682.html。
http://sanwen.net/a/xfezooo.html
http://blog.sina.com.cn/s/blog_b54ee2ac0101ccjz.html
http://blog.csdn.net/mad1989/article/details/38087737