MonkeyRunner

环境搭建

1. 下载Android SDK
2. 打开终端，并输入:   open ~/.bash_profile
3. 在打开的文件中输入：  export PATH=${PATH}:/Users/SvenWeng/Desktop/android-sdk-macosx/platform-tools/:/Users/SvenWeng/Desktop/android-sdk-macosx/tools/bin/
4. 回到终端，输入：  source ~/.bash_profile
5. 验证:  在终端输入  monkehyrunner
    如果出现以下文本就表明配置成功：
    
    kakaka:~ kaka$ monkeyrunner
    Jython 2.5.3 (2.5:c56500f08d34+, Aug 13 2012, 14:54:35)
    [Java HotSpot(TM) 64-Bit Server VM (Apple Inc.)] on java1.6.0_65
    >>>

MonkeyRunner 介绍

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

功能

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中。

运行Monkeyrunner

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

monkeyrunner API

主要包括3各模块：

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

命令语法

monkeyrunner -plugin <plugin_jar> <programe_filename> <programe_option>

命令

// 导入需要的模块 方法1：(可以同时起别名)
import sys                   // ?
from com.android.monkeyrunner import MonkeyRunner as mr  // 导入MonkeyRunner，并起别名
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
注意：  如果给导入的模块起了别名，就应该使用别名，而不能使用原名，否则会出现错误。

// 导入需要的模块 方法2：
from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage

// 等待连接到设备或者模拟器
device = MonkeyRunner.waitForConnection()     // 默认连接
device = mr.waitForConnection(1.0,'emulator-5554')  // 参数说明mr MonkeyRunner别名， 1.0 超时时长， 'emulator-5554' 设备名

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

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

// 启动Activity
device.startActivity('com.xxx.xxx.xx/.xxx.view.impl.TestActivity')
// 或者
device.startActivity(component='com.xxx.xxx.xx/.xxx.view.impl.TestActivity')
// 此时可以向模拟器发送如按键、滚动、截图、存储等操作了。

// 执行一个adb shell命令，并返回结果
device.shell("...")

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

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

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

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

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

// 在指定位置发送触摸事件（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事件。对应于输入键或点击屏幕。

参数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

补充：

本文摘自 <a href='http://www.jianshu.com/p/52742630c311'>http://www.jianshu.com/p/52742630c311</a>