一、功能
Android自动化测试工具
二、环境配置
1 android-sdk
2 jdk
3 配置python环境
monkeyrunner在Android SDK的tools文件夹下
三、打开方式
1 命令行方式
命令：monkeyrunner
导入monkeyrunner所要使用的模块：
from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice
device=MonkeyRunner.waitForConnection() #连接手机设备
device.installPackage("../samples/android-10/ApiDemos/bin/Apidemos.apk") #安装apk包到手机设备。
device.startActivity(component="com.example.android.apis/com.example.android.apis.ApiDemos") #启动活动
device.reboot() #手机设备重启
device.touch(300,300,'DOWN_AND_UP')
MonkeyRunner.alert("hello")#在emulator上会弹出消息提示
device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)
device.type('hello')#向编辑区域输入文本'hello'
2 Python文件
例如test.py，然后从命令行直接通过monkeyrunner运行：monkeyrunner test.py
实例：test.py
可能出现错误“Can't open specified script file”
原因在于python脚本文件路径不正确
1、将test.py文件存放到monkeyrunner文件同一目录中。可以执行：monkeyrunner test.py 调用
2、指定python文件位置。如果test.py文件在D盘根目录下，可以这样执行：monkeyrunner d:\test.py
如果运行正常，就会在终端看到
from com.android.monkeyrunner import Monkeyrunner,MonkeyDevice,MonkeyImage
device=MonkeyRunner.waitForConnection()
device.installPackage(f:\\Simple.apk")
MonkeyRunner.sleep(3)
device.shell('am force-stop simple.app.SimpleAppActivity')
MonkeyRunner.sleep(3)
device.startActivity(component='simple.app/simple.app.SimpleAppActivity')
device.drag((288,204),(288,1024),3,1)
MonkeyRunner.sleep(3)
result = device.takeshot()
result.writeToFile('d:\\simp.png','png')
3、利用monkey_recorder.py进行脚本录制及回放
下载monkeyrunner_py脚本.rar文件并解压到tools文件夹下
1、连接手机设备
2、在控制台输入monkeyrunner monkey_recorder.py
3、操作手机界面
4、点击export actions将脚本导出
5、在控制台输入monkeyrunner monkey_playback.py +脚本路径和文件名称
四、monkeyrunner语法
1 monkeyrunner命令语法
monkeyrunner -plugin <plugin_jar> <programe_filename> <programe_option>
2 monkeyrunner API
主要包括三个模块
1、MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。
2、MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。
3、MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。
注意：在运行monkeyrunner之前必须先运行相应的模拟器，否则monkeyrunner无法连接到设备
运行模拟器有两种方法：1、通过eclipse中执行模拟器 2、在CMD中通过命令调用模拟器
3 命令：emulator -avd test
上面命令中test是指模拟器的名称。
4 导入需要的模块（有四种写法）
import sys
1、
from com.android.monkeyrunner import MonkeyRunner as mr
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
3、
import com.android.monkeyrunner
4、
import com.android.monkeyrunner as cam
等待连接到设备，与模拟器连接，返回monkeydevice对象,代表连接的设备。没有报错的话说明连接成功。
参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
默认连接：device=MonkeyRunner.waitForConnection()
参数连接：device = mr.waitForConnection(1.0,'emulator-5554')
5 向设备或模拟器安装要测试的APK
device.installPackage('myproject/bin/MyApplication.apk')
安装成功返回true
6 从设备中删除指定的软件包，包括其相关的数据和调整缓存
device.removePackage('myproject/bin/MyApplication.apk')
删除成功返回true。
7 启动任意的Activity
device.startActivity(component="your.www.com/your.www.com.TestActivity")
device.startActivity(component="your.www.com/.TestActivity")
执行一个adb shell命令，并返回结果，如果有的话
device.shell("...")
8 暂停目前正在运行的程序指定的秒数
MonkeyRunner.sleep(秒数，浮点数)
9 对比截屏和已存在图片
result=device.takeSnapshot()
返回一个MonkeyImage对象（点阵图包装）
result.writeToFile('takeSnapshot\result1.png','png')
pic2=MonkeyRunner.loadImageFromFile('D:\picture2.png')
if (result.sameAs(pic2,0.9)):
print ("Success")
else:
print("Failure")
10 写文件MonkeyImage
MonkeyImage.writeToFile(参数1:输出文件名，也可以包括路径,参数2:目标格式)
写成功返回true，否则返回false
11 键盘上的类型指定的字符串
相当于要求每个字符串中的字符按（键码，DOWN_AND_UP）
12 字符串发送到键盘
device.type('字符串')
13 唤醒设备屏幕（在设备屏幕上唤醒）
device.wake()
14 重启设备
device.reboot()
15 单击操作
device.touch(x,y,TouchPressType-触摸事件类型) x,y的单位为像素
device.touch(200,300,'DOWN_AND_UP')
16 控制多个设备
from com.android.monkeyrunner import Monkeyrunner,MonkeyDevice,MonkeyImage
device1=MonkeyRunner.waitForConnection(5，'b4726a2d')
device2=MonkeyRunner.waitForConnection(5，'5dfadsf32scda')
device1.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)
device1.typr('monkeyrunner')
device2.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)
device2.typr('monkeyrunner')
17 发送到指定键的一个关键事件
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.
18 参数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)#点击返回
菜单键 KEYCODE_MENU
home键 KEYCODE_HOME
返回键 KEYCODE_BACK
搜索键 KEYCODE_SEARCH
呼叫键 KEYCODE_CALL
结束键 KEYCODE_ENDCALL
上导航键 KEYCODE_DPAD_UP
下导航键 KEYCODE_DPAD_DOWN
左导航 KEYCODE_DPAD_LEFT
右导航键 KEYCODE_DPAD_RIGHT
ok键 KEYCODE_DPAD_CENTER
上音量键 KEYCODE_VOLUME_UP
下音量键 KEYCODE_VOLUME_DOWN
电源键 KEYCODE_POWER
相机键 KEYCODE_CAMERA
