Monkey使用及命令行
Monkey（压力测试工具）
一、 什么是Monkey
Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。
二、Monkey的特征
1、 测试的对象仅为应用程序包，有一定的局限性。
2、 Monkey测试使用的事件流数据流是随机的，不能进行自定义。
3、 可对MonkeyTest的对象，事件数量，类型，频率等进行设置。
三、 Monkey环境搭建
如果想要搭建好Monkey的测试环境，首先几个必要的步骤和环境不能少，分别是java相关环境、Android SDK环境，启动android虚拟机或连接真机、执行monkey测试。
A> java相关环境：
1、首先要安装java的JDK；
2、安装好JDK之后需要配置环境变量，
在“系统变量”中，设置3项属性，JAVA_HOME,PATH,CLASSPATH(大小写无所谓),若已存在则点击“编辑”，不存在则点击“新建”:
JAVA_HOME指明JDK安装路径，就是刚才安装时所选择的路径D:\java\jdk1.5.0_08，此路径下包括lib，bin，jre等文件夹（此变量最好设置，因为以后运行tomcat，eclipse等都需要依*此变量）；
Path使得系统可以在任何路径下识别java命令，设为： %JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
CLASSPATH为java加载类(class or lib)路径，只有类在classpath中，java命令才能识别，设为： .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar (要加.表示当前路径) %JAVA_HOME%就是引用前面指定的JAVA_HOME；
3、“开始”－>;“运行”，键入“cmd”；输入命令“java -version”，“java”，“javac”几个命令，出现画面，说明环境变量配置成功；
B>、安装android SDK环境（此部分我安装时走了些弯路）
1、下载最新的Android SDK ；
2、解压Android SDK文件，里面有两个应用程序： “SDK Manager.exe”（负责下载或更新SDK包） 和 "AVD Manager.exe"（负责创建管理虚拟机）。我们先运行“SDK Manager.exe”进行SDK下载。
3、运行后出现下面的界面，我们选择自己想安装的 Android 版本，我选择了最新版本，然后点击“Install X packages”安装。
4、在新出现的界面上，选择接受并遵守所有许可内容(Accept All)，再点击 “Install”。Android SDK 管理器就开始下载并安装你所选的包了，我们等上一段时间就好了。
5、安装好后，在 Android SDK 管理器界面上你所选的包后面会显示“Installed”，表示已经安装好了。
三、启动我们第一个android环境（即开启虚拟机）
1、回到文件夹界面，运行 AVD Manager.exe。
2、打开 AVD Manager.exe后，点击“New"创建新的模拟器；
3、创建一个新的 Android Virtual Device (AVD)：输入AVD 名称、选择 Target、输入模拟的 SD Card 的容量大小、以及选择外观皮肤 Skin。然后 “Create AVD”。
4、开始运行你新建的模拟器 Virtual Device：选中这个虚拟设备并点击“Start”，在出现的界面上直接点击“Launch”就可以启动 Android 模拟器了。
四、启动Monkey测试环境
1、如果想要启动Monkey测试环境，我们必须要先启动android虚拟机或者连接上真机；
2、如果启动了虚拟机或者连接上了真机，我们来通过“win+R”启动命令行，输入cmd；
3、找到SDK安装包下的adb.exe文件所在的路径，我的机器为：C:\Program Files\Android\android-sdk\platform-tools；粘贴这个地址，在命令行界面进入到这个路径下；
4、然后输入adb shell。进入到#中；
5、此时就可以执行Monkey Test命令了。
五、Monkey的基本用法
基本语法如下：
$ adb shell monkey [options]
如果不指定options，Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包。下面是一个更为典型的命令行示例，它启动指定的应用程序，并向其发送500个伪随机事件：
$ adb shell monkey -p your.package.name -v 500
六、Monkey测试的一个实例
通过这个实例，我们能理解Monkey测试的步骤以及如何知道哪些应用程序能够用Monkey进行测试。
Windows下（注：2—4步是为了查看我们可以测试哪些应用程序包，可省略）：
1、 通过eclipse启动一个Android的emulator
2、 在命令行中输入：adb devices查看设备连接情况
C:\Documents and Settings\Administrator>adb devices
List of devices attached
emulator-5554 device
3、 在有设备连接的前提下，在命令行中输入：adb shell 进入shell界面
C:\Documents and Settings\Administrator>adb shell
#
4、 查看data/data文件夹下的应用程序包。注：我们能测试的应用程序包都在这个目录下面
C:\Documents and Settings\Administrator>adb shell
# ls data/data
ls data/data
com.google.android.btrouter
com.android.providers.telephony
com.android.mms
com.android.providers.downloads
com.android.deskclock
com.android.email
com.android.providers.media
com.android.settings
jp.co.omronsoft.openwnn
com.android.providers.userdictionary
com.android.quicksearchbox
com.android.protips
com.android.browser
com.android.launcher
com.android.term
com.android.speechrecorder
com.android.server.vpn
com.android.defcontainer
com.svox.pico
com.android.customlocale
com.android.development
com.android.soundrecorder
com.android.providers.drm
com.android.spare_parts
com.android.providers.downloads.ui
com.android.fallback
com.android.providers.applications
com.android.netspeed
com.android.wallpaper.livepicker
android.tts
com.android.htmlviewer
com.android.music
com.android.certinstaller
com.android.inputmethod.pinyin
com.android.providers.subscribedfeeds
com.android.inputmethod.latin
com.android.gallery
com.android.systemui
com.android.contacts
com.android.phone
com.android.sdksetup
com.android.calculator2
com.android.packageinstaller
com.android.camera
com.android.providers.settings
com.thestore.main
com.android.providers.contacts
5、 以com.android.calculator2作为对象进行MonkeyTest
#monkey -p com.android.calculator2 -v 500
其中-p表示对象包 –v 表示反馈信息级别
运行过程中，Emulator中的应用程序在不断地切换画面。
按照选定的不同级别的反馈信息，在Monkey中还可以看到其执行过程报告和生成的事件。
注：具体参数的设定可参考：
http://developer.android.com/guide/developing/tools/monkey.html
七、关于Monkey测试的停止条件
Monkey Test执行过程中在下列三种情况下会自动停止：
1、如果限定了Monkey运行在一个或几个特定的包上，那么它会监测试图转到其它包的操作，并对其进行阻止。
2、如果应用程序崩溃或接收到任何失控异常，Monkey将停止并报错。
3、如果应用程序产生了应用程序不响应(application not responding)的错误，Monkey将会停止并报错。
通过多次并且不同设定下的Monkey测试才算它是一个稳定性足够的程序。
Monkey命令行
常规
--help
列出简单的用法。
-v
命令行的每一个-v将增加反馈信息的级别。
Level 0(缺省值)除启动提示、测试完成和最终结果之外，提供较少信息。
Level 1提供较为详细的测试信息，如逐个发送到Activity的事件。
Level 2提供更加详细的设置信息，如测试中被选中的或未被选中的Activity。
日志级别 Level 0
*示例 adbshell monkey -p com.htc.Weather –v 100
说明缺省值，仅提供启动提示、测试完成和最终结果等少量信息
日志级别 Level 1
*示例 adbshell monkey -p com.htc.Weather –v -v 100
说明 提供较为详细的日志，包括每个发送到Activity的事件信息
日志级别 Level 2
*示例 adbshell monkey -p com.htc.Weather –v -v –v 100
说明 最详细的日志，包括了测试中选中/未选中的Activity信息事件
-s <seed>
用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。
* 示例：
Monkey测试1：adb shellmonkey -p com.htc.Weather –s 10 100
Monkey 测试2：adb shellmonkey -p com.htc.Weather –s 10 100
两次测试的效果是相同的，因为模拟的用户操作序列（每次操作按照一定的先后顺序所组成的一系列操作，即一个序列）是一样的。操作序列虽 然是随机生成的，但是只要我们指定了相同的Seed值，就可以保证两次测试产生的随机操作序列是完全相同的，所以这个操作序列伪随机的；
--throttle<milliseconds>
在事件之间插入固定延迟。通过这个选项可以减缓Monkey的执行速度。如果不指定该选项，Monkey将不会被延迟，事件将尽可能快地被产成。
* 示例：adb shellmonkey -p com.htc.Weather –throttle 3000 100
--pct-touch<percent>
调整触摸事件的百分比(触摸事件是一个down-up事件，它发生在屏幕上的某单一位置)。
* 示例：adb shellmonkey -p com.htc.Weather --pct-touch 10 1000
--pct-motion<percent>
调整动作事件的百分比(动作事件由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成)。
* 示例：adb shellmonkey -p com.htc.Weather --pct-motion 20 1000
--pct-trackball<percent>
调整轨迹事件的百分比(轨迹事件由一个或几个随机的移动组成，有时还伴随有点击)。
* 示例：adb shellmonkey -p com.htc.Weather --pct-trackball 30 1000
--pct-nav<percent>
调整“基本”导航事件的百分比(导航事件由来自方向输入设备的up/down/left/right组成)。
* 示例：adb shellmonkey -p com.htc.Weather --pct-nav 40 1000
--pct-majornav<percent>
调整“主要”导航事件的百分比(这些导航事件通常引发图形界面中的动作，如：5-way键盘的中间按键、回退按键、菜单按键)
* 示例：adb shellmonkey -p com.htc.Weather --pct-majornav 50 1000
--pct-syskeys<percent>
调整“系统”按键事件的百分比(这些按键通常被保留，由系统使用，如Home、Back、Start Call、End Call及音量控制键)。
* 示例：adb shellmonkey -p com.htc.Weather --pct-syskeys 60 1000
--pct-appswitch<percent>
调整启动Activity的百分比。在随机间隔里，Monkey将执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法。
* 示例：adb shellmonkey -p com.htc.Weather --pct-appswitch 70 1000
--pct-anyevent<percent>
调整其它类型事件的百分比。它包罗了所有其它类型的事件，如：按键、其它不常用的设备按钮、等等。* 示例：adb shell monkey -p com.htc.Weather
--pct -anyevent 1001000* 指定多个类型事件的百分比：
adb shell monkey -pcom.htc.Weather --pct-anyevent 50 --pct-appswitch 50 1000
注意：各事件类型的百分比总数不能超过100%；
约束限制
-p<allowed-package-name>
如果用此参数指定了一个或几个包，Monkey将只允许系统启动这些包里的Activity。如果你的应用程序还需要访问其它包里的Activity(如选择取一个联系人)，那些包也需要在此同时指定。如果不指定任何包，Monkey将允许系统启动全部包里的Activity。要指定多个包，需要使用多个 -p选项，每个-p选项只能用于一个包。
* 指定一个包： adb shell monkey -p com.htc.Weather 100
说明：com.htc.Weather为包名，100是事件计数（即让Monkey程序模拟100次随机用户事件）。
* 指定多个包：adb shell monkey -p com.htc.Weather –pcom.htc.pdfreader -p com.htc.photo.widgets 100
* 不指定包：adb shell monkey 100
说明：Monkey随机启动APP并发送100个随机事件。
* 要查看设备中所有的包，在CMD窗口中执行以下命令：
>adb shell
#cd data/data
#ls
-c<main-category>
如果用此参数指定了一个或几个类别，Monkey将只允许系统启动被这些类别中的某个类别列出的Activity。如果不指定任何类别，Monkey将选 择下列类别中列出的Activity： Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY。要指定多个类别，需要使用多个-c选项，每个-c选 项只能用于一个类别。
调试
--dbg-no-events
设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不会再进一步生成事件。为了得到最佳结果，把它与-v、一个或几个包约 束、以及一个保持Monkey运行30秒或更长时间的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换。
--hprof
设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告。这将会在data/misc中生成大文件(~5Mb)，所以要小心使用它。
--ignore-crashes
通常，当应用程序崩溃或发生任何失控异常时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成。
* 示例1：adb shellmonkey -p com.htc.Weather --ignore-crashes 1000
测试过程中即使Weather程序崩溃，Monkey依然会继续发送事件直到事件数目达到1000为止；
* 示例2：adb shell monkey -p com.htc.Weather 1000
测试过程中，如果Weather程序崩溃，Monkey将会停止运行。
--ignore-timeouts
通常，当应用程序发生任何超时错误(如“Application Not Responding”对话框)时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成。
--ignore-security-exceptions
通常，当应用程序发生许可错误(如启动一个需要某些许可的Activity)时，Monkey将停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成。
--kill-process-after-error
通常，当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系统停止发生错误的进程。注意，正常的(成功的)结束，并没有停止启动的进程，设备只是在结束事件之后，简单地保持在最后的状态。
--monitor-native-crashes
监视并报告Android系统中本地代码的崩溃事件。如果设置了--kill-process-after-error，系统将停止运行。
--wait-dbg
停止执行中的Monkey，直到有调试器和它相连接。
