Android本身主动化測试之Monkeyrunner用法及实例

眼下android SDK里自带的现成的測试工具备monkey 和 monkeyrunner两个。你们别看这俩兄弟名字相像，但事实上是彻底然全不一样的两个工具，应用在不一样的測试领域。总的来讲，monkey主要应用在压力和可靠性測试上，执行该命令可以随机地向目标程序发送各类模拟键盘事件流，并且可以自定义发送的次数，以此观察被測应用程序的稳定性和可靠性，应用起来也比較简单，记住那几个命令便可了。而monkeyrunner呢，相比之下会强大一些，它主要可应用于功能測试，回归測试，并且可以自定义測试扩展，灵活性较强，并且測试人员可以全然控制。

本篇乃本人学习monkeyrunner时笔记，查看网络中的资料并经本人測试而出，由于本人刚接触，因此本篇内容难免肤浅，高手们请绕走~

在測试本人下面实例时，请自行搭建Android环境。

1、打开模拟器

执行monkeyrunner以前必须先执行对应的模拟器，否则monkeyrunner没法链接设备。

用Elipse打开Android模拟器或在CMD中用Android命令打开模拟器。这里重点讲一下在CMD中用Android命令打开模拟器

命令：emulator -avd test （注意：test为虚拟设备的名称——AVD的全称为：Android Virtual Device，就是Android执行的虚拟设备，例如如下图所看到的：）

上面命令中的test是模拟器名称。使用时需要改为实际名字。

 

 

假设正常，模拟器应该可以启动起来了。

假设运行的结果出现下面错误内容：

PANIC: Could not open: C:\Documents and Settings\sAdministrator\.android/avd/test.ini

例如如下图所看到的：

缘由在于你的环境变量缺乏配置。请在“系统变量”中加入“ANDROID_SDK_HOME”，设置其值为“C:\Documents and Settings\Administrator”（注意：这里的值不能为C:\Documents and Settings\Administrator\.android），例如如下图所看到的：

肯定后，关闭CMD窗体，又一次打开CMD。运行以上命令。将会启用模拟器。

模拟器启动成功后，咱们仍在CMD环境中操做。现在进入monkeyrunner的shell命令交互模式。

命令：monkeyrunner

进入shell命令交互模式后，首要一件事就是导入monkeyrunner所要使用的模块。直接在shell命令下输入：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice 回车

OK，这步完毕咱们就可以利用monkeyrunner进行測试工做了。

这里有两种方案，一是直接在shell命令下输入下面命令；

命令说明

device=MonkeyRunner.waitForConnection() #链接手机设备

device.installPackage("../samples/android-10/ApiDemos/bin/Apidemos.apk") #安装apk包到手机设备。

启动当中的随意activity了，仅仅要传入package和activity名称就能够。命令例如如下：
device.startActivity(component="com.example.android.apis/com.example.android.apis.ApiDemos")
此时模拟器会本身主动打开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'

二是将下面命令写到python文件中，好比test.py，而后咱们再从命令行直接经过monkeyrunner执行它就能够。比方，咱们仍是用上面的样例，语法例如如下：monkeyrunner test.py 接下来monkeyrunner会本身主动调用test.py，并执行当中的语句，至关方便。

实例：test.py

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice
device=MonkeyRunner.waitForConnection()
device.startActivity(component="your.www.com/your.www.com.TestActivity")

在CMD中运行

monkeyrunner test.py

可能出现错误“Can't open specified script file”，例如如下图所看到的：

缘由在于python脚本文件路径不对。你可以有下面解决的方法：

一、将test.py文件存放到monkeyrunner文件同一文件夹中。可以运行：monkeyrunner test.py 调用

二、指定python文件位置。假设test.py文件在D盘根文件夹下，可以这样运行：monkeyrunner d:\test.py

学习笔记

如下是学习中的笔记，有点乱。就放在本篇最后吧。

环境变量

