monkeyrunner详细介绍以及编写简单的python脚本 下载本文

内容发布更新时间 : 2024/6/16 15:04:15星期一 下面是文章的全部内容请认真阅读。

MonkeyRunner:

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

monkeyrunner工具与用户界面/应用程序测试工具,也称为monkey工具并无关联。monkey工具直接运行在设备或模拟器的adbshell中,生成用户或系统的伪随机事件流。而monkeyrunner工具则是在工作站上通过API定义的特定命令和事件控制设备或模拟器。

1、MonkeyRunner的特性

1) 多设备控制:monkeyrunner API可以跨多个设备或模拟器实施测试套件。您可以在同

一时间接上所有的设备或一次启动全部模拟器(或统统一起),依据程序依次连接到每一个,然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器,运行一个或多个测试,然后关闭模拟器。 2) 功能测试:monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸

事件的输入数值,然后观察输出结果的截屏。 3) 回归测试:monkeyrunner可以运行某个应用,并将其结果截屏与既定已知正确的结果

截屏相比较,以此测试应用的稳定性。 4) 可扩展的自动化:由于monkeyrunner是一个API工具包,您可以基于Python模块和

程序开发一整套系统,以此来控制Android设备。除了使用monkeyrunner API之外,您还可以使用标准的Python os和subprocess模块来调用如adb这样的Android工具。

您还可以向monkeyrunner API中添加您自己的类。我们将在使用插件扩展monkeyrunner一节中对此进行详细讨论。

2、一个简单的monkeyrunner程序实例

以下为一个简单的monkeyrunner程序,它将会连接到一个设备,创建一个MonkeyDevice对象。使用MonkeyDevice对象,程序将安装一个Android应用包,运行其中一个活动,并向其发送按键事件。程序接下来会将结果截图,创建一个MonkeyImage对象,并使用这个对象截图将保存至.png文件。

# 导入此程序所需的monkeyrunner模块

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice # 连接当前设备,返回一个MonkeyDevice对象 device = MonkeyRunner.waitForConnection()

# 安装Android包,注意,此方法返回的返回值为boolean,由此您可以判断安装过程是否正常 device.installPackage('myproject/bin/MyApplication.apk')

# 运行此应用中的一个活动 device.startActivity(component='com.android.settings/.Settings')

# 按下菜单按键 # 截取屏幕截图

result = device.takeSnapShot # 将截图保存至文件

result.writeToFile('myproject/shot1.png','png') #获取指定区域的图像(200,400,200,400),注意两个括号 result_static=result.getSubImage((200,400,200,400)) #获取d:\\shotbegin.png这张图片

picture = MonkeyRunner.loadImageFromFile('d:\\shotbegin.png','png') #第二截图并获取相同的局部图像

result_static2=picture.getSubImage((200,400,200,400)) #使用.sameAs()对比两张图片,并输出对比结果True或False end=result_static.sameAs(result_static2,1.0) print end

device.press('KEYCODE_MENU','DOWN_AND_UP')

monkeyrunner执行测试时使用.takeSnapshot()截图,默认截取整个屏幕,包含了系统的状态栏。真实手机状态栏中包含如电量/信号量/消息提示等变量,使用.sameAs()对比整个屏幕的截图时就很容易出现错误。而使用.getSubImage()获得局部图像,然后再进行对比,就减少了monkeyrunner执行结果出错的概率。

result.getSubImage((200,400,200,400))中的指定区域值使用Pixel Perfect获取坐标点,或者截图到本地后获取,先获取区域左上角和右下角坐标,前两个值是左上角左边,后两个值是右下角减左上角的坐标。

3、The Monkeyrunner API

monkeyrunnerAPI于com.android.monkeyrunner包中包含三个模块:

1) MonkeyRunner:一个为monkeyrunner程序提供工具方法的类。这个类提供了用于连接

monkeyrunner至设备或模拟器的方法。它还提供了用于创建一个monkeyrunner程序的用户界面以及显示内置帮助的方法。 2) MonkeyDevice:表示一个设备或模拟器。这个类提供了安装和卸载程序包、启动一个

活动以及发送键盘或触摸事件到应用程序的方法。您也可以用这个类来运行测试包。 3) MonkeyImage :表示一个截图对象。这个类提供了截图、将位图转换成各种格式、比

较两个MonkeyImage对象以及写图像到文件的方法。 在python程序中,您将以Python模块的形式使用这些类。monkeyrunner工具不会自动导入这些模块。您必须使用类似如下的from语句:

From com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage 其中,为您想要导入的类名。您可以在一个from语句中导入超过一个模块,其间以逗号分隔。

4、Monkeyrunner命令语法

4.1 导入需要的模块 ① 方式一:

import sys,time,datetime,os

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') 4.2 向设备或模拟器安装要测试的APK

device.installPackage('myproject/bin/MyApplication.apk') #参数是相对或绝对APK路径 路径级别用“/”,不能用“\\”,比如d:\\www\\a.apk,而应该写成d:/www/a.apk

安装成功返回true,此时查看模拟器我们可以在IDLE界面上看到安装的APK的图标了。 4.3 从设备中删除指定的软件包,包括其相关的数据和调整缓存 device.removePackage('myproject/bin/MyApplication.apk') 删除成功返回true。 4.4 启动任意的Activity

device.startActivity(component=\