monkey命令解析详解
monkey 就是sdk中附带的一个工具。monkey是android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。
该工具用于进行压力测试。然后开发人员结合monkey 打印的日志和系统打印的日志，分析测试中的问题
monkey 测试的特点：
monkey 测试,所有的事件都是随机产生的，不带任何人的主观性。
1、测试的对象仅为应用程序包，有一定的局限性。
2、monky测试使用的事件数据流是随机的，不能进行自定义。
3、可对monkeytest的对象，事件数量，类型，频率等进行设置。
二、monkey的基本用法
基本语法如下：
$ adb shell monkey [options]
如果不指定options，monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包。下面是一个更为典型的命令行示例，它启动指定的应用程序，并向其发送500个伪随机事件：
$ adb shell monkey -p your.package.name -v 500
使用android自动化测试工具monkeyrunner启动应用时，需要填写被测程序的包名和启动的activity，以下有两种查看应用包名package和入口activity名称的方法：
方法一：使用aapt //aapt是sdk自带的一个工具，在sdk\builds-tools\目录下
1.以es文件浏览器为例，命令行中切换到aapt.exe目录执行：aapt dump badging e:\apk\es3.apk
2.
注：在android sdk目录搜索可以找到aapt.exe，如果没有可以下载apktool。
三、monkey测试的一个实例
通过这个实例，我们能理解monkey测试的步骤以及如何知道哪些应用程序能够用monkey进行测试。
windows下（注：2—4步是为了查看我们可以测试哪些应用程序包，可省略）：
1、通过eclipse启动一个android的emulator
2、在命令行中输入：adb devices查看设备连接情况
c:\documents and settings\administrator>adb devices
list of devices attached
emulator-5554 device
3、在有设备连接的前提下，在命令行中输入：adb shell 进入shell界面
c:\documents and settings\administrator>adb shell
#
4、查看data/data文件夹下的应用程序包。注：我们能测试的应用程序包都在这个目录下面
c:\documents and settings\administrator>adb shell
# ls data/data
ls data/data
5、以com.android.calculator2作为对象进行monkeytest
#monkey -p com.android.calculator2 -v 500
其中-p表示对象包 –v 表示反馈信息级别
运行过程中，emulator中的应用程序在不断地切换画面。
按照选定的不同级别的反馈信息，在monkey中还可以看到其执行过程报告和生成的事件。
四、使用monkey help 命令查看命令参数
c:\users\chenfenping>adb shell monkey -help
usage: monkey [-p allowed_package [-p allowed_package] ...]
[-c main_category [-c main_category] ...]
[--ignore-crashes] [--ignore-timeouts]
[--ignore-security-exceptions]
[--monitor-native-crashes] [--ignore-native-crashes]
[--kill-process-after-error] [--hprof]
[--pct-touch percent] [--pct-motion percent]
[--pct-trackball percent] [--pct-syskeys percent]
[--pct-nav percent] [--pct-majornav percent]
[--pct-appswitch percent] [--pct-flip percent]
[--pct-anyevent percent] [--pct-pinchzoom percent]
[--pkg-blacklist-file package_blacklist_file]
[--pkg-whitelist-file package_whitelist_file]
[--wait-dbg] [--dbg-no-events]
[--setup scriptfile] [-f scriptfile [-f scriptfile] ...]
[--port port]
[-s seed] [-v [-v] ...]
[--throttle millisec] [--randomize-throttle]
[--profile-wait millisec]
[--device-sleep-time millisec]
[--randomize-script]
[--script-log]
[--bugreport]
[--periodic-bugreport]
count
1 参数： -p
用于约束限制，用此参数指定一个或多个包（package，即app）。指定包之后，monkey将只允许系统启动指定的app,如果不指定包，将允许系统启动设备中的所有app.
* 指定一个包： adb shell monkey -p cn.emoney.acg 10
* 指定多个包：adb shell monkey -p cn.emoney.acg –p cn.emoney.wea -p cn.emoney.acg 100
* 不指定包：adb shell monkey 100
2 参数: -v
用于指定反馈信息级别（信息级别就是日志的详细程度），总共分3个级别，分别对应的参数如下表所示：
日志级别 level0
示例 adb shell monkey -p cn.emoney.acg –v 100
说明缺省值，仅提供启动提示、测试完成和最终结果等少量信息
日志级别 level 1
示例 adb shell monkey -p cn.emoney.acg –v -v 100
说明提供较为详细的日志，包括每个发送到activity的事件信息
日志级别 level 2
示例 adb shell monkey -p cn.emoney.acg –v -v –v 100
说明最详细的日志，包括了测试中选中/未选中的activity信息
3 参数： -s
用于指定伪随机数生成器的seed值，如果seed相同，则两次monkey测试所产生的事件序列也相同的。
monkey 测试1：adb shell monkey -p cn.emoney.acg -s 10 100
monkey 测试2：adb shell monkey -p cn.emoney.acg –s 10 100
两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。
4 参数： --throttle<毫秒>
用于指定用户操作（即事件）间的时延，单位是毫秒；
adb shell monkey -p cn.emoney.acg --throttle 5000 100
5 参数： --ignore-crashes
用于指定当应用程序崩溃时（force& close错误），monkey是否停止运行。如果使用此参数，即使应用程序崩溃，monkey依然会发送事件，直到事件计数完成。
adb shellmonkey -p cn.emoney.acg --ignore-crashes 1000
测试过程中即使程序崩溃，monkey依然会继续发送事件直到事件数目达到1000为止
adb shellmonkey -p cn.emoney.acg 1000
测试过程中，如果acg程序崩溃，monkey将会停止运行
6 参数： --ignore-timeouts
用于指定当应用程序发生anr（application no responding）错误时，monkey是否停止运行。如果使用此参数，即使应用程序发生anr错误，monkey依然会发送事件，直到事件计数完成。
adb shellmonkey -p cn.emoney.acg --ignore-timeouts 1000
7 参数： --ignore-security-exceptions
用于指定当应用程序发生许可错误时（如证书许可，网络许可等），monkey是否停止运行。如果使用此参数，即使应用程序发生许可错误，monkey依然会发送事件，直到事件计数完成。
adb shellmonkey -p cn.emoney.acg --ignore-security-exception 1000
8 参数： --kill-process-after-error
用于指定当应用程序发生错误时，是否停止其运行。如果指定此参数，当应用程序发生错误时，应用程序停止运行并保持在当前状态
（注意：应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程）。
adb shellmonkey -p cn.emoney.acg --kill-process-after-error 1000
9 参数： --monitor-native-crashes
用于指定是否监视并报告应用程序发生崩溃的本地代码。
adb shellmonkey -p cn.emoney.acg --monitor-native-crashes 1000
10 参数： --pct-｛+事件类别｝｛+事件类别百分比｝
用于指定每种类别事件的数目百分比（在monkey事件序列中，该类事件数目占总事件数目的百分比）
示例:
--pct-touch｛+百分比｝
调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)
adb shell monkey -p cn.emoney.acg --pct-touch 10 1000
--pct-motion ｛+百分比｝
调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随件机事和一个up事件组成)
adb shell monkey -p cn.emoney.acg --pct-motion 20 1000
--pct-trackball ｛+百分比｝
调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)
adb shell monkey -p cn.emoney.acg --pct-trackball 30 1000
--pct-nav ｛+百分比｝
调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)
adb shell monkey -p cn.emoney.acg --pct-nav 40 1000
--pct-majornav ｛+百分比｝
调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)
adb shell monkey -p cn.emoney.acg --pct-majornav 50 1000
七、输出monkeylog
跑monkey的时候或者想抓程序log导出时，有时会提示：cannot create d:monkeytest.txt: read-only file system
为什么有时候可以有时候不可以？
后来发现跟使用使用习惯不一样，一会是先进入adb shell 再用命令，一会是直接命令进入。
进入adb shell后再用命令就会失败~
正确方法：退出shell或者执行命令时先不要进shell
c:\documents and settings\administrator>adb shell monkey -p 包名
-v 300 >e:\text.txt
进入adb shell后就相当于进入linux的root下面，没有权限在里面创建文件~
五、monkey测试结果分析
一. 初步分析方法：
monkey测试出现错误后，一般的查错步骤为以下几步：
1、找到是monkey里面的哪个地方出错
2、查看monkey里面出错前的一些事件动作，并手动执行该动作
3、若以上步骤还不能找出，可以使用之前执行的monkey命令再执行一遍，注意seed值要一样--复现
一般的测试结果分析：
1、 anr问题：在日志中搜索“anr”
2、崩溃问题：在日志中搜索“exception” force close
二. 详细分析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)
四、总结：
在monkey测试中常用的命令组合有：
1、monkey -p com.yourpackage -v 500／／简单的输出测试的信息。
2、monkey -p com.yourpackage -v -v 500 //以深度为二级输出测试信息。
4、monkey -p com.yourpackage -s 数字 -v 500／／为随机数的事件序列定一个值，若出现问题下次可以重复同样的系列进行排错。
5、monkey -p com.yourpackage -v --throttle 3000 500//为每一次执行一次有效的事件后休眠3000毫秒。
五、附录：
以下内容为android系统中的keycode值，在以后的调试中会经常需要查询：
|
字母和数字键的键码值(keycode) |
|||||||
|
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
|
a |
65 |
j |
74 |
s |
83 |
1 |
49 |
|
b |
66 |
k |
75 |
t |
84 |
2 |
50 |
|
c |
67 |
l |
76 |
u |
85 |
3 |
51 |
|
d |
68 |
m |
77 |
v |
86 |
4 |
52 |
|
e |
69 |
n |
78 |
w |
87 |
5 |
53 |
|
f |
70 |
o |
79 |
x |
88 |
6 |
54 |
|
g |
71 |
p |
80 |
y |
89 |
7 |
55 |
|
h |
72 |
q |
81 |
z |
90 |
8 |
56 |
|
i |
73 |
r |
82 |
0 |
48 |
9 |
57 |
|
数字键盘上的键的键码值(keycode) |
功能键键码值(keycode) |
||||||
|
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
|
0 |
96 |
8 |
104 |
f1 |
112 |
f7 |
118 |
|
1 |
97 |
9 |
105 |
f2 |
113 |
f8 |
119 |
|
2 |
98 |
* |
106 |
f3 |
114 |
f9 |
120 |
|
3 |
99 |
+ |
107 |
f4 |
115 |
f10 |
121 |
|
4 |
100 |
enter |
108 |
f5 |
116 |
f11 |
122 |
|
5 |
101 |
- |
109 |
f6 |
117 |
f12 |
123 |
|
6 |
102 |
. |
110 |
|
|
|
|
|
7 |
103 |
/ |
111 |
|
|
|
|
|
控制键键码值(keycode) |
|||||||
|
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
|
backspace |
8 |
esc |
27 |
right arrow |
39 |
-_ |
189 |
|
tab |
9 |
spacebar |
32 |
dw arrow |
40 |
.> |
190 |
|
clear |
12 |
page up |
33 |
insert |
45 |
/? |
191 |
|
enter |
13 |
page down |
34 |
delete |
46 |
`~ |
192 |
|
shift |
16 |
end |
35 |
num lock |
144 |
[{ |
219 |
|
control |
17 |
home |
36 |
;: |
186 |
\| |
220 |
|
alt |
18 |
left arrow |
37 |
=+ |
187 |
]} |
221 |
|
cape lock |
20 |
up arrow |
38 |
,< |
188 |
'" |
222 |
|
多媒体键码值(keycode) |
|||||||
|
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
按键 |
键码 |
|
音量加 |
175 |
|
|
|
|
|
|
|
音量减 |
174 |
|
|
|
|
|
|
|
停止 |
179 |
|
|
|
|
|
|
|
静音 |
173 |
|
|
|
|
|
|
|
浏览器 |
172 |
|
|
|
|
|
|
|
邮件 |
180 |
|
|
|
|
|
|
|
搜索 |
170 |
|
|
|
|
|
|
|
收藏 |
171 |
|
|
|
|
|
|
此文章转载自覆手为云p,感谢大家