### 1、Monkeyrunner简介
monkeyrunner即android SDK中自带的工具之一，此工具提供API可按制android设备或模拟器。
monkeyrunner提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。
monkeyrunner工具的主要目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。
### 2、Monkeyrunner工具特性
多设备控制：monkeyrunner API可以跨多个设备或模拟器实施测试套件。您可以在同一时间接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。
功能测试：monkeyrunner可以为一个应用自动化功能测试。为您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。
回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。
可扩展的自动化：由于monkeyrunner是一个API工具包，您可以基于Python模块和程序开发一整套系统，以此来控制Android设备。除了使用monkeyrunner API之外，您还可以使用标准的Python os和subprocess模块来调用如adb这样的Android工具。
### 3、Monkeyrunner工具同Monkey工具的差别
Monkey：
Monkey工具直接运行在设备或模拟器的adb shell中，生成用户或系统的伪随机事件流。
Monkeyrunner：
Monkeyrunner工具是在工作站上通过API定义的特定命令和事件控制设备或模拟器。
Monkeyrunner的优势
1）Monkeyrunner工具在工作站上通过API定义的特定命令和事件控制设备或模拟器（可控）
2）精确控制事件之间的事件
3）可以进行：点触屏、拖拽、长按、键盘事件
4）可以智能截图对比和判断
5）回溯出详细具体的BUG路径
Monkeyrunner优缺点
1） 能完全模拟人工所有操作
2） 有详细的API文档参考
3） 可以写出智能图像对比脚本
4） 支持java和Python两种语言脚本
5） 脚本移植性差
6）仅支持Android平台
### **4、Monkeyrunner环境搭建**
Monkeyrunner的环境搭建，需要安装以下工具：jdk、android sdk、python编译器 及pythonIDE（如果是用Java编写脚本还需搭建Java的开发环境即JavaIDE）
### 5、运行Monkeyrunner
Monkeyrunner API
主要包括三个模块
1、MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。
2、MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。
3、MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。
#引用导入API
Monkeyrunner API
主要包括三个模块
1、MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。
2、MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。
3、MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法
>[danger]# 实例演示
引用导入API
from com.android.monkeyrunner import <module>
运行monkeyrunner
命令语法为：
monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>
方式一：在CMD命令窗口直接运行monkeyrunner
方式二：使用Python编写测试代码文件，在CMD中执行monkeyrunner Findyou.py运行
不论使用哪种方式，您都需要调用SDK目录的tools子目录下的monkeyrunner命令。
注意：在运行monkeyrunner之前必须先运行相应的模拟器或连接真机，否则monkeyrunner无法连接到设备
运行模拟器有两种方法：1、通过eclipse中执行模拟器 2、在CMD中通过命令调用模拟器
这里介绍通过命令，在CMD中执行模拟器的方法
emulator -avd test
上面命令中test是指模拟器的名称。
问题：CMD运行提示monkeyrunner不是内部或外部命令，也不是可运行的程序或批处理文件。
解决：电脑环境变量未配置，将monkeyrunner所在目录配在环境变量里。
变量名：Path
变量值：D:\\android\\android-sdk-windows\\tools;D:\\android\\android-sdk-windows\\platform-tools
### 5、实例
**实例一：卸载旧的APP，安装新的APP**
**准备**
a.连接安卓真机设备
b.运行CMD，检测是否连接成功
CMD>adb devices
问题：CMD运行提示adb不是内部或外部命令，也不是可运行的程序或批处理文件。
解决：电脑环境变量未配置，将adb所在目录配在环境变量里。
>[danger] # monkeyRunner常用API介绍
```
# python引入monkeyRunner模块
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
# 连接设备, 获得一个MonkeyDevice对象
device = MonkeyRunner.waitForConnection()
# 安装apk包. 返回值是boolean，可以判断是否安装成功
device.installPackage('myproject/bin/MyApplication.apk')
# sets a variable with the package's internal name
package = 'com.example.android.myapplication'
# sets a variable with the name of an Activity in the package
activity = 'com.example.android.myapplication.MainActivity'
# sets the name of the component to start
runComponent = package + '/' + activity
# 启动应用程序
device.startActivity(component=runComponent)
# 按下手机的菜单键
device.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP)
# 截图
result = device.takeSnapshot()
# 保存截图
result.writeToFile('myproject/shot1.png','png')
```
>[danger] # monkeyRunner常用API介绍2
```
#需要引入的模块
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
#等待设备连接，30秒超时，后面是设备名称，该名称可以通过执行命令行`adb devices`获得
device = mr.waitForConnection(30,'123123135002735')
#安装apk包
device.installPackage('d:/有道词典V4.0.3.apk'.decode('utf-8'))
#卸载应用程序
device.removePackage('com.youdao.dict')
#启动应用程序
device.startActivity(component='com.youdao.dict/.activity.DictSplashActivity')
#等待程序加载,5秒
mr.sleep(5)
#拖动操作，四个参数，前两个是初始点、结束点坐标，0.5是持续时间，1是步数
device.drag((550,500),(100,500), 0.5, 1)
#触摸操作,三个参数，X坐标、Y坐标，触摸类型
device.touch(80, 1050, "DOWN_AND_UP")
#截图并保存,注意如果名字中有中文，需要进行utf-8编码，否则乱码
now = time.strftime("%Y-%m-%d-%H-%M-%S")
mainPageImage = device.takeSnapshot()
mainPageImage.writeToFile("d:/"+"主页面截图".decode("utf-8")+now+".png", "png")
#点击后退键,键盘码详情可以去查sdk帮助文档，路径：android-sdk-windows/docs/reference/android/view/KeyEvent.html
device.press("KEYCODE_BACK", "DOWN_AND_UP")
#将日志输出到外部文件,在python中使用中文，需要在文件开头将编码设置为utf-8,否则乱码
log = open('d:/monkenyLog.txt', 'w')
log.write("等待手机连接...、\n")
log.close()
#截图比较，sameAs()第二个参数表示相似度，0表示完全不相似，1表示完全相同
imageTrue = mr.loadImageFromFile('d:/shot/true.png')
if(imageTrue.sameAs(mainPageImage, 0.75)):
log.write('截图比较成功\n')
else:
log.write('截图比较失败\n')
```
**方式一：**
1.打开CMD，运行monkeyrunner
2.进入monkeyrunner的shell命令交互模式后，逐条输入以下命令
1from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage
2 device = MonkeyRunner.waitForConnection()
3 device.removePackage('cn.richinfo.thinkdrive')
4 device.installPackage('E:\\\\JAVA\\\\monkeyrunner\\\\Test1\\\\ThinkDrive\_new.apk')
注：每条命令的作用，请见方法二中的注解
实操如图：
c.检查手机app是否已更新
**\*方式二：**
**a.编写Python测试代码**
# File: Test1.py
# Vision: V1.0
# Author: Findyou
# 引入本程序所用到的模块
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage
# 连接手机设备
device = MonkeyRunner.waitForConnection()
# 截图
result = device.takeSnapshot()
# 将截图保存到文件
result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_001.png','png')
# 卸载APP
device.removePackage('cn.richinfo.thinkdrive')
print ('Uninstall Success!')
# 暂停5秒
MonkeyRunner.sleep(5)
# 截图
result = device.takeSnapshot()
result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_002.png','png')
# 安装新的APP
device.installPackage('E:\\JAVA\\monkeyrunner\\Test1\\ThinkDrive_new.apk')
print ('Install Success!')
# 截图
result = device.takeSnapshot()
result.writeToFile('E:\\JAVA\\monkeyrunner\\Test1\\Test1_003.png','png')
注：拷贝运行时请去掉中文注释；或者在开头加入 #coding=utf-8
**b.执行Test1.py脚本**
Monkeyrunner E:\\JAVA\\monkeyrunner\\Test1\\Test1.py
实操如图：
c.检查手机app是否已更新
### 6、学习笔记
#引入程序所用的模块
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage
#引入程序所用的模块，使用别名
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()
#连接到设备或模拟器
#参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
#参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
#默认连接：
device = MonkeyRunner.waitForConnection()
#参数连接：
device = MonkeyRunner.waitForConnection(1.0,'4df74b8XXXXXXX')
#向设备或模拟器安装APK
#以下两种方式都是对的
device.installPackage('E:/JAVA/monkeyrunner/Test1/ThinkDrive\_new.apk')
device.installPackage('E:\\\\JAVA\\\\monkeyrunner\\\\Test1\\\\ThinkDrive\_new.apk')
#参数可以为绝对路径，也可为相对路径
#卸载设备或模拟器中的APK
#参数为APK包名
device.removePackage('cn.richinfo.thinkdrive')
#启动任意的Activity
#device.startActivity(component="包名/启动Activity")
#以下两种都OK
device.startActivity(component="cn.richinfo.thinkdrive/cn.richinfo.thinkdrive.ui.activities.NavigateActivity")
device.startActivity(component="cn.richinfo.thinkdrive/.ui.activities.NavigateActivity")
#手机截图
#获取设备的屏蔽缓冲区，产生了整个显示器的屏蔽捕获。（截图）
result=device.takeSnapshot()
#返回一个MonkeyImage对象（点阵图包装），我们可以用以下命令将图保存到文件
result.writeToFile('E:\\\\JAVA\\\\monkeyrunner\\\\Test1\\\\Test1\_001.png','png')
#暂停
#暂停目前正在运行的程序指定的秒数
#MonkeyRunner.sleep(秒数，浮点数)
MonkeyRunner.sleep(5)
#字符串发送到键盘
#device.type('字符串')
device.type('Findyou')
#唤醒设备屏幕
#锁屏后,屏幕关闭，可以用下命令唤醒
device.wake()
#重起手机
device.reboot()
#模拟滑动
device.drag(X,Y,D,S)
X 开始坐标
Y 结束坐标
D 拖动持续时间(以秒为单位)，默认1.0秒
S 插值点时要采取的步骤。默认值是10
device.drag((100,1053),(520,1053),0.1,10)
#在指定位置发送触摸事件
device.touch(x,y,触摸事件类型)
x,y的单位为像素
触摸事件类型，请见下文中Findyou对device.press描述
device.touch(520,520,'DOWN\_AND\_UP')
#发送指定类型指定键码的事件
#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()参数
#按下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)
KeyCode:
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
