1.1  monkeyrunner API

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

1.2 导入需要的模块

方式一：

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()

#等待连接到设备，与模拟器连接，返回monkeydevice对象,代表连接的设备。没有报错的话说明连接成功。
参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
默认连接：device=MonkeyRunner.waitForConnection()
参数连接：device = mr.waitForConnection(1.0,'emulator-5554')

1.3向设备或模拟器安装要测试的APK

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

1.4从设备中删除指定的软件包，包括其相关的数据和调整缓存

device.removePackage('myproject/bin/MyApplication.apk')
删除成功返回true。

1.5启动任意的Activity

device.startActivity(component="your.www.com/your.www.com.TestActivity")
或者
device.startActivity(component="your.www.com/.TestActivity")

此时可以向模拟器发送如按键、滚动、截图、存储等操作了。

执行一个adb shell命令，并返回结果，如果有的话
device.shell("...")

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

1.7 捕捉屏幕写入文件

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

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

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

1.9 唤醒设备屏幕（在设备屏幕上唤醒）

device.wake()

1.10重新引导到指定的引导程序指定的设备

device.reboot()

1.11 touch、press

在指定位置发送触摸事件（x,y的单位为像素）

device.touch(x,y,TouchPressType-触摸事件类型)

1.12发送到指定键的一个关键事件

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.13附录

按下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)