monkey命令

Posted 2020-08-14

介绍：

monkey是一个命令行工具，可以运行在android模拟器里或真实设备中。它可以向系统发送伪随机(pseudo-random)的用户事件流(如按键输入、触摸屏输入、手势输入等)，可以对待测的目标应用或整个 Android 系统进行压力测试。因此 Monkey 测试是一种为了测试软件的稳定性、健壮性的快速有效的方法

官方文档：https://developer.android.com/studio/test/monkey.html

源码：https://github.com/android/platform_development/tree/master/cmds/monkey/src/com/android/commands/monkey

脚本api：http://www.jianshu.com/p/ced7346820f0

jar包路径：/system/framework/Monkey.jar

启动路径：/system/bin/monkey

 

基本语法：adb shell monkey [options] <event-count>

 

adb shell monkey --help  帮助信息

 

adb shell monkey 1000  如果不指定options将会对整个系统中安装的package发送事件流（对整个Android系统进行Monkey压力测试）

 

adb shell monkey -p com.android.settings 1000   这是一个对指定应用（Android自带的系统设置应用）进行Monkey测试，发送的事件流数目为1000

 

adb shell monkey -v -p com.android.calendar 1000  向日历app发送1000次伪随机事件 

-v 参数打印信息的详细级别，可以跟多个（0~2级） 

默认级别是0: -v只打印启动信息，测试完成信息和最终结果信息

级别1: -v -v 打印时执行的一些信息，如发送事件

级别2: -v -v -v 打印最详细的信息

 

adb shell monkey -p com.android.settings 5000 > d:\monkey.log    在PC端执行monkey命令，将信息保存至D盘monkey.log

 

adb shell "monkey -p com.android.settings 5000 > sdcard/monkey.log"     在PC端执行monkey命令，将信息保存至手机的sdcard

 

adb shell monkey -p cn.microinvestment.weitou --pct-touch 100 --ingore-crashes --throttle 1000 -s 100 -v -v 50     设置事件百分比

 

结束monkey进程：

adb shell ps | findstr monkey

adb shell kill 进程ID

   

约束参数：

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

 

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

 

事件参数：

事件 -s<随机数种子> 伪随机数生成器的seed值。如果用相同的seed值再次运行Monkey，它将生成相同的事件序列

 

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

 

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

 

--pct-motion<percent> 调整动作事件的百分比（动作事件是由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成）

 

--pct-trackball<percent>  调整轨迹事件的百分比（轨迹事件由一个或几个随机的移动组成，有时还伴随有点击）

 

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

 

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

 

--pct-syskeys<percent>   调整“系统”按钮事件的百分比（这些按键通常被保留，由系统使用，如Home、Back、StartCall、End   Call及音量控制键）

 

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

 

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

 

--pct-flip PECENT 　

 

--pct-pinchzoom 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将继续向系统发送事件，直到计数完成

 

--ingore-security-exceptions 当应用程序发生权限许可错误时，Monkey将停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成

 

--ingnore-native-crashes 当应用程序发生底层C/C++代码引起的崩溃事件时，Monkey将停止运行。选择此项，Monkey将继续向系统发送事件，直到计数完成

 

--monitor-native-crashes 监视并报告Android系统中Android   C/C++引起的崩溃事件。如果设置了--kill-process-after-error，系统将停止运行

 

--kill-process-after-error 当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系统停止发生错误的进程。注意，当Monkey正常执行完毕，它不会关闭所有启动的应用，设备依然保留Monkey结束时的状态

 

--wait-dbq 启动Monkey后，先中断其运行，等待调试器附加上来

 

monkey黑白名单：

--pkg-blacklist-file   PACKAGE_BlACKLIST_FILE   apk黑名单，屏蔽掉黑名单中的apk (不测试的应用)

--pkg-whitelist-file  PACK_WHITELIST_FILE  apk白名单，只测试包含在白名单中的apk (只测试这部分应用)

不能同时设置黑名单和白名单，以黑名单为例，具体的步骤如下：

1、查找系统的包，并输出到e盘的pkg文档里。adb shell pm list package>e:\pkg.txt

2、将想要加入黑名单的apk的包名放到blacklist.txt里，最后push进设备。adb push e:\blacklist.txt /data/local/tmp/

3、执行Monkey命令。adb shell monkey --pkg-blacklist-file /data/local/tmp/blacklist.txt --throttle 200 200

 

monkey可以作为服务器，将pc端和手机端连接，并对手机端进行操作：

1、adb shell monkey —port 1080   #手机端开启端口

2、adb forward tcp:1080 tcp:1080   #PC跟手机端做映射

3、telnet localhost 1080  #通过telnet连接进行通信，连接之后就可以在cmd里面输入monkey的API（touch等）对手机进行操作了