Android自动化学习笔记之MonkeyRunner：官方介绍和简单实例

下面来学习一下官方文档: (简介翻译来自网络)

一、什么是monkeyrunner

monkeyrunner工具提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图 片，并将截图存储于工作站上。monkeyrunner工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。

二、Monkey和MonkeyRunner

Monkey工具直接运行在设备或模拟器的adb shell中，生成用户或系统的伪随机事件流。

相比较之下，MonkeyRunner工具则是在工作站上通过API定义的特定命令和事件来控制设备或模拟器

三、MonkeyRunner的特色

　　1. 多设备控制：monkeyrunner API可以跨多个设备或模拟器实施测试套件。您可以在同一时间接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。

　　2. 功能测试： monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。

　　3. 回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。

　　4. 可扩展的自动化：由于monkeyrunner是一个API工具包，您可以基于Python模块和程序开发一整套系统，以此来控制Android设备。除 了使用monkeyrunner API之外，您还可以使用标准的Python os和subprocess模块来调用Android Debug Bridge这样的Android工具。

四、Monkeyrunner运行环境

无论怎么运行，都需要调用 SDK目录的tools子目录下的monkeyrunner命令。如果您提供一个文件名作为运行参数，则monkeyrunner将视文件内容为 Python程序，并加以运行；否则，它将提供一个交互对话环境。

monkeyrunner的命令语法为：

monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>

五、官网实例（网上的资料都没有提及，运行脚本之前，必须先把连接到电脑上或者启动模拟器）
官网的例子，不解释。

# Imports the monkeyrunner modules used by this programfrom com.android.monkeyrunner import MonkeyRunner, MonkeyDevice# Connects to the current device, returning a MonkeyDevice objectdevice = 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')# sets a variable with the package's internal namepackage = 'com.example.android.myapplication'# sets a variable with the name of an Activity in the packageactivity = 'com.example.android.myapplication.MainActivity'# sets the name of the component to startrunComponent = package + '/' + activity# Runs the componentdevice.startActivity(component=runComponent)# Presses the Menu buttondevice.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP)# Takes a screenshotresult = device.takeSnapshot()# Writes the screenshot to a fileresult.writeToFile('myproject/shot1.png','png')

六、实例二(模拟器4.4.2测试通过)：

步骤：截屏-->滑屏-->截屏
目的：学习截屏方法的使用

'''Created on Oct 14, 2014@author: deldong'''print 'Before execution'# Imports the monkeyrunner modules used by this programfrom com.android.monkeyrunner import MonkeyRunner# Connects to the current device, returning a MonkeyDevice objectdevice = MonkeyRunner.waitForConnection() # Takes a screenshotresult = device.takeSnapshot()# Writes the screenshot to a fileresult.writeToFile('./beforeDrag.png','png')#多嘴一句，这里的截图，其实是存放在..sdk/tools下面，找了1天有木有······#当然这里也可以写绝对路径，比如c:\screenshot\beforeDrag.png #Drag screen from right to leftfor i in range(0,3):    device.drag((600,200),(100,200),0.1,10)    MonkeyRunner.sleep(1) #Takes a screenshotresult = device.takeSnapshot()#Writes the screenshot to a fileresult.writeToFile('./afterDrag.png','png')print 'After execution'

七、实例三（诺基亚X2手机测试通过）：

步骤：安装APK-->打开APK-->关闭APK-->重复打开关闭操作N次-->卸载APK
目的：写个压力测试的脚本玩玩

'''Created on Oct 16, 2014@author: deldong'''# -*- coding: UTF-8 -*-import sys#因为系统是英文系统，打汉字的话，必须用添加# -*- coding: UTF-8 -*-reload(sys)sys.setdefaultencoding("utf-8")# 导入所需的方法from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice#连接我的Nokia手机print ("Connecting device.....")NokiaDevice = MonkeyRunner.waitForConnection()if not NokiaDevice:    print ("Please connect a device to start!")else:    print ("Device Connected successfully!")#安装apktry:    NokiaDevice.installPackage('C:/apps/MyFirstApp.apk')    print ("Package installed successfully! ")except:    print ("Package installation failed!")#设置包名package = 'com.example.myfirstapp'#设置activity名activity = 'com.example.myfirstapp.MainActivity'#循环执行四次for i in range(1,5):    #打开已安装的应用    print ("Open installed package for the %d time"%i)    NokiaDevice.startActivity(component=package + '/' + activity)    #等待5秒    print ("wait 5 sec")    MonkeyRunner.sleep(5)    #关闭应用    print("Quit the application")    NokiaDevice.press("KEYCODE_BACK",NokiaDevice.DOWN_AND_UP)    print ("wait 5 sec")    MonkeyRunner.sleep(5)#卸载APKtry:    print("Uninstall package!")    NokiaDevice.removePackage("com.example.myfirstapp")    print("Uninstall package successfully")except:    print ("Package unintall failed!")

 

