monkey详解

    monkey是模拟用户的按键输入，触摸屏输入，手势输入等，看设备多长时间会出异常。monkey是一个脚本。

     在 /system/bin目录下有一个monkey的shell脚本，内容如下：

#Script to start "monkey" on the device,which has a very #rudimentary shell.
base=/system
export CLASSPATH=$base/framework/monkey.jar
exec app_process $base/bin com.android.commands.monkey.Monkey $*exec会运行起/system/framework/monkey.jar这只java程序，后面我们还会用到这个脚本。

monkey源码：development\cmds\monkey\src\com\android\commands\monkey

运行 monkey可以采用两种方式：系统默认方式和script方式

1、 adb shell monkey -help
     显示monkey帮助信息，如下：

usage: monkey [-p     ALLOWED_PACKAGE]

                       [-c      MAIN_CATEGORY]

                       [--ignore-crashes]

                       [--ignore-timeouts]

                       [--ignore-security-exceptions]

                       [--monitor-native-crashes]

                       [--ignore-native-crashes]

                       [--kill-process-after-error]

                       [--hprof]

                       [--pct-touch]

                       [--pct-trackball]

                       [--pct-motion]

                       [--pct-syskeys]

                      

                       [--pct-pinchzoom]                      

                       [--pct-nav]

                       [--pct-majornav]

                       [--pct-appswitch]

                       [--pct-anyevent]

                       [--pct-flip]

                       [--pkg-blacklist-file PACKAGE_BLACKLIST_FILE]

                       [--pkg-whitelist-file PACKAGE_WHITELIST_FILE]

                       [--wait-dbg]

                       [--dbg-no-events]

                       [--setup scriptfile]

                       [-f scriptfile]

                       [--port port]

                       [-s SEED]

                       [-v -v]

                       [--throttle MILLISEC每多少毫秒数执行随机事件]

                       [--profile-wait  MILLISEC]

                       [--device-sleep-time MILLISEC]

                       [--randomize-script]

                       [--srcipt-log]

                       [--bugreport]
                    count

-p <allowed-package-name>

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

-c <main-category>

如果用此参数指定一个或多个类别，Monkey将只允许系统启动这些类别中的Activity.如果不指定任何类，Monkey 将启动所有类（android.intent.category.LAUNCHER或者android.intent.category.MONKEY）的Activity,要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别。

-v

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


-s <seed>

随机数生成器的seed值。如果用相同的seed值再次运行 monkey,它将生成相同的事件序列。

--throttle <millseconds>

在事件之间插入固定延迟。通过这个选项可以减缓Monkey的执行速度。如果不指定该选项，Monkey将不会被延迟，事件将尽可能快的被完成。

--pct-touch <percent>

调整触摸事件的百分比（触摸事件是一个down-up事件，它发生在屏幕上的某单一位置）

--pct-motion<percent>

调整动作事件的百分比（动作事件由屏幕上某一个down事件，一系列的伪随机事件和一个up事件组成,即由action_down+多个/一个 action_move+action_up）

--pct-trackball <percent>

调整轨迹事件的百分比（轨迹事件由一个或几个事件的移动组成，有时还伴随着点击事件，即action_move/action_up）

--pct-nav <percent>

调整“基本”导航事件的百分比（导航事件由来自方向输入设备的left/right/up/down组成）

--pct-majornav <percent>

调整“主要”导航事件的百分比（这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键，菜单按键）

--pct-syskeys <percent>

调整“系统”按键事件的百分比（这些按键通常被保留，由系统使用，如Home,Back,Start Call End Call及音量控制键）

 

--pct-pinchzoom

 

  在测试地图时，可以用上这个参数。是指模拟双指滑动操作以放大/缩小地图

--pct-appswitch <percent>

调整启动Activity的百分比，在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法。

--pct-anyevent <percent>

调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其他不常用的设备按钮、等等。

--dbg-no-events

设置此选项，Monkey将执行初始启动，进入到一个测试Activity, 然后不会再进一步生成事件。为了得到最佳结果，把它与-v,一个或几个包约束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。

--hprof

设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在data/misc中生成大文件（5MB）,一般情况都不用它

--ignore-crashes

通常，当应用程序崩溃或发生任何失控异常时，Monkey将停止运行。如果设置此选项，Monkey将继续发送事件，直到计数完成。

--ignore-timeouts

通常，当应用程序发生任何超时错误（如“Application not responding”对话框）时，Monkey 将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成。

--ignore-security-exceptions

通常，当应用程序发生许可错误（如启动一个需要某些许可的Activity）时，Monkey将停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成。

--kill-process-after-error

通常，当Monkey自己由于一个错误而停止时，出错的应用程序仍处于运行状态。当设置了此选项时，将会通知系统停止发生错误的进程。注意，正常的（成功的）结束，并没有停止启动的进程，设备只是在结束事件之后，简单地保持在最后的状态。

--monitor-native-crashes

监视并报告Android app系统中本地代码的崩溃事件。如果设置了--kill-process-after-error,系统将停止运行。

--wait-dbg

停止执行中的Monkey,直到有调试器和它相连接。

--pkg-blacklist-file PACKAGE_BLACKLIST_FILE

该参数与-p只能选择其一，PACKAGE_BLACKLIST_FILE为一个可以是任何格式的文件；--pkg-blacklist-file 后面带的文件中列出的包名是在黑名单，即在运行monkey测试时是不会对文件中列出的应用进行monkey测试的，如下：

在/sdcard/新建mon,txt
内容如下：

com.android.apr

com.android.settings

com.mediatek.filemanager

com.aliyun.note

com.sina.weibo

com.android.phone

在命令行中执行：monkey --pkg-blacklist-file /sdcard/mon.txt -v -v -v 100

--pkg-whitelist-file  这个与--pkg-blacklist-file 相反，即monkey只运行文件列表中的应用

 

-----monkey日志是可以分日志级别分别存储的

如adb shell monkey -p package_name --pct-touch 30  -v -v  --throttle 100000 2>/sdcard/error.txt 1>/sdcard/info.txt 

 

其中2和1分别是指日志级别