App 专项测试之Monkey

一、Monkey 简介

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

Monkey 程序由 Android 系统自带，使用 Java 语言写成，在 Android 文件系统中的存放路径是：/system/framework/monkey.jar。

Monkey.jar 程序是由一个名为 “monkey” 的 shell 脚本来启动执行，shell 脚本在 Android 文件系统中的存放路径是：/system/bin/monkey，可以在 CMD 窗口中执行  adb shell monkey ｛+命令参数｝ 来进行 Monkey 测试。

1.1 windows 下配置 adb 环境

1. 下载 android-sdk-windows 并配置环境变量如 D:\android-sdk-windows\platform-tools

2. 下载安装 JDK，并配置环境变量

3. 进入 cmd，执行命令 adb shell monkey –p 应用包名 –v 1000

1.2 查看 monkey 帮助信息

adb shell monkey –help

二、Monkey命令参数介绍

2.1 -p 指定启动 app

-p 参数用来指定一个或多个包（Package，即App），Monkey 将只允许系统启动指定的 APP；如果不指定包，Monkey将允许系统启动设备中的所有APP。

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

adb shell
cd data/data
ls

2.2 -v 指定日志级别

-v 参数用于指定反馈信息（日志）的详细程度，一共 3 个级别，分别对应的参数如下表：

• 日志级别 Level 0：仅提供启动提示、测试完成和最终结果等少量信息，如  adb shell monkey -pcom.htc.Weather –v 100 
• 日志级别 Level 1：提供较为详细的日志，包括每个发送到 Activity 的事件信息，如  adb shell monkey -pcom.htc.Weather –v -v 100 
• 日志级别 Level 2：最详细的日志，包括了测试中选中/未选中的 Activity 信息，如 adb shell monkey -pcom.htc.Weather –v -v –v 100 

2.3 -s 伪随机数生成器

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

adb shell monkey -p com.htc.Weather –s 10 100
adb shell monkey -p com.htc.Weather –s 10 100

以上两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。

2.4 --throttle <毫秒> 时间时延

用于指定用户操作（即事件）间的时延，单位是毫秒；

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

2.5 --ignore-crashes 崩溃时是否停止

用于指定当应用程序崩溃时（Force & Close错误），Monkey 是否停止运行。如果使用此参数，即使应用程序崩溃，Monkey 依然会发送事件，直到事件计数完成。

• 示例1： adbshell monkey -p com.htc.Weather --ignore-crashes 1000 测试过程中即使Weather程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止；
• 示例2： adbshell monkey -p com.htc.Weather 1000 测试过程中，如果Weather程序崩溃，Monkey将会停止运行。

2.6 --ignore-timeouts

用于指定当应用程序发生ANR（ApplicationNo Responding）错误时，Monkey是否停止运行。如果使用此参数，即使应用程序发生ANR错误，Monkey依然会发送事件，直到事件计数完成。

2.7 --ignore-security-exceptions

用于指定当应用程序发生许可错误时（如证书许可，网络许可等），Monkey是否停止运行。如果使用此参数，即使应用程序发生许可错误，Monkey依然会发送事件，直到事件计数完成。

2.8 --kill-process-after-error

用于指定当应用程序发生错误时，是否停止其运行。如果指定此参数，当应用程序发生错误时，应用程序停止运行并保持在当前状态（注意：应用程序仅是静止在发生错误时的状态，系统并不会结束该应用程序的进程）。

2.9 --monitor-native-crashes

用于指定是否监视并报告应用程序发生崩溃的本地代码。

2.10 --pct-｛+事件类别｝ ｛+事件类别百分比｝

用于指定每种类别事件的数目百分比（在Monkey事件序列中，该类事件数目占总事件数目的百分比）

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

adb shell monkey -p com.htc.Weather --pct-touch 10 1000

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

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

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

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

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

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

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

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

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

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

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

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

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

• --pct -anyevent 100 1000 ：指定多个类型事件的百分比：

注意：各事件类型的百分比总数不能超过100%；