变量名：ANDROID_SDK_HOME
变量值：C:\Documents and Settings\Administrator

变量名：Path
变量值：%SystemRoot%\system32;%SystemRoot%;C:\Python27;C:\py;D:\android\android-sdk-windows\tools;D:\android\android-sdk-windows\platform-tools


android本身主动化測试框架：CTS、monkey、monkeyrunner、benchmark

monkeyrunner

monkeyrunner工具提供了一个API，运用该API编写的程序可以不用经过android代码来直接控制android设备和模拟器，咱们可以写一个python程序对android应用程序或測试包进行安装、执行、发送模拟击键，对用户界面进行截图并将截图存储在workstation上等操做。monkeyrunner工具的主要设计目的是用于測试application/framework层上的应用程序和设备、或用于执行单元測试套件，也可以用于其余目的。

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

monkeyrunner为android測试提供了下面独特的功能：
一、多设备控制:monkeyrunner API可以跨多个设备或模拟器实施測试套件。可以在同一时间接上全部设备或一次启动全部模拟器，根据程序依次链接到每一个，而后执行一个或多个測试。也可以用程序启动一个配置好的模拟器，执行一个或多个測试，而后关闭模拟器。
二、功能測试:monkeyrunner可以为一个应用本身主动贯彻一次功能測试。您提供按键或触摸事件的输入数值，而后观察输出结果的截屏。
四、回归測试:monkeyrunner可以执行某个应用，并将其结果截屏与既定已知正确的结果截屏相比較，以此測试应用的稳定性。
四、可扩展的本身主动化：由于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命令语法

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

monkeyrunner API

主要包含三个模块
一、MonkeyRunner:这个类提供了用于链接monkeyrunner和设备或模拟器的方法，它还提供了用于建立用户界面显示提供了方法。
二、MonkeyDevice:表明一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、执行測试包等提供了方法。
三、MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各类格式、对照两个MonkeyImage对象、将image保存到文件等提供了方法。

注意：在执行monkeyrunner以前必须先执行对应的模拟器，不然monkeyrunner没法链接到设备
执行模拟器有两种方法：一、经过eclipse中执行模拟器 二、在CMD中经过命令调用模拟器

这里介绍经过命令，在CMD中运行模拟器的方法

命令：emulator -avd test
上面命令中test是指模拟器的名称。

导入需要的模块

import sys
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')

向设备或模拟器安装要測试的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(component="your.www.com/your.www.com.TestActivity")
或者
device.startActivity(component="your.www.com/.TestActivity")

此时可以向模拟器发送如按键、滚动、截图、存储等操做了。


运行一个adb shell命令，并返回结果，假设有的话
device.shell("...")

暂停眼下正在执行的程序指定的秒数
MonkeyRunner.sleep(秒数，浮点数)

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

写文件MonkeyImage

MonkeyImage.writeToFile(參数1:输出文件名称，也可以包含路径,參数2:目标格式)
写成功返回true，不然返回false


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

唤醒设备屏幕（在设备屏幕上唤醒）

device.wake()

又一次引导到指定的引导程序指定的设备

device.reboot()
=========================================================

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

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

发送到指定键的一个关键事件

device.press(參数1:键码,參数2:触摸事件类型)
參数1：见android.view.KeyEvent
參数2，若有TouchPressType()返回的类型－触摸事件类型，有三种。
一、DOWN 发送一个DOWN事件。指定DOWN事件类型发送到设备，相应的按一个键或触摸屏幕上。
二、UP 发送一个UP事件。指定UP事件类型发送到设备，相应释放一个键或从屏幕上抬起。
三、DOWN_AND_UP 发送一个DOWN事件，而后一个UP事件。相应于输入键或点击屏幕。
以上三种事件作为press()或touch()參数。原英文例如如下：
use this with the type argument of press() or touch() to send a down event.


为了模拟输入键，发送DOWN_AND_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 

不少其它：http://developer.android.com/reference/android/view/KeyEvent.html