MonkeyScript
MonkeyScript的简单使用
一、 什么是MonkeyScript
MS 是官方提供的，除了像猴子一样随机乱点之外，还可以通过编写脚本的形式，完成一系列固定的操作。MS 提供一整套完善的 API 来进行支持，主要还是基于坐标点的操作，包含常用的：点击、长按、输入、等待等操作。
二、 MonkeyScript的使用
- 编写MonkeyScript的测试脚本。
MS脚本只要是文本即可，不关心后缀是什么，所以编写时不要添加后缀，保存文本格式即可。
MS 脚本虽然有一些指定的 API ，但是也有一些固定的脚本头，需要写在脚本的最前面。
type=user
count = 1
speed = 1.0
start data >>
在脚本中，脚本头是一直不变动的，为了避免写错，可以直接复制粘贴最保险。在 start data>> 之后就可以正式开始编写 monkey 脚本了，在脚本中，使用 # 号，对单行进行注释。
MonkeyScript是需要指定Activity（当前app展示的界面）的，获取当前指定界面Activity名称的指令为adb shell dumpsys activity | grep mFocused。
下面以测试登录功能为例：
LaunchActivity(Activity)
UserWait(1000)
DispatchPointer(0,0,0,303,312,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,303,312,0,0,0,0,0,0,0)
UserWait(1000)
DispatchString(1234566)
UserWait(100)
//输入密码
DispatchPointer(0,0,0,345,393,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,345,393,0,0,0,0,0,0,0)
UserWait(100)
DispatchString(1234567)
UserWait(1000)
//点击空白处让键盘消失
DispatchPointer(0,0,0,100,100,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,100,100,0,0,0,0,0,0,0)
UserWait(1000)
//点击登录按钮
DispatchPointer(0,0,0,361,507,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,361,507,0,0,0,0,0,0,0)
UserWait(3000)
脚本解释：
首先启动你要测试的界面，此处为登录界面，登录界面有三个控件，用户名的textField，密码的textField，和登录按钮。
LaunchActivity()
作用为来到登录界面
UserWait(1000)
等待1秒以后执行下一个操作
DispatchPointer(0,0,0,303,312,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,303,312,0,0,0,0,0,0,0)
DispatchPointer点击用户名的textField，只需关注3，4，5这三个参数即可，第三个参数为0表示点击了textField ，为1表示松开了textField，4，5两个参数分别为用户名textField 的x，y坐标。
DispatchString(123456)
在用户名的textField中输入123456用户名
按照上面的操作在密码的textField输入密码，点击登录按钮，整改登录测试就完成了，如果需要继续测试登录后的界面则需要从新启动新的Activity。
//登录成功后来到首页点击发布作业功能（具体什么功能和第4，5个参数设置的值有关）
LaunchActivity(Activity)
UserWait(1000)
DispatchPointer(0,0,0,650,182,0,0,0,0,0,0,0)
DispatchPointer(0,0,1,650,182,0,0,0,0,0,0,0)
UserWait(1000)
Drag(500,1500,500,500,12)
#向上滑动将写好的脚本保存到本地。
2. Monkey 启动 MonkeyScript 的命令如下：
adb shell monkey -f <MonkeyScript> <EventCount>
<MonkeyScript>指你编写的MonkeyScript脚本，
<EventCount>指Monkey事件，例如执行次数，日志详情等。
具体指令：
- adb shell mkdir /sdcard/script 在设备上创建script文件夹用于存放脚本
- 将本地脚本文件push到设备中上面创建的文件夹中。例如adb push /Users/userName/Desktop/testLogin空格/sdcard/script，/Users/userName/Desktop/testLogin就是你脚本在本地的存放路径。
- 执行adb shell monkey -f /sdcard/script／你的脚本名称 –v –v 10 >C:\monkey.txt即可，>C:\monkey.txt为日志输出路径。
其他简介
LaunchActivity(pkg_name, cl_name)：启动应用的Activity。参数：包名和启动的Activity。
Tap(x, y, tapDuration)： 模拟一次手指单击事件。参数：x,y为控件坐标，tapDuration为点击的持续时间，此参数可省略。
DispatchPress(keyName)： 按键。参数： keycode。 详细的Android Keycode列表： http://blog.csdn.net/feizhixuan46789/article/details/16801429
RotateScreen(rotationDegree, persist)： 旋转屏幕。 参数：rotationDegree为旋转角度， e.g. 1代表90度；persist表示旋转之后是否固定，0表示旋转后恢复，非0则表示固定不变。
DispatchFlip(true/false)： 打开或者关闭软键盘。
LongPress()： 长按2秒。
PressAndHold(x, y, pressDuration)： 模拟长按事件。
DispatchString(input)： 输入字符串。
Drag(xStart, yStart, xEnd, yEnd, stepCount)： 用于模拟一个拖拽操作。
PinchZoom(x1Start, y1Start, x1End, y1End, x2Start, y2Start, x2End, y2End, stepCount)： 模拟缩放手势。
UserWait(sleepTime)： 休眠一段时间
DeviceWakeUp()： 唤醒屏幕。
PowerLog(power_log_type, test_case_status)： 模拟电池电量信息。
WriteLog()： 将电池信息写入sd卡。
RunCmd(cmd)： 运行shell命令。
DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFlags)： 向指定位置，发送单个手势。
DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFilags)： 发送按键消息。
LaunchInstrumentation(test_name,runner_name)： 运行一个instrumentation测试用例。
DispatchTrackball： 模拟发送轨迹球事件。
ProfileWait： 等待5秒。
StartCaptureFramerate()： 获取帧率。
EndCaptureFramerate(input)： 结束获取帧率。
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
作为移动端测试必须掌握的初级Android稳定性工具：monkey，提到它时，脑海里一般涌现出两句话：
1.我会用，很简单
就是一行命令，一回车就开始跑起来了
2.使用问题多，不好用
太随机，很多操作没意义
达到深层页面的概率极低
虽然加了各种忽略异常，但是monkey进程还是经常死掉
无法有针对性（指定页面or指定操作）的测试 ，等等
带着这些问题，将更智能的monkey介绍给大家
智能monkey之monkeyscript（一）
解决问题：
有针对性的指定操作进行稳定性测试
需求（参考搜狗搜索APP）：
启动app，搜索1次，退出。重复1万次
Script：
type=user
count=10
speed=1.0
start data >>
LaunchActivity(com.sogou.activity.src, com.sogou.search.entry.EntryActivity)
UserWait(3000)
captureDispatchPointer(10,10,0,500,500,1,1,-1,1,1,0,0)
captureDispatchPointer(10,10,1,500,500,1,1,-1,1,1,0,0)
UserWait(500)
captureDispatchString(test)
UserWait(500)
captureDispatchPress(66)
UserWait(3000)
Drag(500,1500,500,500,500)
captureDispatchPress(4)
UserWait(1000)
captureDispatchPress(4)
captureDispatchPress(4)
script逐行解释：
type=user
count=10
speed=1.0
start data >>
#固定头部，参数和值均不影响脚本
LaunchActivity(com.sogou.activity.src, com.sogou.search.entry.EntryActivity)
#启动app，参数1：包名，参数2：主activity名
UserWait(1500)
#等待1500毫秒
captureDispatchPointer(10,10,0,500,500,1,1,-1,1,1,0,0)
#按下坐标500,500（搜索框位置）
captureDispatchPointer(10,10,1,500,500,1,1,-1,1,1,0,0)
#抬起坐标500,500（搜索框位置）
UserWait(500)
#等待500毫秒
captureDispatchString(test)
#在搜索框输入“test”
captureDispatchPress(66)
#输入回车进行搜索
UserWait(3000)
#等待3000毫秒
Drag(500,1500,500,500,500)
#上划浏览搜索结果页
captureDispatchPress(4)
#输入back回退至app首页
UserWait(500)
等待500毫秒
captureDispatchPress(4)
captureDispatchPress(4)
#双back退出app
运行：
1.将脚本保存命名（例test_search）
2.将脚本文件放置测试机中
adb shell mkdir /sdcard/script
#创建脚本文件夹
adb push test_search /sdcard/script
#将脚本文件push到文件夹
3.运行脚本文件1万次
adb shell monkey -f /sdcard/script/test_search 10000
运行效果：
附件1
Monkeyscript API介绍
#单点事件
DispatchPointer(downTime,eventTime,action,x,y,pressure,size,metaStat,xPrecision,yPrecision,device,edgeFlags)
downTime,//touchdown的时间
eventTime,//touch时间发生的时间
action,//Action code: either {@link #ACTION_DOWN=0}, {@link #ACTION_UP=1}, or {@link #ACTION_MULTIPLE=2}. 如果时间是0,2,1可以模拟滑屏
x, //The X coordinate of this event.
y, //The Y coordinate of this event.
pressure, //The current pressure of this event. The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), however values higher than 1 may be generated depending on the calibration of the input device.
size, //A scaled value of the approximate size of the area being pressed touched with the finger. The actual value in pixels corresponding to the finger touch is normalized with a device specific range of values and scaled to a value between 0 and 1.
metaStatex //The state of any meta / modifier keys that were in effect when the event was generated.
xPrecision, //The precision of the X coordinate being reported.
yPrecision, //The precision of the Y coordinate being reported.
deviceId, //The id for the device that this event came from. An id of zero indicates that the event didn't come from a physical device; other numbers are arbitrary and you shouldn't depend on the values.
edgeFlags, // A bitfield indicating which edges, if any, where touched by this MotionEvent
example:
DispatchPointer(0,0,0,830,1000,0,0,0,0,0,0,0); touchDown
DispatchPointer(0,0,1,830,1000,0,0,0,0,0,0,0);touchUp
#拖动
Drag(x1,y1,x2,y2,stepCount)
example:
快速下滑：Drag(300,500,300,300,15)
快速上滑：Drag(300,300,300,500,15)
#双指缩放
PinchZoom(xstart1,ystart1,xstart2,ystart2,xend2,yend2,xend1,yend1,step)
example:
#放大
PinchZoom(400,400,200,300,550,550,700,700,3);
#cmd: shell命令
RunCmd(cmd)
example
RunCmd(monkey -v 1000)
#发送tap事件（一个touchdown和touch up事件），时间长可以模拟长按，时间单位为ms
Tap(x,y,tapDuration)
#启动唤醒设备
DeviceWakeUp()
#获取最后一个touch时间的点做长按
LongPress()
#按住duration时长
PressAndHold(x,y,duration)
#屏幕旋转
RotateScreen(rotationDegree,persist)
// rotationDegree只能支持0,90,180,270
// persist 0/1
// 对指定keycode模拟touch事件(keycode列表见尾部)
DispatchKey(downTime,eventTime,action,code,repeat,metaState,device,scancode)
// 对指定keycode模拟press事件
DispatchPress(KeyCode)
KEYCODE列表
电话键
| 键名 | 描述 | 键值 |
|---|---|---|
| KEYCODE_CALL | 拨号键 | 5 |
| KEYCODE_ENDCALL | 挂机键 | 6 |
| KEYCODE_HOME | 按键Home | 3 |
| KEYCODE_MENU | 菜单键 | 82 |
| KEYCODE_BACK | 返回键 | 4 |
| KEYCODE_SEARCH | 搜索键 | 84 |
| KEYCODE_CAMERA | 拍照键 | 27 |
| KEYCODE_FOCUS | 拍照对焦键 | 80 |
| KEYCODE_POWER | 电源键 | 26 |
| KEYCODE_NOTIFICATION | 通知键 | 83 |
| KEYCODE_MUTE | 话筒静音键 | 91 |
| KEYCODE_VOLUME_MUTE | 扬声器静音键 | 164 |
| KEYCODE_VOLUME_UP | 音量增加键 | 24 |
| KEYCODE_VOLUME_DOWN | 音量减小键 | 25 |
控制键
| 键名 | 描述 | 键值 |
|---|---|---|
| KEYCODE_ENTER | 回车键 | 66 |
| KEYCODE_ESCAPE | ESC键 | 111 |
| KEYCODE_DPAD_CENTER | 导航键 确定键 | 23 |
| KEYCODE_DPAD_UP | 导航键 向上 | 19 |
| KEYCODE_DPAD_DOWN | 导航键 向下 | 20 |
| KEYCODE_DPAD_LEFT | 导航键 向左 | 21 |
| KEYCODE_DPAD_RIGHT | 导航键 向右 | 22 |
| KEYCODE_MOVE_HOME | 光标移动到开始键 | 122 |
| KEYCODE_MOVE_END | 光标移动到末尾键 | 123 |
| KEYCODE_PAGE_UP | 向上翻页键 | 92 |
| KEYCODE_PAGE_DOWN | 向下翻页键 | 93 |
| KEYCODE_DEL | 退格键 | 67 |
| KEYCODE_FORWARD_DEL | 删除键 | 112 |
| KEYCODE_INSERT | 插入键 | 124 |
| KEYCODE_TAB | Tab键 | 61 |
| KEYCODE_NUM_LOCK | 小键盘锁 | 143 |
| KEYCODE_CAPS_LOCK | 大写锁定键 | 115 |
| KEYCODE_BREAK | Break/Pause键 | 121 |
| KEYCODE_SCROLL_LOCK | 滚动锁定键 | 116 |
| KEYCODE_ZOOM_IN | 放大键 | 168 |
| KEYCODE_ZOOM_OUT | 缩小键 | 169 |
