monkey

定义: Android平台自动化测试的一种手段，通过Monkey程序模拟用户触摸屏幕、滑动Trackball、按键等操作来对设备上的程序进行压力测试，检测程序多久的时间会发生异常。

Monkey程序介绍

• Monkey程序由Android系统自带，使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar
• Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行，shell脚本在Android文件系统中的存放路径是：/system/bin/monkey；
• 这样就可以通过在CMD窗口中执行: adb shell monkey ｛+命令参数｝

Monkey命令的简单帮助

• Monkey命令自带的简单帮助，在CMD中执行命令：

  adb shell monkey –help

Monkey命令参数介绍

• 参数1： -p
  用于约束限制，Monkey将只允许系统启动指定的APP。如果不指定包，Monkey将允许系统启动设备中的所有APP。

  • 指定一个包： adb shell monkey -p com.htc.Weather 100
    说明：com.htc.Weather为包名，100是事件计数（即让Monkey程序模拟100次随机用户事件）。
  • 指定多个包：adb shell monkey -p com.htc.Weather –p com.htc.pdfreader -p com.htc.photo.widgets 100
  • 不指定包：adb shell monkey 100
  • 要查看设备中所有的包，在CMD窗口中执行以下命令：

  >adb shell
  #cd data/data
  #ls

• 参数2: -v
  用于指定反馈信息级别

  • 日志级别 Level0

    adb shell monkey -p com.htc.Weather –v 100
    缺省值，仅提供启动提示、测试完成和最终结果等少量信息

  • 日志级别 Level 1

    adb shellmonkey -p com.htc.Weather –v -v 100
    提供较为详细的日志，包括每个发送到Activity的事件信息

  • 日志级别 Level 2

    adb shellmonkey -p com.htc.Weather –v -v –v 100
    最详细的日志，包括了测试中选中/未选中的Activity信息

• 参数3： -s
  用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。

测试1：adb shell monkey -p com.htc.Weather –s 10 100
测试2：adb shell monkey -p com.htc.Weather–s 10 100

两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。操作序列虽 然是随机生成的，但是只要我们指定了相同的See值，就可以保证两次测试产生的随机操作序列是完全相同的，所以这个操作序列伪随 机的；

• 参数4： - -throttle[?θrɑ:tl] <毫秒>
  用于指定用户操作（即事件）间的时延，单位是毫秒；

  adb shell monkey -p com.htc.Weather - -throttle 3000 100

• 参数5： - -ignore[?ɡ?n?r, -?nor]-crashes

  adb shell monkey -p com.htc.Weather - -ignore-crashes 1000

测试过程中即使Weather程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止；

adb shell monkey -p com.htc.Weather 1000

测试过程中，如果Weather程序崩溃，Monkey将会停止运行。

• 参数6： - -ignore-timeouts

用于指定当应用程序发生ANR（Application No Responding）错误时，Monkey是否停止运行。发生ANR错误，Monkey依然会发送事件，直到事件计数完成.

• 参数7： - -ignore-security[s??kj?r?ti]-exceptions[?k’sep??nz]
  用于指定当应用程序发生许可错误时（如证书许可，网络许可等），如果使用此参数，即使应用程序发生许可错误，Monkey依然会发送事件

• 参数8： - -kill-process-after-error
  （注意：应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程）

• 参数9： - -monitor[?mɑ:n?t?(r)]-native-crashes
  用于指定是否监视并报告应用程序发生崩溃的本地代码。

• 参数10： - -pct-｛+事件类别｝｛+事件类别百分比｝
  用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比）

  • 1：- -pct-touch ｛+百分比｝
    调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)

    adb shell monkey -p com.htc.Weather - -pct-touch 10 1000
    //表示触摸占百分之10,单击次数是1000次

  • 2：- -pct-motion[?mo??n] ｛+百分比｝
    调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)

    adb shell monkey -p com.htc.Weather - -pct-motion 20 1000

  • 3–pct-trackball ｛+百分比｝
    调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)

    adb shell monkey -p com.htc.Weather–pct-trackball 30 1000

  • 4- -pct-nav ｛+百分比｝
    调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)

    adb shell monkey -p com.htc.Weather–pct-nav 40 1000

  • 5–pct-majornav ｛+百分比｝
    调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)

    adb shell monkey -p com.htc.Weather–pct-majornav 50 1000

  • 6 –pct-syskeys ｛+百分比｝
    调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、Start Call、End Call及音量控制键)

    adb shell monkey -p com.htc.Weather–pct-syskeys 60 1000

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

    adb shell monkey -p com.htc.Weather–pct-appswitch 70 1000

  • 8 –pct-anyevent ｛+百分比｝
    调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等

    adb shell monkey -p com.htc.Weather

  • 9 –pct -anyevent 100 1000* 指定多个类型事件的百分比：
    adb shell monkey -p com.htc.Weather–pct-anyevent 50 –pct-appswitch 50 1000
    注意：各事件类型的百分比总数不能超过100%；

0：–pct-touch//touch
events percentage[p?r?sent?d?]
触摸事件百分比（触摸事件是一个在屏幕单一位置的按下-抬起事件）

1：–pct-motion//motion
events percentage手势事件百分比（手势事件是由一个在屏幕某处的按下事件、一系列的伪随机移动、一个抬起事件组成）即一个滑动操作，但是是直线的，不能拐弯

2：–pct-pinchzoom//pinch
zoom events percentage二指缩放百分比，即智能机上的放大缩小手势操作

3：–pct-trackball//trackball
events percentage轨迹球事件百分比（轨迹球事件包括一个或多个随机移动，有时还伴有点击。轨迹球现在智能手机上已经没有了，就是类似手柄的方向键一样）

4：–pct-rotation//screen
rotation events percentage屏幕旋转百分比，横屏竖屏

5：–pct-nav//nav
events percentage”基本”导航事件百分比（导航事件包括上下左右，如方向输入设备的输入）老手机的上下左右键，智能机上没有

6：–pct-majornav//major
nav events percentage”主要”导航事件百分比（这些导航事件通常会引发UI的事件，例如5-way pad的中间键、回退键、菜单键）

7：–pct-syskeys//system(key)
operations percentage”系统”按钮事件百分比（这些按钮一般专供系统使用，如Home, Back, Start Call, End Call,音量控制）

8：–pct-appswitch//app
switch events percentage启动activity事件百分比。在随机的间隔里，Monkey会执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法

9：–pct-flip//keyboard
flip percentage键盘轻弹百分比，如点击输入框，键盘弹起，点击输入框以外区域，键盘收回

10：–pct-anyevent//anyevents
percentage其他类型事件百分比。包括了其他所有的类型事件，如按键、其他不常用的设备上的按钮等等。

monkey -p 包名 –pct-touch 47 –pct-motion 10 –pct-anyevent 5 –pct-trackball 8 –pct-syskeys 5 –pct-appswitch 20 –pct-majornav 5 –bugreport -v -v -v -s 16406 –throttle 500 –ignore-crashes –ignore-timeouts –ignore-security-exceptions 1000000 > /sdcard/dsmonkey0328.txt 2>&1 &