monkey 入门篇（实战演练）

 

一：前期准备工作 ------------环境搭建

1、需要安装jdk,并配置相关环境变量

在“系统变量”中，设置3项属性，JAVA_HOME,PATH,CLASSPATH(大小写无所谓),若已存在则点击“编辑”，不存在则点击“新建”； 

 

      JAVA_HOME指明JDK安装路径，就是刚才安装时所选择的路径D:\java\jdk1.5.0_08，此路径下包括lib，bin，jre等文件夹（此变量最好设置，因为以后运行tomcat，eclipse等都需要依*此变量）； 

 

　　Path使得系统可以在任何路径下识别java命令，设为： 

 

　　%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin 

 

　 CLASSPATH为java加载类(class or lib)路径，只有类在classpath中，java命令才能识别，设为： 

 

　　.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar (要加.表示当前路径) 

 

　　%JAVA_HOME%就是引用前面指定的JAVA_HOME；

2、需要安装SDK

下载最新的Android SDK，解压

打开命令行 win+r 打开 输入 cmd 然后回车键

进入sdk adb.exe 目录下 及C:\Program Files\Android\android-sdk\platform-tools

输入 adb shell 即可

二：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

 

三：monkey 脚本 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问题

首先我们需要查看Monkey测试中是否出现了ANR或者异常，无响应问题（ANR问题）：在日志中搜索“ANR ”（此处有空格）， 崩溃问题：在日志中搜索“Exception”，快速定位到关键事件信息 。然后查看Monkey里面出错前的一些事件动作，并手动执行该动作，找出重现步骤，给开发。