monkeyrunner是一个Android自动化测试工具。它提供一个API，运用该API编写的程序可以不用通过Android代码来直接控制Android设备和模拟器，我们可以写一个Python程序对android应用程序或测试包进行安装，运行，发送模拟击键，对用户界面进行截图并将截图存储在workstation上等操作。monkeyrunner工具的主要设计目的是用于application

/framework层上的应用程序和设备，我们当然也可以将其用于其它目的。

Monkey Runner和Monkey的区别是什么

monkey运行在设备或者模拟器上边，可以脱离PC运行，其运行时如下图所示。

普遍的做法是将monkey作为一个向待测应用发送随机按键消息的测试工具，验证待测应用在这些随机性的输入面前是否会有闪退或者崩溃。而monkeyrunner则接受一个明确的测试脚本（使用python语言编写的）。

虽然monkey也可以根据一个指定的命令脚本发送按键消息，但其不支持条件判断，也不支持读取界面的信息来执行验证操作。而monkeyrunner的测试脚本中有明确的条件判断等语句，可用来做功能测试。

总结：

实际操作中，monkey由于缺少必要的条件判断等命令，难以在功能测试上有所作为，只能作为生成一些随机事件的工具，测试应用程序的健壮程度，待测应用崩溃后可以根据monkey打印的日志，再用monkey创建一个重现步骤，供开发调试。monkey服务器模式更适合用于黑盒测试，不建议用于自动化测试。

而Monkeyrunner虽然有Python和Java类库的强大支持，但其自身提供的API有限，还得需要插件扩展其功能。

2.Monkey Runner基础

2.1Monkey Runner环境搭建

Monkeyrunner的环境搭建，需要安装以下工具：jdk、android sdk、python编译器。

1.jdk的安装与配置

1）jdk下载地址

http://www.oracle.com/technetwork/java/javase/downloads/index.html

下载完成后，默认安装即可。

2）jdk环境配置

jdk安装成功后，计算机→属性→高级系统设置→高级→环境变量，在系统变量中，新建JAVA_HOME变量，变量值填写jdk的安装目录。

在系统变量中，编辑Path变量，在变量值最后输入%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;（注意原来Path的变量值末尾有没有;号，如果没有，先输入；号再输入上面的代码）

在系统变量中，新建CLASSPATH变量，变量值填写为：

.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar（注意最前面有一点）

到此，系统变量配置完毕。

3）jdk环境检查

检验jdk环境是否配置成功，则运行cmd，在cmd窗口中，输入 java -version （java 和 -version 之间有空格）。若如图所示，显示版本信息，则说明安装和配置成功。

2.android sdk安装与配置

android sdk就是指Android专属的软件开发工具包。android sdk中我们最常用的就是tools和platform-tools文件夹中的工具。

1）sdk下载地址

下载地址1：http://developer.android.com/sdk/index.html

下载地址2：http://rj.baidu.com/soft/detail/23485.html?ald

Sdk下载完成后，解压缩到自己的目录，不需要安装。

2）sdk环境配置

sdk安装成功后，计算机→属性→高级系统设置→高级→环境变量，在系统变量中，新建ANDROID_HOME变量，变量值填写sdk中tools和platform-tools的安装目录。

在系统变量中，编辑Path变量，在变量值最后输入%ANDROID_HOME%;

（注意原来Path的变量值末尾有没有;号，如果没有，先输入；号再输入上面的代码）

3）sdk环境检查

检验sdk环境是否配置成功，则运行cmd，在cmd窗口中，输入adb。若如图所示，则说明安装和配置成功。

3.Python编辑器安装与配置

python用于支持Monkeyrunner运行，使用python脚本编写用例会大大简化Monkeyrunner用例的编写，且会帮助扩展monkeyrunner的自动化功能。

1）Python下载地址

下载地址：http://www.python.org/download/

下载后，按照提示信息，下一步安装即可。

2）Python环境配置

Python安装成功后，计算机→属性→高级系统设置→高级→环境变量，在系统变量中，编辑Path变量，在变量值最后输入Python的安装路径；

（注意原来Path的变量值末尾有没有;号，如果没有，先输入；号再输入上面的代码）

3）Python环境检查

检验Python环境是否配置成功，则运行cmd，在cmd窗口中，输入python。若如图所示，显示版本信息，则说明安装和配置成功。

4.Monkeyrunner环境检查

若以上步骤均完成，且各环境变量也配置正确，至此，Monkeyrunner环境已经搭建完成。检验Monkeyrunner环境是否搭建成功，则同样运行cmd，在cmd窗口中，输入monkeyrunner。如下图所示，则说明Monkeyrunner环境搭建成功。

下面就可以用Monkeyrunner连接模拟器来进行自动化的测试了。

2.2 Monkey Runner使用方法

Moneyrunner在使用前，必须先打开模拟器或连接上手机设备。下面是Monkeyrunner的实例操作。

1.模拟器启动

我们这里选择命令打开模拟器。运行cmd，在cmd窗口，输入命令：emulator -avd AVD_test，其中AVD_test是模拟器的名称，填写自己创建的模拟器名称。

