monkey应用

1、命令

adb shell monkey -p com.djc.qcyzt --pct-touch 40 --pct-motion 25
–pct-appswitch 10 --pct-rotation 10 -s 1666 --throttle 200 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -v -v 100000 >d:\monkey.txt

2、Monkey 简介

Monkey 就是SDK中附带的一个工具。Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。

该工具用于进行压力测试。然后开发人员结合monkey 打印的日志和系统打印的日志，分析测试中的问题

3、Monkey 测试的特点

Monkey 测试,所有的事件都是随机产生的，不带任何人的主观性。
1、测试的对象仅为应用程序包，有一定的局限性。
2、Monky测试使用的事件数据流是随机的，不能进行自定义。
3、可对MonkeyTest的对象，事件数量，类型，频率等进行设置。

4、Monkey命令参数

4.1约束类参数

• -p
  如果用此参数指定了一个或几个包，Monkey将只允许系统启动这些包里的Activity。如果你的应用程序还需要访问其它包里的Activity(如选择取一个联系人)，那些包也需要在此同时指定。如果不指定任何包，Monkey将允许系统启动全部包里的Activity。要指定多个包，需要使用多个-p选项，每个-p选项只能用于一个包。

• -c
  如果用此参数指定了一个或几个类别，Monkey将只允许系统启动被这些类别中的某个类别列出的Activity。如果不指定任何类别，Monkey将选择下列类别中列出的Activity：Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY。要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别。

4.2调试类参数

• –kill-process-after-error
  通常，当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系统停发生错误的进程。注意，正常的(成功的)结束，并没有停止启动的进程，设备只是在结束事件之后，简单地保持在最后的状态。
• –monitor-native-crashes
  监视并报告Android系统中本地代码的崩溃事件。如果设置了–kill-process-after-error，系统将停止运行。
  应用程序权限错误发生后继续发送事件参数
• –ignore-crashes
  通常，当应用程序崩溃或发生任何失控异常时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成。
• –ignore-timeouts
  通常，当应用程序发生任何超时错误(如“Application Not Responding”对话框)时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成。
• –ignore-security-exceptions
  通常，当应用程序发生许可错误(如启动一个需要某些许可的Activity)时，Monkey将停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成。
• –dbg-no-events
  设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不会再进一步生成事件。为了得到最佳结果，把它与-v、一个或几个包约束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。
• –hprof
  设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在data/misc中生成大文件(~5Mb)，所以要小心使用它。
• –wait-dbg
  停止执行中的Monkey，直到有调试器和它相连接。

4.3常规类参数

• –help
  列出monkey的使用参数和说明
• -v
  命令行的每一个-v将增加反馈信息的级别。
  Level 0(缺省值)：除启动提示、测试完成和最终结果之外，提供较少信息。
  Level 1：提供较为详细的测试信息，如逐个发送到Activity的事件。
  Level 2：提供更加详细的设置信息，如测试中被选中的或未被选中的Activity

4.4事件类参数

• -s
  伪随机数生成器的seed值。如果用相同的seed值再次运行Monkey，它将生成相同的事件序列
• –throttle
  在事件之间插入固定延迟。通过这个选项可以减缓Monkey的执行速度。如果不指定该选项，Monkey将不会被延迟，事件将尽可能快地被产成。一般业内标准是每秒操作2-3次，即：–throttle 300到 --throttle 500

调整事件百分比

• –pct-touch
  调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)。
• –pct-motion
  调整手势/动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)。
• –pct-trackball
  调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)。
• –pct-nav
  调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)
• –pct-majornav
  调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)
• –pct-syskeys
  调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、Start Call、End Call及音量控制键)。
• –pct-appswitch
  调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法。
• –pct-anyevent
  调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等。

5、Monkey常用测试方法

5.1.对整机进行指定时间间隔的随机事件

a. adb shell monkey -v 100：对整机进行100次随机事件。
b. adb shell monkey -v --throttle 1000 100：对整机进行100次随机事件，每次事件的时间间隔为1000毫秒。
c. adb shell monkey -v -v -v --pct-touch100 --throttle 1000 100：对整机进行100次触摸事件，每次事件的时间间隔为1000毫秒。

5.2.对进程进行指定时间间隔的随机事件

adb shell monkey -v -p com.package.name --throttle 1000 100

5.3.使用Monkey进行压力测试

a． 验证程序的健壮性：adb shell Monkey -v -p com.package.name --throttle 100 10000
对指定应用进行10000次随机时间，每一次执行一次有效的事件后休眠100毫秒
b． 对程序进行指定压力测试：adb shell Monkey -v -p com.package.name --pct-touch 100 --throttle 100 10000
对指定应用进行10000次触摸事件，每次事件的时间间隔为100毫秒

5.4.对进程进行指定时间间隔的特定事件

a. adb shell monkey -v -p com.package.name --pct-touch 100 --throttle 1000 100
对指定应用进行100次触摸事件，每次事件的时间间隔为1000毫秒

