Monkey使用说明书文档格式.docx
《Monkey使用说明书文档格式.docx》由会员分享，可在线阅读，更多相关《Monkey使用说明书文档格式.docx（16页珍藏版）》请在冰豆网上搜索。
http:
//www.eclipse.org/downloads/
4．Monkey命令使用介绍
usage:
monkey[-pALLOWED_PACKAGE][-pALLOWED_PACKAGE]...]
[-cMAIN_CATEGORY[-cMAIN_CATEGORY]...]
[--ignore-crashes][--ignore-timeouts]
[--ignore-security-exceptions]
[--monitor-native-crashes][--ignore-native-crashes]
[--kill-process-after-error][--hprof]
[--pct-touchPERCENT][--pct-motionPERCENT]
[--pct-trackballPERCENT][--pct-syskeysPERCENT]
[--pct-navPERCENT][--pct-majornavPERCENT]
[--pct-appswitchPERCENT][--pct-flipPERCENT]
[--pct-anyeventPERCENT]
[--pkg-blacklist-filePACKAGE_BLACKLIST_FILE]
[--pkg-whitelist-filePACKAGE_WHITELIST_FILE]
[--wait-dbg][--dbg-no-events]
[--setupscriptfile][-fscriptfile[-fscriptfile]...]
[--portport]
[-sSEED][-v[-v]...]
[--throttleMILLISEC][--randomize-throttle]
[--profile-waitMILLISEC]
[--device-sleep-timeMILLISEC]
[--randomize-script]
[--script-log]
[--bugreport]
COUNT
2、Monkey命令参数介绍
1）参数：
-p
参数-p用于约束限制，用此参数指定一个或多个包（Package，即APP）。
指定包之后，Monkey将只运行系统启动指定的APP。
如果不指定包，Monkey将允许系统启动设备中的所有APP。
*指定一个包：
adbshellmonkey–pcom.android.music100
说明：
com.android.music为包名，100是事件计数（即让Monkey程序模拟100次随机用户事件）。
*指定多个包：
adbshellmonkey–pcom.android.music–pcom.android.browser100*不指定包：
adbshellmonkey100
monkey随机启动APP并发送100个随机事件。
*要查看设备中所有的包，在CMD窗口中执行以下命令：
>
adbshell
#cd/data/data
#ls
2）参数：
-c
如果用此指定了一个或几个类别，Monkey将只允许系统启动被这些类别种的某个类别列出的Activity。
如果不指定任何类别，Monkey将选择下列类别中列出的Activity：
Intent.category.LAUNCHER或Intent.category.MONKEY。
要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别。
3）参数：
-v
用于指定反馈信息级别（信息级别就是日志的详细程度），总共分3个级别，分别对应的参数如下所示：
日志级别Level0
示例：
adbshellmonkey–pcom.android.music–v100
缺省值，仅提供启动提示、测试完成和最终结果等少量信息
日志级别Level1
adbshellmonkey–pcom.android.music–v–v100
提供较为详细的日志，包括每个发送到Activity的事件信息
日志级别Level2
adbshellmonkey–pcom.android.music–v–v–v100
最详细的日志，包括了测试中选中/未选中的Activity信息
4）参数：
-s
用于指定伪随机生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。
*示例：
Monkey测试1：
adbshellmonkey–pcom.android.music–s10100
Monkey测试2：
两次测试的效果是相同的，因为模拟的用户序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。
操作序列虽然是随机生成的，但是只要我们指定了相同的Seed值，就可以保证两次测试产生的随机操作序列是完全相同的，所以这个操作序列伪随机的
5）参数：
--throttle<
毫秒>
用于指定用户操作（即事件）间的时延，单位是毫秒；
adbshellmonkey–pcom.andorid.music–throttle3000100
6）参数–ignore-crashes
用于指定当应用程序崩溃时（Force&
Close错误），Monkey是否停止运行。
如果使用此参数，即使应用程序崩溃，Monkey依然会发送事件，直到事件计数完成。
*示例1：
adbshellmonkey–pcom.android.music–gnore-crashes1000
测试过程中即使music程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止；
示例2：
adbshellmonkey–pcom.android.music1000
测试过程中，如果music程序崩溃，Monkey将会停止运行。
7）参数：
--ignore-timeouts
用于指定当应用程序发生ANR（ApplicationNoResponding）错误时，Monkey是否停止运行。
如果使用此参数，即使应用程序发生ANR错误，Monkey依然会发送事件，直到事件计数完成。
8）参数：
--ignore-security-exceptions
用于指定当应用程序发生许可错误时（如证书许可，网络许可等），Monkey是否停止运行。
如果使用此参数，即使应用程序发生许可错误，Monkey依然会发送事件，直到事件计数完成。
9）参数：
--kill-process-after-error
用于指定当应用程序发生错误时，是否停止其运行。
如果指定此参数，当应用程序发生错误时，应用程序停止运行并保持当前状态（注意：
应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程）。
10）参数：
--monitor-native-crashes
用于指定是否监视并报告应用程序发生崩溃的本地代码
11）参数：
--pct-{+事件类别}{+事件类别百分比}
用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比）
参数：
使用说明：
①--pct-touch{+百分比}
调整触摸事件的百分比（触摸事件是一个down-up事件，它发生在屏幕的某单一位置）
adbshellmonkey–pcom.android.music--pct-touch101000
②--pct-motion{+百分比}
调整动作事件的百分比（动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和up事件组成）
adbshellmonkey–pcom.android.music--pct-motion201000
③--pct-trackball{+百分比}
调整轨迹球事件的百分比{轨迹事件由一个或几个随机的移动组成，有时还伴随有点击}adbshellmonkey–pcom.android.music--pct-trackball301000j
④--pct-nav{+百分比}
调整“基本”导航事件的百分比（导航事件由来自方向输入设备的up/down/left/right组成）
adbshellmonkey–pcom.android.music--pct-nav401000
⑤--pct-majornav{+百分比}
调整“主要”导航事件的百分比（这些导航事件通常引发图形界面中的动作，如：
5-way键盘的中间按键、回退按键、菜单按键）
adbshellmonkey–pcom.android.music--pct-majormav501000
⑥--pct-syskeys{+百分比}
调整“系统”按键事件的百分比（这些按键通常被保留，由系统使用，如Home，Back，StartCall，EndCall及音量控制键）
adbshellmonkey–pcom.android.music--pct-syskeys601000
⑦--pct-appswitch{+百分比}
调整启动Activity的百分比。
在随机间隔里，Monkey将执行一个startActivity（）调用，作为最大程度覆盖包中全部Activity的一种方法
adbshellmokey-pcom.android.music--pct-appswitch701000
⑧--pct-anyevent{+百分比}
调整其它类型事件的百分比。
它包罗了所有其它类型的事件，如：
按键、其它不常用的的设备按钮、等等
adbshellmonkey-pcom.android.music--pct-anyevent1001000
*指定多个类型的百分比：
adbshellmonkey-pcom.android.music--pct-anyevent50--pct-switch501000
12）参数：
--dbg-no-events
设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不会再进一步生成事件。
为了得到最佳结果，把它与-v、一个或几个包约束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。
13）参数：
--hprof
设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。
这将会在/data/misc中生成大文件（~5Mb），所以要小心使用它
14）参数：
监视并报告Android系统中本地代码的崩溃事件，如果设置了，系统将停止运行
15）参数：
--wait-dbg
停止执行中的Monkey，直到有调试器和它相连接。
16）参数：
-port
为Monkey开启专用端口。
此时只Monkey不会帮你乱点击，而此时你自己就是一只Monkey，在你乱点的时候，Monkey会输出你点击后回馈的信息。
如果你打完命令后，模拟器上没有启动你所要启动的包，你需要自己启动，但是你只能启动你-p中指定的那几个包。
Ctrl+c中断。
四、Monkey测试图库实例
1、首先要得到测试apk的包名，如果有APK源码包的话直接将“.apk”后缀改为“.zip”然
后打开包中的AndroidManifest.xml可以查看包名，如果没有或者已经安装的点击应用程序，然后查看logcat信息，也能够找到包名，同时在/data/data/目录下面有全部的应用程序的包名，我们要测试的图库的包名为：
com.cooliris.media.
2、设定参数
首先用一个最简单的例子分析
-p参数：
表示指定测试的程序
-v参数：
表示查看Monkey生成的一些详细的随机的事件名
数字100：
表示测试事件数为100
monkey-pcom.cooliris.meida-v-v-v100
结果如下：
#monkey-pcom.cooliris.media-v-v-v100
monkey-pcom.cooliris.media-v-v-v100
:
Monkey:
seed=0count=100
AllowPackage:
com.cooliris.media
IncludeCategory:
android.intent.category.LAUNCHER:
android.intent.category.MONKEY
//各种事件所占的比例
//各数字分别表示
[--pct-touchPERCENT]
[--pct-motionPERCENT]
[--pct-trackballPERCENT]
[--pct-syskeysPERCENT]
[--pct-navPERCENT]
[--pct-majornavPERCENT]
[--pct-appswitchPERCENT]
[--pct-flipPERCENT]
//Eventpercentages//0:
15.0%
//1:
10.0%//2:
//3:
25.0%
//4:
//5:
2.0%
//6:
//7:
1.0%
//8:
Switch:
//表示跳转到com.cooliris.media里面的Gallery这一个Activity
#Intent;
action=android.intent.action.MAIN;
category=android.intent.category.LAUNCHER;
launchFlags=0x10000000;
component=com.cooliris.media/.Gallery;
end//允许此Intent跳转
//AllowingstartofIntent{act=android.intent.action.MAINcat=[android.intent.ca
tegory.LAUNCHER]cmp=com.cooliris.media/.Gallery}inpackagecom.cooliris.mediaSleepingfor0milliseconds
//发送一系列动作，如点击按下，点击放开，移动
SendKey（ACTION_DOWN）:
22//KEYCODE_DPAD_RIGHT
SendKey（ACTION_UP）:
Sleepingfor0milliseconds
23//KEYCODE_DPAD_CENTER
59//KEYCODE_SHIFT_LEFT
13//KEYCODE_6
21//KEYCODE_DPAD_LEFT
SendingPointerACTION_DOWNx=554.0y=357.0
SendingPointerACTION_MOVEx=558.0y=350.0
SendingPointerACTION_UPx=558.0y=350.0
3//KEYCODE_HOME
//拒绝此跳转，因为它是跳转的到非它自己的包的Activity，本测试中是指测试它程序所在的包，此跳转是跳出本程序，进入桌面。
//RejectingstartofIntent{act=android.intent.action.MAINcat=[android.intent.c
ategory.HOME]cmp=com.android.launcher/com.android.launcher2.Launcher}inpackagecom.android.launcher
//继续发送动作
Sleepingfor0milliseconds//-----------------------------用--throttle来设置一个起效的事件发生后时延时
20//KEYCODE_DPAD_DOWN
82//KEYCODE_MENU
48//KEYCODE_T
SendingPointerACTION_DOWNx=19.0y=121.0
SendingPointerACTION_MOVEx=20.0y=123.0
SendingPointerACTION_MOVEx=11.0y=123.0
SendingPointerACTION_MOVEx=16.0y=123.0
SendingPointerACTION_UPx=16.0y=123.0
7//KEYCODE_0
SendingPointerACTION_DOWNx=266.0y=182.0
SendingPointerACTION_UPx=266.0y=182.0
19//KEYCODE_DPAD_UP
19//KEYC
升级会员 