MonkeyRunner简介

一、环境准备：

1、JDK1.8：下载地址：http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html

2、Eclipse:下最新版，下载地址：http://www.eclipse.org/downloads/

3、SDK：下载地址，http://developer.android.com/sdk/installing/installing-adt.html

二、Eclipse 相关设置

1、Pydev插件安装
步骤：打开Eclipse：Help>>Install New Software…
Work with中输入:http://pydev.org/updates

2、Pydev配置Jython开发环境
Step 1: 找到Jython解析器的Jar包并解压（该jar包应该可以在你的SDK\tools\lib下面找到）
Step 2: 解压后把解压文件夹下面的Lib文件拷贝到与Jython解析器Jar包同一层目录下（注意这一步很重要）

Step 3: 打开Windows>>References并定位到Jython Interpreter

Step 4: 点击“New”按钮并选择SDK/Tools/Lib/下面的Jython jar包，然后点击Ok按钮

3、 MonkeyRunner开发环境配置
现在为止我们已经配置好了Jython的开发环境了，我们已经可以创建一个Jython的项目了。但是现在为止我们还没有完成MonkeyRunner的配置，所以现在的Jython项目还不能很方便的开发MonkeyRunner。
其实搭配MonkeyRunner开发环境就是把我们需要的包加入到Jython的PYTHONPATH里面，方便我们直接引用。
Step 1: 打开Window>>Preferrences
Step 2: 定位到PyDev>>Interpreters>>Jython Interpreter
Step 3: 点击右边的”New Jar/Zips”按钮，开始选择你的SDK下面的\tools\lib下面你需要用到的Jar包，以下是我用到的

三、MonkeyRunner代码编写与运行

1、代码如下：

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice  # Connects to the current device, returning a MonkeyDevice object  device = MonkeyRunner.waitForConnection()  # Installs the Android package. Notice that this method returns a boolean, so you can test  # to see if the installation worked.  #device.installPackage('myproject/bin/MyApplication.apk')  device.installPackage('D:\Java\ContactManager.apk')# sets a variable with the package's internal name  package = 'com.example.android.contactmanager'  # sets a variable with the name of an Activity in the package  activity = 'com.example.android.contactmanager.ContactManager'  # sets the name of the component to start  runComponent = package + '/' + activity  # Runs the component  device.startActivity(component=runComponent)  # Presses the Menu button  device.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP)  # Takes a screenshot  result = device.takeSnapshot()  # Writes the screenshot to a file  result.writeToFile('D:\shot1.png','png')  

2、代码运行

四 、MonkeyRunner语法

1、monkeyrunner

monkeyrunner工具提供了一个API，运用该API编写的程序可以不用通过android代码来直接控制android设备和模拟器，我们可以写一个python程序对android应用程序或测试包进行安装、运行、发送模拟击键，对用户界面进行截图并将截图存储在workstation上等操作。monkeyrunner工具的主要设计目的是用于测试application/framework层上的应用程序和设备、或用于运行单元测试套件，也可以用于其它目的。

2、 monkeyrunner为android测试提供了以下独特的功能：
1）多设备控制:monkeyrunner API可以跨多个设备或模拟器实施测试套件。可以在同一时间接上所有设备或一次启动全部模拟器，依据程序依次连接到每一个，然后运行一个或多个测试。也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。
2）功能测试:monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。
3）回归测试:monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。
）4可扩展的自动化：由于monkeyrunner是一个API工具包，我们可以开发基于python模块和程式的一整套系统，以此来控制android设备。除了使用monkeyrunner API，我们还可以使用标准的python os和ubprocess模块来调用android debug bridge这样的android工具。如ADB这样的android工具，也可以将自己写的类添加到monkeyrunner API中。

3、运行monkeyrunner

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

4、monkeyrunner命令语法

monkeyrunner -plugin

5、monkeyrunner API

主要包括三个模块
1）MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。
2）MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。
3）MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。

6、导入需要的模块

方式一：

import sys
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
如果给导入的模块起了别名，就应该使用别名，而不能使用原名，否则会出现错误。
比如连接设备或模拟器，起了以上别名后，命令应该如下：
device=mr.waitForConnection()

方式二：
from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage

方式三：
import com.android.monkeyrunner
但是在使用时，就显得特别麻烦
device=com.android.monkeyrunner.MonkeyRunner.waitForConnection()

方式四：
我们也可以给它一个别名
import com.android.monkeyrunner as cam
但是在使用时，就显得特别麻烦
device=cam.MonkeyRunner.waitForConnection()

