Monkey简介
Monkey 是一个你可以在模拟器或者测试机上使用的命令行工具,它会对系统发送伪随机用户操作,可以用来对你开发的APP进行压力测试。
Monkey的基本用法
基本语法如下:
$ adb shell monkey [options] <event-count>
例如
$ adb shell monkey -p your.package.name -v 500
Monkey参数
由于Google官方文档已经很久没有更新了,很多最新的参数都没有解释说明,要查看你测试手机内置的Monkey支持参数在命令行输入 adb shell monkey -help 可获得如下结果
$ 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]
[--pct-permission 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]
[--bugreport]
[--periodic-bugreport]
[--permission-target-system]
COUNT
Monkey 参数说明
参数 | 参数说明 |
---|---|
-p | 指定测试应用的包名例如: adb shell monkey -p com.android.settings 500 如果要同时测试多个应用,则每个包名都要跟一个-p,例如: adb shell monkey -p com.android.settings -p com.android.phone 如果不指定测试应用,Monkey 会在系统上任意操作。 |
-c | 指定访问应用Activity的category 同样一个-c 跟一个category,多个category配置多个-c 如果不指定,Monkey 会使用的默认的 Intent.CATEGORY_LAUNCHER (相当于用户桌面点击)或 Intent.CATEGORY_MONKEY。 注册在AndroidManifest.xml中的category 可能不止一个,通过配置不同的-c,测试不同路径进入APP的情况。 |
--ignore-crashes | 一般来说,当应用遇到系统无响应(systemNotResponding)或者应用崩溃(APPCrash)的时候Monkey会停止运行,但是如果有这个参数,Monkey会继续运行,知道配置的COUNT数完成 |
--ignore-timeouts | 一般来说,当应用遇到应用无响应ANR的时候Monkey会停止运行,但是如果有这个参数,Monkey会继续运行,知道配置的COUNT数完成 |
--ignore-security-exceptions | 当应用遇到权限错误的时候,Monkey会停止运行,然后输出 Error: SecurityException while injecting event. 如果有这个参数,Monkey会继续运行 |
--monitor-native-crashes | 检测Monkey启动之后产生的系统的native_crash,并生成"native_crash_"开头的报告, 如果--kill-process-after-error 也同时配置了,那么会造成系统停止。 如果不配置,不会监听系统产生的native_crash. native_crash存在/data/tombstones目录下 |
--ignore-native-crashes | 在配置了--monitor-native-crashes参数的情况下,遇到任何nativeCrash不会停止 ,继续monkey |
--kill-process-after-error | 当遇到appCrash 和ANR的时候强杀进程 |
--hprof | 参数已作废,详见“常见问题” |
--pct-touch | touch事件占的百分比 |
--pct-motion | 移动事件占的百分比 |
--pct-trackball | 轨迹球时间占的百分比 |
--pct-syskeys | 系统键(Home,音量...)占的百分比 |
--pct-nav | 导航事件(上下左右)占的百分比,是pad上的按键 |
--pct-majornav | 导航键(menu键)占的百分比 |
--pct-appswitch | Activity启动事件百分比 |
--pct-flip | 键盘翻转的百分比 |
--pct-anyevent | 其它类型事件的百分比 |
--pct-pinchzoom | 缩放的百分比 |
--pct-permission | permission 事件的百分比,默认为0 |
--pkg-blacklist-file | 黑名单app文件,黑名单和(白名单和指定应用 -p)不能同时使用 |
--pkg-whitelist-file | 白名单app文件,相当于配置多个-p |
--wait-dbg | 什么都不做 |
--dbg-no-events | 用于手动操作,Monkey启动app后,不会发送事件,让测试人员自己手动操作 |
--setup | 操作文件,事件不由Monkey产生, 而是按照传入的操作文件来操作 要搭配-f 一起使用,保证该文件是在第一个执行的 |
-f scriptfile | 操作文件,事件不由Monkey产生, 而是按照传入的操作文件来操作 一个-f 对应一个文件,可以配置多个 -f scriptfile -f scriptfile -f scriptfile |
--randomize-script | 随机执行操作文件,要与-f 参数一起使用 |
--port | 连接服务器进行Monkey操作,服务器上通过tcp或者adb生成事件,具体说明参考Monkey源代码中的README.NETWORK.txt文件 |
-s SEED | 后面紧跟种子数,种子数相同的情况下多次运行的结果都相同。 种子数只是随机的初始值,和随机数的取值空间无关。 |
-v | 设置输出日志级别,默认日志级别为0,每增加一个-v,日志级别加1。超出三个的,按三个来计算 |
--throttle | 后面紧跟两个事件之间间隔的毫秒数,如果不设置,Monkey会以尽可能快的速度产生事件 |
--randomize-throttle | 随机生成事件之间的间隔时间(毫秒),要和--throttle 搭配一起使用。 生成的时间区间在[0, throttle]之间。 |
--profile-wait | 后面紧跟事件之间的毫秒数,适用于用脚本跑Monkey的情况,默认值为5000毫秒 |
--device-sleep-time | 设备空闲时间,适用于脚本跑的Monkey,默认是30000毫秒 |
--bugreport | 当ANR,系统无响应,Crash的时候获得bugreport |
--periodic-bugreport | 紧跟次数,按照配置的几次次数,生成几次bugreport |
--permission-target-system | 要配置--pct-permission参数一起使用,Android6.0及以后的手机才有这个参数 |
COUNT | 次数 |
常见问题
1.在配置--hprof参数的情况下,没有生成hprof 文件
Monkey 通过发送SIGNAL_USR1 给所有的进程,在data/misc目录下生成大概5M左右的 profiling 报告。
但是后来 Dalvik 虚拟机修改了,在收到SIGNAL_USR1信号的时候只会做GC,不会生成HPROF文件。也就是说Monkey的这个参数作废了。
StackOverFlow 解释: https://stackoverflow.com/questions/8351329/android-monkey-not-generating-hprof-dump