Android自动化测试之MonkeyRunner工具（六）

1、什么是monkeyrunner

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

2、monkeyrunner工具同Monkey工具的差异

Monkey：

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

monkeyrunner：

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

3、monkeyrunner的测试类型

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

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

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

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

4、运行monkeyrunner

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

monkeyrunner的命令语法为：

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

[以上的内容部分摘自互联网，借鉴前人的总结]

5、实例

我这里就以sample中的ApiDemos为例，咱们学习任何同样东西彷佛均可以有自带的Sample开始，能够在开发环境中先将其生成ApiDemos.apk。

前提：已有device链接（这里能够是真实设备，或者模拟器）

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

二、 在$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 test10  11  # to see if the installation worked.12  13 device.installPackage('./ApiDemos.apk')14 15 16  # Runs the component17  18 device.startActivity(component='com.example.android.apis/.ApiDemos')19 20 21  # Presses the Menu button22  23 device.press('KEYCODE_MENU','DOWN_AND_UP')24 25 26  # Takes a screenshot27  28 result = device.takeSnapshot()29 30 31  # Writes the screenshot to a file32  33 result.writeToFile('./shot1.png','png')

 

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

monkeyrunner monkeyrunnerprogram.py

130215 23:35:19.711:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

130215 23:35:20.711:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

130215 23:35:21.711:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: wake.

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice] Error starting command: monkey --port 12345

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]com.android.ddmlib.ShellCommandUnresponsiveException

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.ddmlib.AdbHelper.executeRemoteCommand(AdbHelper.java:408)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.ddmlib.Device.executeShellCommand(Device.java:276)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at com.android.monkeyrunner.adb.AdbMonkeyDevice$1.run(AdbMonkeyDevice.java:89)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.Executors$RunnableAdapter.call(UnknownSource)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.FutureTask$Sync.innerRun(Unknown Source)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.FutureTask.run(Unknown Source)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(Unknown Source)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.util.concurrent.ThreadPoolExecutor$Worker.run(UnknownSource)

130215 23:35:22.835:S [pool-1-thread-1] [com.android.monkeyrunner.adb.AdbMonkeyDevice]  at java.lang.Thread.run(UnknownSource)

130215 23:35:55.632:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: press KEYCODE_MENU.

130215 23:35:58.311:I [main] [com.android.monkeyrunner.MonkeyManager] Monkey Command: quit.

四、 能够Android_Root\tools下查看生成的shot1.png的截图。

6、实例改进

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

一、 在$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 screenshot10 11 result = device.takeSnapshot()12 13 # Writes the screenshot to a file14 15 result.writeToFile('./shotbegin.png','png')16 17 # Presses the Down button18 #这里是咱们加入的主要内容  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 screenshot30 31 result = device.takeSnapshot()32 33 # Writes the screenshot to a file34 35 result.writeToFile('./shotend.png','png')

二、  将画面定位在Apidemos的首页，此时光标定位在第一行。

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

monkeyrunner monkeyrunnerprogram1.py

四、在运行过程当中咱们能够看见光标不断向下移动，而且能够在当前目录下咱们自定义的截图：

运行前：shotbegin.png

 

运行后，shotend.png（在代码中进行了5次KEYCODE_DPAD_DOWN操做）

参考资料：

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