cmd提示：

八、实例四（诺基亚X2手机测试通过）：

步骤：重启手机-->唤醒手机-->输入密码解锁
目的：使用重启和唤醒的方法

# -*- coding: UTF-8 -*-'''Created on Oct 16, 2014@author: deldong'''import sysreload(sys)sys.setdefaultencoding("utf-8")# 导入所需的方法from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice#连接我的Nokia手机print ("Connecting device.....")NokiaDevice = MonkeyRunner.waitForConnection()if not NokiaDevice:    print ("Please connect a device to start!")else:    print ("Device Connected successfully!")#重启设备print("Reboot device!")NokiaDevice.reboot()MonkeyRunner.sleep(60)#唤醒设备print("Wake device")NokiaDevice.wake()print("wait 2s")MonkeyRunner.sleep(2)#解锁 输入密码print("unlock device....")NokiaDevice.drag((400,700),(400,300),0.1,10)MonkeyRunner.sleep(5)NokiaDevice.type('201449')print("unlock successfully")

 

Q&A:

Q：在cmd中执行monkeyrunner c:\test.py脚本时报错

提示：141017 14:35:59.101:S [main] [com.android.monkeyrunner.MonkeyRunnerOptions]SyntaxError: Non-ASCII character in file 'C:\calculator.py', but no encoding declared; see http://www.python.org/peps/pep-0263.html for details

解决办法：在脚本的第一行添加中文的注释语句代码：# -*- coding: UTF-8 -*-
如果还不行的话，多添加下面三行代码即可。

import sysreload(sys)sys.setdefaultencoding("utf-8")

九、常用命令：

1.安装Android包，此方法返回的返回值为boolean，由此可以判断安装过程是否正常
device.installPackage('文件名')
#参数是相对或绝对APK路径
路径级别用“/”，不能用“\”，比如d:\www\a.apk，而应该写成d:/www/a.apk
安装成功返回true,此时查看模拟器我们可以看到安装的APK的图标了。

2.从设备中删除指定的软件包，此方法返回的返回值为boolean，删除其相关的数据和调整缓存
device.removePackage ('包名')

3.启动一个Activity，两种方式
device.startActivity (component='包名/包名.Activity名')
device.startActivity (component='包名/.Activity名')

4.暂停(秒);
MonkeyRunner.sleep(5)

5.截图：
result=device.takeSnapshot()
#此方法返回一个MonkeyImage对象（点阵图包装），我们可以用以下命令将图保存到文件
#result.writeToFile('takeSnapshot\\result1.png','png')
#MonkeyImage.writeToFile(参数1:输出文件名，也可以包括路径,参数2:目标格式)
#写成功返回true，否则返回false。
6.触击屏幕

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

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

发送到指定键的一个关键事件
device.press(参数1:键码,参数2:触摸事件类型)
参数1：见android.view.KeyEvent URL:http://developer.android.com/reference/android/view/KeyEvent.html
参数2，如有TouchPressType()返回的类型－触摸事件类型，有三种。
a、DOWN 发送一个DOWN事件。指定DOWN事件类型发送到设备，对应的按一个键或触摸屏幕上。
b、UP 发送一个UP事件。指定UP事件类型发送到设备，对应释放一个键或从屏幕上抬起。
c、DOWN_AND_UP 发送一个DOWN事件，然后一个UP事件。对应于输入键或点击屏幕。

7.发送按键指令
按下HOME键 device.press('KEYCODE_HOME','DOWN_AND_UP')
按下BACK键 device.press('KEYCODE_BACK','DOWN_AND_UP')
按下下导航键 device.press('KEYCODE_DPAD_DOWN','DOWN_AND_UP')
按下上导航键 device.press('KEYCODE_DPAD_UP','DOWN_AND_UP')
按下OK键 device.press('KEYCODE_DPAD_CENTER','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

八、参考资料：

Google官方文档：
http://developer.android.com/tools/help/monkeyrunner_concepts.html

网络资料：
http://www.cnblogs.com/yyangblog/archive/2011/03/10/1980086.html
http://blog.csdn.net/shy871265996/article/details/9716723

转自疲惫的豆豆的博客