b. adb shell monkey -s 12 --throttle 450-p com.package.name --kill-process-after-error --ignore-timeouts–ignore-security-exceptions -v 10000 >D:\Monkey-logs\testlog.log

6、app包名

如何查找包名及启动的Activity名称：aapt dump badging [将本地APP包拖入，注：包名不要起中文] | findstr “launchable-activity”

7、monkey日志管理

7.1保存在PC

adb shell monkey … >d:\monkeylog.txt：保存在手机上
adb shell monkey -v 100 >/sdcard/monkeylog.log

注：不能写成adb shell monkey -f /sdcard/kyb.txt -v 1 >/mnt/sdcard/monkeylog.log否则会报错“系统找不到指定的路径”

7.2 标准流和错误流分开保存

Monkey [option] 1>sdcard/monkey.txt 2>sdcard/error.txt
如：adb shell monkey -v 100 1>d:\monkey.log 2>d:\error.log

执行以上命令，monkey的运行日志和异常日志将被分开保存，此时monkey的运行日志将被保存在monkey.txt文件中，而异常日志将被保存在D盘下的error.txt中。

8、详细分析monkey日志

将执行Monkey生成的log，从手机中导出并打开查看该log；在log的最开始都会显示Monkey执行的seed值、执行次数和测试的包名。

首先我们需要查看Monkey测试中是否出现了ANR或者异常，具体方法如上述。然后我们要分析log中的具体信息，方法如下：

查看log中第一个Switch，主要是查看Monkey执行的是那一个Activity，譬如下面的log中，执行的是com.tencent.smtt.SplashActivity，在下一个swtich之间的，如果出现了崩溃或其他异常，可以在该Activity中查找问题的所在。

:Switch:#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=com.tencent.smtt/.SplashActivity;end
// Allowing start of Intent {act=android.intent.action.MAIN
cat=[android.intent.category.LAUNCHER]cmp=com.tencent.smtt/.SplashActivity
} in package com.tencent.smtt

在下面的log中，Sending Pointer ACTION_DOWN和Sending Pointer ACTION_UP代表当前执行了一个单击的操作;
Sleeping for 500 milliseconds这句log是执行Monkey测试时，throttle设定的间隔时间，每出现一次，就代表一个事件。
SendKey(ACTION_DOWN) //KEYCODE_DPAD_DOWN 代表当前执行了一个点击下导航键的操作；

Sending Pointer ACTION_MOVE 代表当前执行了一个滑动界面的操作。 :Sending Pointer
ACTION_DOWN x=47.0 y=438.0 :Sending Pointer ACTION_MOVE x=-2.0 y=-4.0
ANR

如果Monkey测试顺利执行完成，在log的最后，会打印出当前执行事件的次数和所花费的时间；// Monkey finished代表执行完成。Monkey执行中断，在log的最后也能查看到当前已执行的次数。Monkey执行完成的log具体如下：

Events injected: 6000

:Dropped: keys=0 pointers=9 trackballs=0 flips=0

##Network stats: elapsed time=808384ms (0ms mobile, 808384ms wifi, 0msnot connected)

// Monkey finished

范例：

Monkey测试结果：

#monkey -p wfh.LessonTable -v -v -v 200

:Monkey: seed=0 count=200

:AllowPackage: wfh.LessonTable

:IncludeCategory: android.intent.category.LAUNCHER

:IncludeCategory: android.intent.category.MONKEY

// Selecting main activities from category
android.intent.category.LAUNCHER

// - NOT USING main activity com.android.browser.BrowserActivity
(from package com.android.browser)

// Seeded: 0

// Event percentages:

// 0: 15.0%

// 1: 10.0%

// 2: 15.0%

// 3: 25.0%

// 4: 15.0%

// 5: 2.0%

// 6: 2.0%

// 7: 1.0%

// 8: 15.0%

:Switch:
#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=wfh.LessonTable/.MainTable;end

// Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=wfh.LessonTable/.MainTable

} in package wfh.LessonTable

Sleeping for 0 milliseconds

:SendKey (ACTION_DOWN): 21 // KEYCODE_DPAD_LEFT

:SendKey (ACTION_UP): 21 // KEYCODE_DPAD_LEFT

Sleeping for 0 milliseconds
//------------------------------------用－－throttle来设置一个起效的事件发生后时延时。

:Sending Pointer ACTION_DOWN x=0.0 y=0.0

:Sending Pointer ACTION_UP x=0.0 y=0.0

Sleeping for 0 milliseconds

:Sending Pointer ACTION_MOVE x=0.0 y=0.0

当测试到ACTION_MOVE x=0.0 y=0.0这个动作时，发生了FC（Force Close）错误，以下为输出错误信息。同时在LogCat里面也有错误输出，而且LogCat里面的错误信息更为详细，在实际的测试中应该结合两者输出的信息进行调试程序。