参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
默认连接：device=MonkeyRunner.waitForConnection()
参数连接：device = mr.waitForConnection(1.0,’emulator-5554’)

7、向设备或模拟器安装要测试的APK
device.installPackage(‘myproject/bin/MyApplication.apk’) #参数是相对或绝对APK路径
路径级别用“/”，不能用“\”，比如d:\www\a.apk，而应该写成d:/www/a.apk
安装成功返回true,此时查看模拟器我们可以在IDLE界面上看到安装的APK的图标了。

8、从设备中删除指定的软件包，包括其相关的数据和调整缓存
device.removePackage(‘myproject/bin/MyApplication.apk’)
删除成功返回true。

9、 启动任意的Activity
device.startActivity(component=”your.www.com/your.www.com.TestActivity”)
或者
device.startActivity(component=”your.www.com/.TestActivity”)

此时可以向模拟器发送如按键、滚动、截图、存储等操作了。
执行一个adb shell命令，并返回结果，如果有的话
device.shell(“…”)

10、 暂停目前正在运行的程序指定的秒数
MonkeyRunner.sleep(秒数，浮点数)

11、 捕捉屏幕写入文件

获取设备的屏蔽缓冲区，产生了整个显示器的屏蔽捕获。（截图）
result=device.takeSnapshot()
返回一个MonkeyImage对象（点阵图包装），我们可以用以下命令将图保存到文件
result.writeToFile(‘takeSnapshot\result1.png’,’png’)

MonkeyImage.writeToFile(参数1:输出文件名，也可以包括路径,参数2:目标格式)
写成功返回true，否则返回false

12、type
键盘上的类型指定的字符串，这相当于要求每个字符串中的字符按（键码，DOWN_AND_UP）.
字符串发送到键盘
device.type(‘字符串’)

13、唤醒设备屏幕（在设备屏幕上唤醒）

device.wake()

14、 重新引导到指定的引导程序指定的设备
device.reboot()

15、touch、press
在指定位置发送触摸事件（x,y的单位为像素）
device.touch(x,y,TouchPressType-触摸事件类型)
发送到指定键的一个关键事件
device.press(参数1:键码,参数2:触摸事件类型)
参数1：见android.view.KeyEvent
参数2，如有TouchPressType()返回的类型－触摸事件类型，有三种。
1）DOWN 发送一个DOWN事件。指定DOWN事件类型发送到设备，对应的按一个键或触摸屏幕上。
2）UP 发送一个UP事件。指定UP事件类型发送到设备，对应释放一个键或从屏幕上抬起。
3）DOWN_AND_UP 发送一个DOWN事件，然后一个UP事件。对应于输入键或点击屏幕。
以上三种事件做为press()或touch()参数。原英文如下：
use this with the type argument of press() or touch() to send a down event.

为了模拟输入键，发送DOWN_AND_UP。
参数1的部分具体内容逻辑：
按下HOME键 device.press(‘KEYCODE_HOME’,MonkeyDevice.DOWN_AND_UP)
按下BACK键 device.press(‘KEYCODE_BACK’,MonkeyDevice.DOWN_AND_UP)
按下下导航键 device.press(‘KEYCODE_DPAD_DOWN’,MonkeyDevice.DOWN_AND_UP)
按下上导航键 device.press(‘KEYCODE_DPAD_UP’,MonkeyDevice.DOWN_AND_UP)
按下OK键 device.press(‘KEYCODE_DPAD_CENTER’,MonkeyDevice.DOWN_AND_UP)

device.press(‘KEYCODE_ENTER’,MonkeyDevice.DOWN_AND_UP)#输入回车
device.press(‘KEYCODE_BACK’,MonkeyDevice.DOWN_AND_UP)#点击返回

home键 KEYCODE_HOME
back键 KEYCODE_BACK
send键 KEYCODE_CALL
end键 KEYCODE_ENDCALL
上导航键 KEYCODE_DPAD_UP
下导航键 KEYCODE_DPAD_DOWN
左导航 KEYCODE_DPAD_LEFT
右导航键 KEYCODE_DPAD_RIGHT
ok键 KEYCODE_DPAD_CENTER
上音量键 KEYCODE_VOLUME_UP
下音量键 KEYCODE_VOLUME_DOWN
power键 KEYCODE_POWER
camera键 KEYCODE_CAMERA
menu键 KEYCODE_MENU

参考：http://www.cnblogs.com/ITGirl00/