Android自动测试之Monkey工具 Monkeyrunner

一、  什么是Monkey

Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。
 

二、 Monkey的特征

1、测试的对象仅为应用程序包，有一定的局限性。

2、 Monky测试使用的事件流数据流是随机的，不能进行自定义。

3、可对MonkeyTest的对象，事件数量，类型，频率等进行设置。
 

三、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可以采用两种方式：系统默认方式和script方式

一、默认运行方式：

  adb shell monkey -p package.name -v 30

其中:  可以继续添加一个或者两个 -v 参数， -v参数越多，输出的日志越详细

         最后的数字表示，触发的事件次数

为了更好的查看日志，可以将输出的日志信息重定向到文件中

如：adb shell monkey -p package.name -v 30 > log.txt

二、脚本方式

Android 的monkey test 工具提供了 -f scriptfile 参数，可以指定 test 脚本。在 monkey 的源码 MonkeySourceScript.java 中有一小段注释，里面给了一个不到 10 行例子:

1. /** 
2.  * monkey event queue. It takes a script to produce events 
3.  *  
4.  * sample script format: 
5.  *      type= raw events 
6.  *      count= 10 
7.  *      speed= 1.0 
8.  *      start data >> 
9.  *      captureDispatchPointer(5109520,5109520,0,230.75429,458.1814,0.20784314, 
10.  *          0.06666667,0,0.0,0.0,65539,0) 
11.  *      captureDispatchKey(5113146,5113146,0,20,0,0,0,0) 
12.  *      captureDispatchFlip(true) 
13.  *      ... 
14.  */  

monkey中提供的函数如下：

1. DispatchPointer(long downTime,  long eventTime, int action, float x, float y, float pressure, float size, int metaState, float xPrecision, float yPrecision, int device, int edgeFlags)  
2. DispatchTrackball(long downTime,  long eventTime, int action,  float x, float y, float pressure, float size, int metaState,  float xPrecision, float yPrecision, int device, int edgeFlags)    
3. DispatchKey(long downTime, long eventTime, int action, int code, int repeat, int metaState, int device, int scancode)     
4. DispatchFlip(boolean keyboardOpen)    
5. DispatchPress(int keyCode)    
6. LaunchActivity(String pkg_name, String cl_name)  
7. UserWait(long sleeptime)    
8. LongPress(int keyCode) 

首先本地编写需要的测试的事件 命名为 monkey.script （文件格式无要求），将文件push到手机或模拟器的sdcard中

如： adb push  lujing/monkey.script  /sdcard/

然后执行脚本：

       adb shell monkey -v -f /sdcard/monkey.script

 

附 Example：

type= user
count= 49
speed= 1.0
start data >>
LaunchActivity(com.example.android.notepad, com.example.android.notepad.NotesList)
DispatchPress(KEYCODE_DPAD_DOWN)
LongPress(KEYCODE_DOWN)
DispatchPress(KEYCODE_BACK)

其中 type值可以任意，源码中没有对该值做任何处理。

       count值，在此无效，还是需要在命令行输入需要执行的次数。因为命令行的count值是必填项

 

一、什么是monkeyrunner

monkeyrunner工具提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。monkeyrunner工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。

二、monkeyrunner工具同Monkey工具的差别

Monkey：

Monkey工具直接运行在设备或模拟器的adb shell中，生成用户或系统的伪随机事件流。

monkeyrunner：

monkeyrunner工具则是在工作站上通过API定义的特定命令和事件控制设备或模拟器。

三、monkeyrunner的测试类型

1、多设备控制：monkeyrunner API可以跨多个设备或模拟器实施测试套件。您可以在同一时间接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。

2、 功能测试： monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。

3、 回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。

4、 可扩展的自动化：由于monkeyrunner是一个API工具包，您可以基于Python模块和程序开发一整套系统，以此来控制Android设备。除了使用monkeyrunner API之外，您还可以使用标准的Python os和subprocess模块来调用Android Debug Bridge这样的Android工具。

四、运行monkeyrunner

您可以直接使用一个代码文件运行monkeyrunner，抑或在交互式对话中输入monkeyrunner语句。不论使用哪种方式，您都需要调用SDK目录的tools子目录下的monkeyrunner命令。如果您提供一个文件名作为运行参数，则monkeyrunner将视文件内容为Python程序，并加以运行；否则，它将提供一个交互对话环境。

monkeyrunner的命令语法为：

monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>

五、实例

以sample中的ApiDemos为例，先将其生成ApiDemos.apk。

前提：已有device连接

1、 将ApiDemos.apk放在$Android_Root\tools下。

