1、什么是monkey？

Monkey是一个命令行工具，使用安卓调试桥(adb)来运行它，模拟用户触摸屏幕、滑动Trackball、按键等随机事件流来对设备上的程序进行压力测试，检测程序多久的时间会发生异常,可以根据获取的log信息进行修复。

注：运行adb服务，需要搭建android sdk的环境，可以参考我另一篇《APP压力稳定性测试之monkey环境搭建》完成。

2、Monkey的一般使用步骤

1.先确认设备（模拟器或者真机）是否连接成功。命令：adb devices，出现设备号则表示连接成功

2.确定待测应用的包名。参考如下

 1）打开待测应用后，输入命令：adb shell dumpsys activity | find “mFocusedActivity”

  例图，我开启腾讯课堂的应用，输入命令后，得到包名为com.tencent.edu

2）adb shell进入shell界面，通过查看data/data下的程序包，根据关键字查找包名

3.执行monkey测试命令：adb shell monkey -p com.tencent.edu -v -v 200

这个命令的意思就是，向腾讯课堂app发送200次随机事件流操作，且打印日志

3、Monkey的常见命令

-help 查看monkey用法

命令格式：adb shell monkey [限制命令 参数值][事件名 百分比] 事件次数

-p <allowed-package-name>

   用于约束限制，用此参数指定一个或多个包。指定包之后，Monkey将只允许系统启动指定的APP。如果不指定包，Monkey将允许系统启动设备中的所有APP。指定多个包，使用多个-p，一个-p后面接一个包名。

例： adb shell monkey -p com.android.browser -p com.tencent.edu -v 100

-v 用于指定反馈信息级别（信息级别就是日志的详细程度），总共分3个级别

-v，日志级别 Level0；

-v -v，日志级别 Level 1；

-v -v -v，日志级别 Level 2；

要查看级别最高的日志，例：adb shell monkey -p com.tencent.edu -v -v -v 100

-s 用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。一般测试过程中出现崩溃，可以通过seed值来完成复现。

–throttle <毫秒> 用于指定用户操作（即事件）间的时延，单位是毫秒；

–randomize-throttle  用这个参数必须与–throttle 绑定使用。用于在事件之间插入随机延迟，随机延迟范围为0到throttle设置的时间，单位为毫秒；

例：adb shell monkey -p com.tencent.edu –throttle 500 –randomize-throttle 100

–pkg-whitelist-file  白名单，后面接txt文件，指定白名单参数后只测试白名单的应用程序

–pkg-blacklist-file  黑名单，后面接txt文件，指定黑名单参数后，避开黑名单的应用程序

例：adb shell monkey –pkg-whitelist-file /data/local/tmp/whitelist.txt 100

注：黑白名单命令不能同时使用

Monkey百分比事件

0：点击事件百分比，即参数–pct-touch

1：滑动事件百分比，即参数–pct-motion

2：缩放事件百分比，即参数–pct-pinchzoom

3：轨迹球事件百分比，即参数–pct-trackball

4：屏幕旋转事件百分比，即参数–pct-rotation

5：基本导航事件百分比，即参数–pct-nav

6：主要导航事件百分比，即参数–pct-majornav

7：系统按键事件百分比，即参数–pct-syskeys

8：Activity启动事件百分比，即参数–pct-appswitch

9：键盘唤出隐藏事件百分比，即参数–pct-flip

10：其他事件百分比，即参数–pct-anyevent

例：adb shell monkey -p com.tencent.edu –pct-touch 10 -v -v 100

4、MonkeyScript

MonkeyScript是monkey的脚本语言，是一组可以被Monkey识别的命令集合，可以帮我们完成一系列的被固定的重复性操作。 

脚本优势：简单、快捷、不需要借助任何工具，只是运行一个脚本文件

脚本缺点：只能简单实现坐标、按键等基本操作（根据像素点来进行操作）

<脚本格式>

#头文件、控制monkey发送消息的参数

type=raw events

count=10

speed=1.0

#以下为monkey命令

start data >>

LaunchActivity(pkg_name,activity)

DispatchPress(KEYCODE_ENTER)

DispatchPress(KEYCODE_HOME)

—->前三行是脚本头。count为脚本中包含的指令数目。speed为执行速度。

—->start data >>后面是执行的命令。

<常见API>

LaunchActivity(pkg_name, cl_name): 启动应用的Activity。参数：包名和启动的Activity。

Tap(x, y, tapDuration): 模拟一次手指单击事件。参数：x,y为控件坐标，tapDuration为点击的持续时间，此参数可省略。

DispatchPress(keyName): 按键。注：keyName值可以百度android keycode列表获取

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(): 唤醒屏幕。

ProfileWait: 等待5秒。

—->在android sdk路径-tools下，使用sdk中的工具hierarchyviewer.bat或者uiautomatorviewer.bat，获取API方法中控件位置(X,Y轴的坐标)。  

<脚本举例>

要求：打开浏览器，输入www.ningmengban.com， 退出浏览器。这个步骤进行重复压力测试。

—->脚本文件browser.txt编写内容如下：

#头文件、控制monkey发送消息的参数

type=raw events

count=10

speed=1.0

#以下为脚本正文

start data >>

#1.打开浏览器

LaunchActivity(com.android.browser,com.android.browser.BrowserActivity)

ProfileWait()

#2.清空网址

Tap(223,146)

ProfileWait()

DispatchPress(112)

ProfileWait()

#3.输入网址

DispatchString(www.ningmengban.com)

ProfileWait()

#4.确认，载入网址

DispatchPress(KEYCODE_ENTER)

ProfileWait()

#5.完成退出浏览器

DispatchPress(KEYCODE_HOME)

ProfileWait()

–—>将browser.txt文件push到手机中

adb push D:\browser.txt data/local/tmp

D:\browser.txt 为本地脚本文件路径及名称，data/local/tmp为手机路径

—->运行脚本

adb shell monkey -f data/local/tmp/browser.txt -v -v 200

5、补充小知识：

1>如何安装apk？

adb install xxx.apk —–为了获取apk的安装包所在地址，可以直接把apk拖到cmd的窗口获取，返回success就说明安装成功了！

2>如何将本地文件上传到手机端？

adb push <本机路径> <手机路径>

例，将本地的白名单上传到手机端，adb push F:\whitelist.txt data/local/tmp

3>如何将日志保存到PC端?

adb shell monkey -v -v -v 1000 > 本机地址

例：adb shell monkey -v -v -v 1000 > d:\monkey.txt 

4>日志查看补充

—->先把日志输出到本地

—->注意观察switch后面的内容，一般错误都会显示在这个后面

—->ANR问题：日志中搜索ANR关键字

—->奔溃问题：在日志中搜索Exception问题

~~更多问题欢迎大家留言，也欢迎加右上角群号一起讨论~~