// CRASH: wfh.LessonTable (pid 1973)

// Short Msg: java.lang.NullPointerException

// Long Msg: java.lang.NullPointerException

// Build Label:
android:generic/sdk/generic/:2.1-update1/ECLAIR/35983:eng/test-keys

// Build Changelist: 35983

// Build Time: 1273161972

// ID:

// Tag: AndroidRuntime

// java.lang.NullPointerException:

// at android.widget.TabHost.dispatchKeyEvent(TabHost.java:279)

// at android.view.ViewGroup.dispatchKeyEvent(ViewGroup.java:748)

** Monkey aborted due to error.

Events injected: 190

:Dropped: keys=0 pointers=11 trackballs=0 flips=0

##Network stats: elapsed time=27954ms (27954ms mobile, 0ms wifi, 0ms not connected)

** System appears to have crashed at event 190 of 200 using seed 0

开始monkey测试时android的LogCat输出的信息：

11-01 08:52:53.712: DEBUG/AndroidRuntime(2077): >>>>>>>>>>>>>>
AndroidRuntime START <<<<<<<<<<<<<<

11-01 08:52:53.742: DEBUG/AndroidRuntime(2077): CheckJNI is ON

11-01 08:52:54.453: DEBUG/AndroidRuntime(2077): —

以下为LogCat输出的错误信息，在以下的信息中首先从自己的包中找错误，如果没有自己的包的话就再找发生错误的包的第一个发生了异常。由错误提示可以看出很大的可能是因为TabHost引发的异常。经过查看代码发现是由于TabHost的编写不规范，TabHost与其中一个view放在了一起，在monkey测试做滚球上下滚动时当滚到TabHost时就发生了异常了。所以把TabHost与Activity分开写就不会出现些问题了。

11-01 08:53:27.113: ERROR/AndroidRuntime(1973): Uncaught handler:
thread main exiting due to uncaught exception

11-01 08:53:27.133: ERROR/AndroidRuntime(1973):
java.lang.NullPointerException

11-01 08:53:27.133: ERROR/AndroidRuntime(1973): at
android.widget.TabHost.dispatchKeyEvent(TabHost.java:279)

11-01 08:53:27.133: ERROR/AndroidRuntime(1973): at
android.view.ViewGroup.dispatchKeyEvent(ViewGroup.java:748)

9、链接模拟器

adb connect 127.0.0.1:62001
adb devices

10、Monkey自定义脚本

10.1自定义脚本的稳定性测试

常规Monkey测试执行的是随机的事件流，但如果只是想让Monkey测试某个特定场景这时候就需要用到自定义脚本了，Monkey支持执行用户自定义脚本的测试，用户只需要按照Monkey脚本的规范编写好脚本，存放到手机上，启动Monkey通过-f 参数调用脚本即可。

10.2获取元素坐标点位置

Monkey脚本只能通过坐标的方式来定位点击和移动事件的屏幕位置，这里就需要提前获取坐标信息。获取坐标信息的方法很多，最简单的方法就是打开手机中的开发人员选项，打开“显示指针位置”。随后，在屏幕上的每次操作，在导航栏上都会显示坐标信息。

注：手机没有开开发者选项时，到手机设置–关于手机–型号，连续点击7次就会出现该选项

10.3Monkey脚本API

• LaunchActivity(pkg_name, cl_name)：启动应用的Activity。参数：包名和启动的Activity。
• Tap(x, y, tapDuration)： 模拟一次手指单击事件。参数：x,y为控件坐标，tapDuration为点击的持续时间，此参数可省略
• DispatchPress(keyName)： 按键。参数： 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()： 唤醒屏幕。
• 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)： 结束获取帧率。

10.4Monkey脚本格式

Monkey脚本主要包含两部分，一部分是头文件信息，一部分是具体的monkey命令。

#头部： type = raw events count = 1 次数 speed = 1.0 时间
#下面为monkey命令： start data >> 具体的monkey脚本内容

注：头文件代码书写注意“=”两边预留空格，否则会出现如下报错。

10.5编写脚本实例

type = raw events count = 1 speed = 1.0 start data >>
LaunchActivity(com.tal.kaoyan,com.tal.kaoyan.ui.activity.SplashActivity)
UserWait(2000) Tap(624,900,1000) #点击取消升级
UserWait(2000)Tap(806,64,1000) #点击跳过 UserWait(2000)Tap(217,378,1000)
#点击用户名输入框 DispatchString(zxw1234) UserWait(2000)Tap(197,461,1000) #点击密码输入框 DispatchString(zxw123456) UserWait(2000) Tap(343,637,1000) #点击登录按钮

10.6执行脚本

脚本编写完成后，传到手机设备上，然后执行
adb push C:\Users\Shuqing\Desktop\kyb1.txt /sdcard
adb shell monkey -f /sdcard/kyb1.txt -v 1