Monkey相关参数 笔记

Monkey相关参数  笔记

Monkey是Android系统自带的一个命令行工具，可运行在模拟器里或实际设备中。

Monkey可以向被测试的应用程序发送伪随机的用户事件流（如按键、触屏、手势等），实现对应用程序进行测试的目的。

Monkey是Android自动化测试的一种手段，在模拟器上运行时，若触发了点击、触摸、手势等操作，就会产生随机脉冲信号。

可以通过Monkey用随机重复的方法对应用程序进行稳定性、健壮性方面的测试。

一、基本参数

1．--help 打印帮助信息

2．-v 指定打印信息的详细级别，多一个-v，就增加一个信息的详细级别，级别如下：

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

级别1：-v-v 打印执行时的信息，如发送事件；

级别2：-v-v-v 打印最详细信息。

二、约束条件

1．-p （允许执行的包名列表）若此参数指定了一个或几个包，monkey将只允许指定的系统启动这些包里的Activity。

一个-p只能指定一个包，指定多个包需使用多个-p选项。若不指定包，则默认启动系统里全部包的Activity。

2．-c  该参数是指定意图的分类，monkey只会启动可以处理这些种类的意图的活动。

若没设置该选项，则monkey将选择下列类别中列出的Activity Intent.CATEGORY_LAUNCHER 或Intent.CATEGORY_MONKEY。

若要指定多个类别，需使用多个-c，一个-c只能用于一个类别。

三、事件参数

1．-s （seed）随机种子。用相同的seed值运行Monkey将生成相同的事件序列。

2．--throttle 在事件之间插入固定延迟，可以减缓Monkey执行速度。单位：毫秒。

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

4．--pct-motion <percent> 调整滑动事件的百分比。滑动事件是在某一位置按下手指，滑动一段距离再将手指抬起的手势。

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

6．--pct-nav <percent> 调整基本导航事件的百分比。基本导航事件：模拟方向性设备输入向上、向下、向左、向右的事件。

7．--pct-majornav <percent> 调整主要导航事件的百分比。这些导航事件通常引发图形界面中的动作，如：单击BACK键、MENU键。

8．--pct-syskeys <percent> 调整系统按键事件的百分比。这些按键通常被保留，由系统使用，如：Home、Back、拨号、挂断及音量控制键。

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

10．--pct-appswitch <percent> 调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity() 函数最大程度覆盖包中全部Activity的一种方法。

四、调试参数

1．--dbg-no-events ：设置此选项，Monkey将执行初始启动，进入到一个测试Activity，不会再进一步生成事件。

将它与 –v 、-p、和—throttle等参数一起使用，并让Monkey运行30秒或更长时间，从而可以观测到应用程序所调用的包与包之间的切换过程。

2．--hprof ：设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在data/misc目录下生成大文件（5Mb左右），所以要小心使用。

3．--ignore-crashes ：通常，当应用程序崩溃或发生任何失控异常时，Monkey将停止运行。若设置此选项，Monkey将继续向系统发送事件，直到计数完成。

4．--ignore-timeouts ：应用程序发生任何超时错误（如“Application Not Responding”对话框）时，Monkey将停止运行。

设置 --ignore-timeouts 选项，Monkey将继续向系统发送事件，直到计数完成。

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

6．--ignore-native-crashes ：当应用发生底层C/C++代码引起的崩溃事件时，Monkey将停止运行。

若设置 --ignore-native-crashes 选项，Monkey将继续向系统发送事件，直到计数完成。

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

8．--kill-process-after-error ：当Monkey由于一个错误而停止时，出错的应用程序将继续处于运动状态。设置该选项，将会通知系统停止发生错误的进程。

当Monkey正常执行完毕，它不会关闭所有启动的应用，设备依然保留Monkey结束时的状态。

9．--wait-dbg ：启动Monkey后，先中断其运行，等待调试器和它相连。

五、参数示例

1．-s ：种子数相同，则两次测试所产生的事件序列也相同，便于复现BUG。

第一次输入：adb shell monkey –v –p com.android.calendar 1000

第二次输入：adb shell monkey –v –p com.android.calendar 1000

两次输入的随机种子数都是1000，则测试效果相同，产生的模拟用户操作序列一致，两次测试产生的随机序列相同。

“com.android.calendar”为日历应用的包名（查看包名详见个人随笔：adb相关指令）。

2．-p ：指定一个或多个包进行测试。

adb shell monkey 1000 向系统随机发送1000个伪随机事件序列

adb shell monkey -p com.android.deskclock 1000  向桌面时钟应用随机发送1000个伪随机事件序列

adb shell monkey -p com.android.deskclock -p com.android.calendar 1000

向桌面时钟和日历这两个应用随机发送1000个伪随机事件序列

3．--throttle ：用于指定随机事件的延时。

adb shell monkey -p com.android.deskclock --throttle 2000 1000

向桌面时钟应用发送1000次随机事件序列，序列执行的时间间隔为2000毫秒，即2秒。

4．--pct-touch <percent> ：设置触屏事件的百分比。

adb shell monkey --pct-touch 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中触屏事件占60%。

5．--pct-motion <percent> ：设置滑动事件的百分比。

adb shell monkey --pct-motion 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中滑动事件占60%。

6．--pct-trackball <percent> ：设置轨迹球事件的百分比。

adb shell monkey --pct-trackball 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中轨迹球事件占60%。

7．--pct-nav <percent> ：调整基本导航事件的百分比。

adb shell monkey --pct-nav 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中基本导航事件占60%。

8．--pct-majornav <percent> ：调整主要导航事件的百分比。

adb shell monkey --pct-majornav 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中主要导航事件占60%。

9．--pct-syskeys <percent> ：调整系统按键事件的百分比。

adb shell monkey --pct-syskeys 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中系统按键事件占60%。

10．--pct-anyevent <percent> ：调整其他类型事件的百分比。

adb shell monkey --pct-anyevent 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中其他类型事件占60%。

11．--pct-appswitch <percent> ：调整启动Activity的百分比。

adb shell monkey --pct-appswitch 60 -p com.android.deskclock  1000

向桌面时钟应用发送1000个伪随机事件序列，其中主要覆盖包中60%的活动。

12．--ignore-crashes ：应用程序崩溃或发生任何失控异常时，Monkey继续向系统发送事件，直到计数完成。

adb shell monkey -p com.android.deskclock –ignore-crashes 1000

向桌面时钟应用发送1000次随机事件，无论该应用程序是否崩溃，此命令都会执行完1000次随机事件的发送。

13．--ignore-timeouts ：应用程序发生任何超时错误，Monkey将继续向系统发送事件，直到计数完成。

adb shell monkey -p com.android.deskclock –ignore-timeouts 1000

向桌面时钟应用发送1000次随机事件，测试过程若出现ANR错误，此命令仍会发送事件至1000次为止。

14．--ignore-security-exceptions ：当应用程序发生权限错误，Monkey将继续向系统发送事件，直到计数完成。

adb shell monkey -p com.android.deskclock –ignore-security-exceptions 1000

向桌面时钟应用发送1000次随机事件，测试过程若出现证书许可、网络许可错误，此命令仍会发送事件至1000次为止。

六、终止 Monkey 进程

1．执行 adb reboot 命令重启设备，进程被终止。

2．在终端执行命令：

1）adb shell

2）ps| grep monkey     （查看手机后台monkey进程，第一串数字就是后台运行程序的id数）

3）kill pid id       （运行kill命令杀死进程）