2、 在$Android_Root\tools下新建一个monkeyrunnerprogram.py文件，里面内容为：

  

    1 
   #
    Imports the monkeyrunner modules used by this program
   

    2 
    
   

    3 
    
   from
    com.android.monkeyrunner 
   import
    MonkeyRunner, MonkeyDevice, MonkeyImage

    4 
   

    5 
    
   #
    Connects to the current device, returning a MonkeyDevice object
   

    6 
    
   

    7 
   device 
   =
    MonkeyRunner.waitForConnection()

    8 
   

    9 
    
   #
    Installs the Android package. Notice that this method returns a boolean, so you can test
   

   10 
    
   

   11 
    
   #
    to see if the installation worked.
   

   12 
    
   

   13 
   device.installPackage(
   '
   ./ApiDemos.apk
   '
   )

   14 
   

   15 
   

   16 
    
   #
    Runs the component
   

   17 
    
   

   18 
   device.startActivity(component
   =
   '
   com.example.android.apis/.ApiDemos
   '
   )

   19 
   

   20 
   

   21 
    
   #
    Presses the Menu button
   

   22 
    
   

   23 
   device.press(
   '
   KEYCODE_MENU
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   24 
   

   25 
   

   26 
    
   #
    Takes a screenshot
   

   27 
    
   

   28 
   result 
   =
    device.takeSnapshot()

   29 
   

   30 
   

   31 
    
   #
    Writes the screenshot to a file
   

   32 
    
   

   33 
   result.writeToFile(
   '
   ./shot1.png
   '
   ,
   '
   png
   '
   )
  

注意：SDK上的例子有些错误，不可直接复制，否则执行命令时会发生错误。具体可与我的上面这段代码对照。
 

3、 打开命令行转到Android_Root\tools目录下运行一下命令：

monkeyrunner monkeyrunnerprogram.py

110307 15:33:19.625:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

110307 15:33:20.625:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

110307 15:33:21.625:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice] Error starting command: monkey --port 12345

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]com.android.ddmlib.ShellCommandUnresponsiveException

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.ddmlib.AdbHelper.executeRemoteCommand(AdbHelper.java:408)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.ddmlib.Device.executeShellCommand(Device.java:276)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.monkeyrunner.adb.AdbMonkeyDevice$1.run(AdbMonkeyDevice.java:89)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.Executors$RunnableAdapter.call(UnknownSource)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.FutureTask$Sync.innerRun(Unknown Source)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.FutureTask.run(Unknown Source)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(Unknown Source)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.ThreadPoolExecutor$Worker.run(UnknownSource)

110307 15:33:22.718:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.lang.Thread.run(UnknownSource)

110307 15:33:57.437:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: press KEYCODE_MENU.

110307 15:33:59.171:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: quit.

注：里面exception的提示我们可以忽略，因为我们可以看见 Monkey Command: press KEYCODE_MENU已经执行成功。

4、 可以Android_Root\tools下查看生成的shot1.png的截图。

六、实例扩展

因为ApiDemos首页上按下MENU键没有菜单出现，为了更加形象化，在实例五的基础上继续试验：

1、 在$Android_Root\tools下新建一个monkeyrunnerprogram1.py文件，里面内容为：

  

    1 
   #
    Imports the monkeyrunner modules used by this program
   

    2 
    
   

    3 
    
   from
    com.android.monkeyrunner 
   import
    MonkeyRunner, MonkeyDevice, MonkeyImage

    4 
   

    5 
   
   #
    Connects to the current device, returning a MonkeyDevice object
   

    6 
   
   

    7 
   device 
   =
    MonkeyRunner.waitForConnection()

    8 
   

    9 
   
   #
    Takes a screenshot
   

   10 
   
   

   11 
   result 
   =
    device.takeSnapshot()

   12 
   

   13 
   
   #
    Writes the screenshot to a file
   

   14 
   
   

   15 
   result.writeToFile(
   '
   ./shotbegin.png
   '
   ,
   '
   png
   '
   )

   16 
   

   17 
   
   #
    Presses the Down button
   

   18 
   
   

   19 
   device.press(
   '
   KEYCODE_DPAD_DOWN
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   20 
   

   21 
   device.press(
   '
   KEYCODE_DPAD_DOWN
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   22 
   

   23 
   device.press(
   '
   KEYCODE_DPAD_DOWN
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   24 
   

   25 
   device.press(
   '
   KEYCODE_DPAD_DOWN
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   26 
   

   27 
   device.press(
   '
   KEYCODE_DPAD_DOWN
   '
   ,
   '
   DOWN_AND_UP
   '
   )

   28 
   

   29 
   
   #
    Takes a screenshot
   

   30 
   
   

   31 
   result 
   =
    device.takeSnapshot()

   32 
   

   33 
   
   #
    Writes the screenshot to a file
   

   34 
   
   

   35 
   result.writeToFile(
   '
   ./shotend.png
   '
   ,
   '
   png
   '
   )
  

2、  将画面定位在Apidemos的首页，并将光标定位在第一项上。

3、  在$Android_Root\tools目录下运行一下命令：

monkeyrunner monkeyrunnerprogram1.py

4、在运行过程中我们可以看见光标不断向下移动，并且可以在当前目录下我们自定义的截图：

运行前：shotbegin.png

 

运行后（做了五次下移操作）：shotend.png

参考资料：

http://developer.android.com/guide/developing/tools/monkeyrunner_concepts.html