模拟器启动成功后，我们仍在cmd环境中操作。现在进入Monkeyrunner的shell命令交互模式。

输入命令：monkeyrunner

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

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice

再回车，这步完成我们就可以利用monkeyrunner进行测试工作了。

2.模拟器连接

下面我们就要Monkeyrunner连接上模拟器，进行一系列操作了。输入命令：

device=MonkeyRunner.waitForConnection()

其中，device=MonkeyRunner.waitForConnection(6,’emulator-5554′)
参数1：超时时间，单位秒，浮点数，默认是无限期地等待。
参数2：指定的设备名称device_id，默认为当前设备（手机优先，其次为模拟器）

输入命令后，页面上没有错误信息返回，即成功连接设备。

3.app安装并启动

1）app安装

模拟器启动成功后，我们安装自己想要的apk，这里我们选择qq音乐安装。

输入命令：device.installPackage('F:\\QQyinle_439.apk')，其中，参数是APK的相对路径。

安装成功返回true，此时查看模拟器我们可以在IDLE界面上看到安装的APK的图标了。

2）app启动

app安装成功后，现在启动该app，命令为：

device.startActivity(component="package名/.activity")

首先，我们有必要说一下，如何获取一个app的package名和activity。这里，我们只描述一种获取方式。

使用aapt，其中aapt是sdk自带的一个工具，在sdk\builds-tools\目录下：

以存储在F盘的qq音乐为例，运行cmd，命令行中切换到aapt.exe目录，

方法一：

执行命令：aapt dump badging F:\QQyinle_439.apk ，注意，apk路径中一定不能有空格。

由上图可知：package name：com.tencent.qqmusic

activity：.activity.AppStarterActivity

方法一由于日志较多，寻找起来比较费劲，所以我们引出方法二。

方法二（推荐）：

把日志存储在特定的文件中，在文件中通过搜索关键字，得到包名及活动名，这里我把结果输出到F盘的log.txt中：

aapt dump badging F:\QQyinle_439.apk > F:\log.txt

到此，已经获取了app的package名和activity。下面，我们真正的启动app。在原有cmd运行窗口，输入命令：

device.startActivity(component=" com.tencent.qqmusic/.activity.AppStarterActivity ")

命令执行后，模拟器上的app被启动。这表示命令启动app成功。这里的关键是app的package name和activity对应获取正确，否则启动不了特定app。

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

3.Monkey Runner的使用

3.1 第一个Monkey Runner脚本

Monkeyrunner可以直接调用指定python脚本，将命令写到python文件里，命名例如***.py，然后我们再从命令行直接通过monkeyrunner运行它即可。比如，我们还是用上面的例子，语法如下：monkeyrunner ***.py。接下来monkeyrunner会自动调用***.py，并执行其中的语句，相当方便。

我们这里将上述例子，所有命令放在python文件里，并命名test.py，然后存储到本地F盘，即路径为：F:\test.py。

3.2 Money Runner的控件定位

在我们使用Monkey Runner的过程中，我们是会对要测试的应用执行一些操作，在这个过程中，我们希望能够点击待测应用中的按钮或向待测应用输出一下文字，这个时候我们就需要获取到待测应用中的组件，以方便我们进行相关操作。

Monkeyrunner工具提供了一套API让用户/测试人员来调用，调用这些api可以控制一个Android设备或模拟器，而不需要了解对应的源码。

有了Monkeyrunner，我们可以编写python脚本来控制apk包的安装和卸载、启动app、向app发送各种动作事件、截取图片并保存。

除此之外，MonkeyRunner是Google提供的一个基于坐标点的Android黑盒自动化测试工具。所以，要使用Monkeyrunner进行自动化测试，首先，要了解Monkeyrunner中获取坐标点的方式。

方式	工具	说明
控件坐标	MonkeyRecorder坐标获取、其他工具获取	脚本中需要对不同分辨率兼容，坐标要动态转换
控件ID	HierarchyViewer解析控件ID	对环境有要求，需要开发机、模拟器，市面商用机需要破解才能使用，一般有风险，速度慢；对不同分辨率通用
控件ID	MonkeyDevice	只能进行简单的常用动作

本文中，我们主要介绍两种获取坐标点的方式。一种是通过MonkeyRecorder获取坐标；另一种是通过HierarchyViewer工具获取控件ID。

3.2.1利用MonkeyRecorder获取控件坐标

1.Pointer location获取坐标

先说一个比较简单的获取坐标的方式，是通过模拟器中的设置-开发者选项，找到“指针位置”的选项，勾选上。如下图所示。

勾选后，模拟器的最顶部则显示坐标，比如点击模拟器上的任一应用，最顶部显示X、Y的值即该应用的坐标；同理，如果想要获取任一应用中的任一位置的坐标，也可用此方法。

2. MonkeyRecorder获取坐标

下面就MonkeyRecorder获取坐标的方式，进行演示。MonkeyRecorder是一个比较好用的获取坐标的工具，它是用来获取真机或模拟器上坐标的工具，当我们点击真机或模拟器上的空间时，就能显示真机或模拟器上的点击点的坐标。

（1）MonkeyRecorder的启动

