Android Monkey测试

Monkey是Google提供的一个命令行工具，可以运行在模拟器或实际设备中。它向系统发送伪随机的用户事件(如按键、手势、触摸屏等输入)，对软件进行稳定与压力测试。 

实例：

Windows保存到电脑:
adb shell monkey -p your.package.name -v --throttle 300 --ignore-timeouts --ignore-crashes --pct-touch 30 --pct-motion 20 --pct-nav 20 --pct-majornav 15 --pct-appswitch 5 --pct-anyevent 5 --pct-trackball 0 --pct-syskeys 0 --bugreport 50000000 > log.txt

Windows保存到手机:
adb shell
monkey -p your.package.name -v --throttle 300 --ignore-timeouts --ignore-crashes --pct-touch 30 --pct-motion 20 --pct-nav 20 --pct-majornav 15 --pct-appswitch 5 --pct-anyevent 5 --pct-trackball 0 --pct-syskeys 0 --bugreport 50000000 > /sdcard/log.txt

标准流与错误流分开保存：
adb shell monkey -p your.package.name -v --throttle 300 --ignore-timeouts --ignore-crashes --pct-touch 30 --pct-motion 20 --pct-nav 20 --pct-majornav 15 --pct-appswitch 5 --pct-anyevent 5 --pct-trackball 0 --pct-syskeys 0 --bugreport 50000000 2 > error.txt 1 > info.txt

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

启动脚本：/system/bin/monkey

基本参数和事件参数：

-p <允许的包名列表>：用此参数指定一个或多个包。指定包之后，Monkey将只允许系统启动指定的App。如果未指定包，Monkey将允许系统启动设备中的所有App。

指定一个包：adb shell monkey -p your.package.name 100

指定多个包：adb shell monkey -p your.package.name1 –p your.package.name2 100

-c：如果用此指定了一个或几个类别，Monkey将只允许系统启动这些类别中列出的Activity。如果不指定任何类别，Monkey将选择下列类别中列出的Activity：Intent.category.LAUNCHER或Intent.category.MONKEY。要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别。

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

Level 0：adb shell monkey -p your.package.name -v 100    //缺省值，仅提供启动提示、测试完成和最终结果等少量信息

Level 1：adb shell monkey -p your.package.name -v -v 100    //提供较为详细的日志，包括每个发送到Activity的事件信息

Level 2：adb shell monkey -p your.package.name -v -v -v 100    //最详细的日志，包括了测试中选中/未选中的Activity信息

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

示例1：adb shell monkey -p your.package.name –s 10 100

示例2：adb shell monkey -p your.package.name –s 10 100

--throttle <毫秒>：用于指定用户操作（即事件）间的时延，单位是毫秒；如果未指定这个参数，Monkey会尽可能快的生成和发送消息。

示例：adb shell monkey -p your.package.name --throttle 300 100

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

示例：adb shell monkey -p your.package.name --pct-touch 10 100

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

示例：adb shell monkey -p your.package.name --pct-motion 20 100

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

示例：adb shell monkey -p your.package.name --pct-trackball 30 100

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

示例：adb shell monkey -p your.package.name --pct-nav 40 100

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

示例：adb shell monkey -p your.package.name --pct-majornav 50 100

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

示例：adb shell monkey -p your.package.name --pct-syskeys 60 100

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

示例：adb shell monkey -p your.package.name --pct-appswitch 70 100

--pct-rotation <percent>：屏幕旋转百分比。

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

示例：adb shell monkey -p your.package.name --pct -anyevent 100 100

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

调试参数：

参数：--ignore-crashes

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

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

参数：--ignore-timeouts

用于指定当应用程序发生ANR（Application No Responding）错误时，Monkey是否停止运行。如果设置了此项，Monkey将继续向系统发送事件，直到计数完成。

参数：--ignore-security-exceptions

用于指定当应用程序发生许可错误时（如证书许可，网络许可等），Monkey是否停止运行。如果设置了此项，Monkey将继续向系统发送事件，直到计数完成。

参数：--dbg-no-events

设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不会再进一步生成事件。最好将它与-v、一个或几个包约束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。

参数：--hprof

设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在/data/misc中生成大文件(~5Mb)，所以要小心使用它。

参数：--monitor-native-crashes

监视并报告Android系统中本地代码的崩溃事件，如果设置了--kill-process-after-error，系统将停止运行。

参数：--kill-process-after-error

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

参数：--ignore-native-crashes

当应用发生底层C/C++代码引起的崩溃事件时，Monkey将停止运行。如果设置了此项，Monkey将继续向系统发送事件，直到计数完成。

参数：--wait-dbg

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

参数：-port

为Monkey开启专用端口。此时Monkey不会帮你乱点击，而此时你自己就是一只Monkey，在你乱点的时候，Monkey会输出你点击后回馈的信息。如果你打完命令后，模拟器上没有启动你所要启动的包，你需要自己启动，但是你只能启动你-p中指定的那几个包，Ctrl+c中断。

参数：--pkg-blacklist-file PACKAGE_BLACKLIST_FILE

黑名单：执行除了黑名单中以外的apk，黑名单的设置方法：

a.创建一个名称为blacklist的txt文档，在文件中输入应用程序的包名，如mms应用，则在文件中输入com.Android.mms；如果有多个应用程序不想被执行，则在文件中添加多个包名，注意包名与包名之间均用回车键。

b.将blacklist.txt文件导入到手机的/data目录下，然后在执行monkey测试的时候使用--pkg-blacklist-file参数再加上blacklist文件的存储路径，其他的参数设置则和测试单一apk没有区别。

参数：--pkg-blacklist-file PACKAGE_WHITELIST_FILE

白名单：只执行在白名单中的apk，白名单的设置方法：

a.白名单的设置方法和黑名单的设置方法基本一致，只是在创建txt文档的时候，文件的命名应为whitelist.txt。

注意：不能同时设置黑名单和白名单。

参数：--bugreport

遇到问题自动生成bugreport报告。

常见错误类型：

ANR、Crash、Exception、Error、Restart System