首先安卓手机连接上电脑，并保证以下两个条件成立：

a．终端USB调成开发者模式

b．电脑安装手机驱动

手机连接成功后，打开cmd窗口，输入adb devices查看已连接真机或模拟器设备的名称，我们这里仍以模拟器为代表。

之后，在cmd窗口，输入monkeyrunner后，启动Monkeyrunner。做以下操作：导入MonkeyRecorder包、连接模拟器设备、以MonkeyRecorder方式启动模拟器，并依次输入如下命令：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice
from com.android.monkeyrunner.recorder import MonkeyRecorder as recorder

device=MonkeyRunner.waitForConnection()
recorder.start(device)

到此，MonkeyRecorder正式启动。截图如下。

（2）MonkeyRecorder的使用

我们这里只是使用MonkeyRecorder来记录坐标，获取坐标的方式很简单。比如qq的登录界面，点击“登录”按钮，右侧就会显示该按钮的坐标；同样，点击账号输入框或密码输入框，右侧同样会显示坐标。这个坐标就是我们需要获得的坐标。

同时，MonkeyRecorder中的界面是同模拟器页面保持一致的，在MonkeyRecorder中触发任一操作，模拟器上会有相应的触发。如果两者没有保持一致，则点击MonkeyRecorder右上角的Refresh Display即可刷新页面。

3.控件坐标之Monkeyrunner脚本演示

我们将下面一段Monkeyrunner脚本写到一个test.py文件中，然后运行test.py文件，查看模拟器或真机上是不是做相应的操作。

3.2.2利用HierarchyViewer获取控件ID

通过控件ID实现自动化脚本的运行，就性能而言，会比控件坐标的实现差一些；但是对于不同分辨率的设备都通用，不需要动态变换坐标。控件ID的获取主要是通过HierarchyViewer。下面就HierarchyViewer从打开方式和使用两方面进行讲解。

1.HierarchyViewer的打开方式

HierarchyViewer的打开方式有两种：一种是eclipse中打开HierarchyView视图，另外一种是命令行中执行sdk/tools/hierarchyviewer.bat。

HierarchyViewer默认只能在非加密设备使用，例如工程机，工程平板或者模拟器。如果要在手机上使用HierarchyViewer，你需要在你的应用中添加一个开源库View Server。链接地址：https://github.com/romainguy/ViewServer。该篇文章中有讲解如何启动真机View Server，大家如果有兴趣，可参考：https://dup2.org/node/1538。

方式一：连接您的真机设备，或打开模拟器，在eclipse中，依次选择Window-Open Perspective-Other，在Other中，选择HierarchyView视图，即可打开。

方式二：连接您的真机设备或打开模拟器，运行cmd窗口，进入到sdk/tools目录下，输入命令hierarchyviewer.bat，运行hierarchyviewer。

或者直接在sdk/tools目录下，找到hierarchyviewer.bat，双击运行。

下面讲解利用HierarchyViewer获取控件ID的方法。

2.HierarchyViewer获取控件ID

HierarchyViewer启动后，首先会看到的第一个窗口显示了设备和模拟器的列表。点击左边的箭头，就会展开当前设备或模拟器的Activity对象列表。列表中显示了设备或模拟器上，UI当前可视的所有Activity对象。这些对象按照它们的Android组件名称列出来。列表中的内容包含应用的Activity对象和系统的Activity对象。

当模拟器activity画面变更后，点击refresh可以加载新的页面布局信息。

从列表中选择你的activity名称，双击，或点击菜单栏的Load View Hierarchy按钮，进入View Hierarchy窗口，查看它的view层次结构；或者点击Inspect Screenshot按钮，进入Pixel Perfect窗口，从而查看UI的一个放大图像。我们这里点击进入View Hierarchy窗口。

可以从下图中看到模拟器此activity的画面布局信息，左边部分是hierarchy通过树形结构展示的布局形式，右下角是模拟器上当前页面的UI布局信息。

通过滚动鼠标，可以放大每个树节点；拖拽鼠标，移动树形结构布局。双击树节点可以展示单独的UI部分。从下图中，可以看到，id/btn_login即为登录按钮的ID。依次类推，可以查看其它控件ID。

注：对于列表、或者弹出框则无法直接通过点击ID操作成功，需要计算ID的坐标。

3.控件ID之Monkeyrunner脚本演示

同样的，我们将下面一段Monkeyrunner脚本写到一个test.py文件中，然后运行test.py文件，查看模拟器上是不是做相应的操作。相关代码如下所示：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice 
from com.android.monkeyrunner.easy import EasyMonkeyDevice   #提供了根据ID进行访问
from com.android.monkeyrunner.easy import By    #根据ID返回PyObject的方法
device=MonkeyRunner.waitForConnection() 
#启动activity（这里启动qq）
device.startActivity(component="com.tencent.mobileqq/.activity.SplashActivity")

easy_device=EasyMonkeyDevice(device)    #必须在activity启动之后
#登录界面，点击账号输入框
easy_device.touch(By.id('id/0x20e'),MonkeyDevice.DOWN_AND_UP)

device.type('3469191693')                    #输入qq账号