天地会珠海分舵

到此为止我们描述的MonkeyRunner对应用的点击拖放等操作都是直接通过指定坐标点来实现的，比如下面触摸一个坐标点为(60,90)的按钮的脚本例子：1 device.touch(60,900,MonkeyDevice.DOWN_AND_UP)代码14-1-1 直接使用坐标点操作应用  这样子做的话代码会存在以下几大缺点：缺乏易用性：要操作某个控件之前需要先想办法如通过工具来定位该控件的坐标点可

从上一节的描述可以知道，MonkeyRunner发送给Monkey的命令是以字符串的形式交互的，那么事件处理的第一步当然是先去获得MonkeyRunner发送过来的字串命令了。 在事件源MonkeySourceNetwork初始化的时候构造函数会创建一个ServerSocket来监听来自客户端的链接和数据，但这个时候客户端并不能真正实现和服务端通信，因为该ServerSocket尚处于阻塞状态。既

因为整个手稿内容比较多，有十多万字，需要从iBooks Author上面一个个整理出来分享，所以需要点时间才能全部完成。下面先给出整本书的大纲

上一节我们描述了monkey的命令处理入口函数run是如何调用optionProcess方法来解析命令行参数的。启动参数主要时去指导Monkey时怎么运行起来的，但Monkey作为MonkeyRunner框架的一部分，更重要的是如何将从MonkeyRunner测试脚本出发的命令转化成事件来注入到系统中以进行测试自动化。如前面所说，run方法除了对启动参数进行解析之外还做了很多其他的事情，比如这一小节需要分析的去建立对

在初始化HierarchyViewer的实例过程中，HierarchyViewer会调用自己的成员方法setupViewServer来把ViewServer装备好，那么我们这里先看下这个方法： 39 private void setupViewServer() { 40 DeviceBridge.setupDeviceForward(mDevice); 41

HierarchyViewer库的引入让MonkeyRunner可以以面向控件的方式进行脚本编写，那么它是怎么做到这一点的呢？它的实现原理又是怎么样的呢？在这一小节开始我们就会开始一起揭开它的神秘面纱。 HierarchyViewer这个框架的工作需要ViewServer的协同工作，它们是以CS(Client-Server)架构来协同工作的。我们在上一章已经学习了如何让做为Server端的View

每个应用都会有一个入口方法来供操作系统调用执行，Monkey这个应用的入口方法就是在Monkey.java这个类里面的，也就是说Monkey.java就是整个Monkey应用的入口类。

既然要使用HierarchyViewer来获取控件信息，那么首先我们看下在脚本中，我们是怎么获得HierarchyViewer的，看下面一段脚本代码：1 device = MonkeyRunner.waitForConnection() 2 device.wake()3 device.startActivity(component="com.example.android.notepad/c

在第2节中我们看到了MonkeySourceNetwork是如何从Socket中获取MonkeyRunner发送过来的命令字串的，但是最后如何将它翻译成事件的代码我们还没有进行分析，因为在那之前我们还没有了解命令翻译类的相关知识。那么经过第3小节对命令翻译类的学习后，我们就可以继续往下分析MonkeySourceNetwork的getNextEvent中是如何翻译命令字串的了。 我们回看下第2小节

Monkey启动之后需要在整个MonkeyRunner的测试生命周期中提供服务，也就是说，一旦我们调用monkeyrunner命令来执行指定的测试脚本的时候，只要monkeyrunner还没有退出，那么Monkey就会一直提供服务，一直监听获取并处理从MonkeyRunner测试脚本发送过来的相应的命令。那么要实现这种一直监听的处理我们很自然就想到需要用一个循环来处理了。其实Monkey也不例外，我们往下会分析它是怎

每个来自网络的字串命令都需要进行解析执行，只是有些是在解析的过程中直接执行了事，而有些是需要在解析后创建相应的事件类实例并添加到命令队列里面排队执行。负责这部分工作的就是命令翻译类。那么我们往下还是继续在MonkeySourceNetwork这个范畴中MonkeyCommand类是怎么一回事： 图6-3-1 MonkeyCommand族谱 图中间的MonkeyCommand是一个接口，主要定

事件源在获得字串命令并把它翻译成对应的MonkeyEvent事件后，会把这些事件排队放入一个由事件源维护的队列，然后其他地方如Monkey类的runMonkeyCycles方法就可以去把队列里面的事件取出来进一步进行处理了。那么这里我们先看下属于MonkeySourceNetwork内部类的命令队列的类图: 图6-6-1 命令队列类图 整个继承关系非常清晰简洁，CommandQueue接口定

首先大家应该清楚的一点是，MonkeyRunner的运行是牵涉到主机端和目标设备端的，流程控制逻辑代码是在PC端运行的，但很多命令请求的执行是在目标机器端执行的。这不像其他框架如UiAutomator是所有东西都完全在目标设备端运行的。 这里我们首先应该去看的不是MonkeyRunnerStarter这个类里面的main这个入口函数，因为monkeyrunner其实是个shell脚本，它就在你的s

在上一章中我们有简要的介绍了事件源是怎么一回事，但是并没有进行详细的描述。那么往下的这几个小节我们就需要把这方面的知识给补充完整。 这一节我们先主要围绕MonkeySourceNetwork这个事件源来学习事件源的框架结构。首先，要理解事件源，必须先搞清楚几个问题：事件从哪里来？ Monkey的事件来源有多个方面，但是作为MonkeyRunner框架的一部分，它的事件来源主要是来自MonkeyRu

上一节我们学习了如何通过MonkeyRunner这个类的静态方法waitForConnection来把后台和设备建立好连接，且看到了在建立连接成功后，该方法会返回来一个MonkeyDevice的实例对象。那么这一节我们就通过编写一些脚本代码示例来了解学习下MonkeyDevice这个类的使用方法

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。本书脚本相关的示例常会用到Android SDK自带的NotePad这个应用，所以这里很有必要去描述下这个应用。其实去熟悉这个应用最好的办法是

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。边界怎么样才算分析清楚一个事物的原理是什么呢？就以前面提到的《LINUX内核源代码情景分析》为例子，分析到什么程度算是把Linux内核给分析清

到了现在，万事已经俱备，控件树这个东风也已经就绪了，我们也终于可以火烧赤壁大展拳脚，通过控件的ID在控件树中找到我们想要的控件了。 HierarchyViewer只允许用户通过控件的ID去查找控件，这比Robotium,UiAutomator和Appium这些框架是少了很多查找控件的方式的，但聊胜于无。 HierarchyViewer去尝试通过控件ID的方法叫做findViewById，它有两个重

这里获取的版本号有两个，一个是ViewServer自身的版本号，一个是ViewServer当前使用协议的版本号。 我们这里为什么需要获取ViewServer版本以及其协议版本呢？其实主要原因是ViewServer有些功能在老版本上是不支持的，比如HierarchyViewer在列出当前所有Activity窗口的时候，针对获取焦点的窗口会根据不同的ViewServer协议版本而作不同处理，请看源码示

最后我们对MonkeyRunner启动的过程做一个总结,当然，其中也包括启动Monkey，虽然它不属于启动过程的一部分:monkeyrunner这个shell脚本会先设置一些运行环境的系统属性保存到JVM的System.Propery里面然后该脚本会通过java -jar直接运行sdk下面的monkeyruner.jar然后操作系统直接回调到monkeyrunner在MonkeyRunnerSta

MonkeyRunner在准备好AndroidDebugBridge和DeviceMonitor等服务之后，就基本上是解决了和目标设备通信的问题了，那往下需要做的就是把测试脚本运行起来了。178 public static void main(String[] args) {179 MonkeyRunnerOptions options = MonkeyRunnerOptions.p

本文档的目的是去文档化一个客户端请求ADB服务器往adbd守护进程发送文件相关的请求。请查看OVERVIEW.TXT文档去查看(ADB服务器和adbd守护进程)相关信息，查看SERVICES.TXT去学习其他更多的可用请求。

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。关于ADB的实现记录。I. 概览安卓调试桥(ADB)是用来: 跟踪管理所有连接上或者运行在开发主机上的安卓设备或者模拟器实例。其实现了各种控制

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。MonkeyRunner这个类可以说是编写monkeyrunner脚本的入口，因为这个类有一个很重要的方法watForConnection，它

MonkeyRunnerStarter是MonkeyRunner启动时的入口类，因为它里面包含了main方法.它的整个启动过程主要做了以下几件事情:解析用户启动MonkeyRunner时从命令行传输进来的参数: 因为MonkeyRunner需要根据指定的参数才能做事情，比如输入的一个需要执行的脚本。如果确实不知道任何参数的话它就会进入MonkeyRunner的交互模式，其实就是Jythong的交互

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。NotePad窗口Activity之菜单简介这里我们总共用到两种类型的菜单，一种叫做Context Menu，就是上下文菜单；一种叫做Opti

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。前言相信大家做过安卓移动平台UI自动化开发的必然会用过，至少听过MonkeyRunner这个名字。MonkeyRunner是一个针对安卓平台的

用户在命令行运行monkeyrunner命令来执行测试脚本的时候ADB服务器有可能还没有起来，AndroidDebugBridge类的主要作用之一就是去开启一个新的进程来启动ADB服务器，这样我们的测试脚本才能发送命令给ADB服务器去驱动目标设备做事情，比如安装或者删除待测应用的安装包等。 MonkeyRunner在启动的过程中会牵涉到一系列的调用并关联到不同的类来做不同的事情。 图8-3-1

本章我们重点围绕处理网络过来的命令的MonkeySourceNetwork这个事件源来阐述学习Monkey是如何处理MonkeyRunner过来的命令的。以下总结下MonkeyRunner从启动Monkey开始到如何处理完成一个命令的流程总结如下:MonkeyRunner通过ADB发送shell命令”monkey --port 12345”来启动MonkeyMonkey启动运行进入runMonke

事件源代表要注入系统的命令事件数据是从哪里过来的。这一小节我们不会对事件源的实现进行深入的分析，因为下一章会做这个事情。这里大家对事件源有个基本概念就足够了。

设置好Monkey的CLASSPATH环境变量以指定”/system/framework /framework/monkey.jar“后，/system/bin/monkey这个shell脚本就会通过app_process命令指定monkey的入口类” “com.android.commands.monkey.Monkey”找到main函数开始运行。在运行之前会有一些初始化的工作需要做，其中很重要的一项就是去把用户提

在上一节的第一个“增加日记”的示例中，我们并没有看到日记是否真的增加成功了，也就是说当时并没有进行结果比较。其实在MonkeyRunner框架中，测试结果的比较往往都是通过截屏比对来完成的。而截屏比对相关的方法主要是由MonkeyImage这个类来实现的，但截屏这个动作确是由MonkeyDevice提供的takeSnapshot这个方法来达成的。所以这一节我们主要就是去熟悉截屏比对相关的测试代码编写的基础知识。

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。原理架构MonkeyRunner使用起来非常的简单，只需要导入以下几个类基本上就能满足测试脚本编写的需求，比如：monkeyrunner.j

大家可能会觉得奇怪，为什么启动目标设备端的monkey进程会放在“运行测试脚本”这一节之后来阐述。 纵观前面整个MonkeyRunner的启动流程，我们看到并没有提及到monkey进程启动的地方。那么就奇怪了，monkey是什么时候被MonkeyRunner启动起来的呢？ 我们的测试脚本一开始时几乎毫无例外的都需要执行一个调用:MonkeyRunner.waitForConnection(),如果

天地会珠海分舵注：本来这一系列是准备出一本书的，详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因，没有如愿。所以这里把草稿分享出来，所以错误在所难免。有需要的就参考下吧，转发的话还请保留每篇文章结尾的出处等信息。NotePad窗口Activity之NotesList简介上一节我们简要描述了测试对象NotePad的主要功能模块，那么这一节开始我们就会对每

在获得ViewServer的运行状态后，如果ViewServer还没有启动的话，HierarchyViewer的setupViewServer的下一步就会去启动ViewServer。调用的方法是DeviceBridge.startViewServer，我们进去看看：190 public static boolean startViewServer(IDevice device) {191

上一小节我们描述了HierarchyViewer是如何组建ADB协议命令来实现ViewServer的端口转发的，在端口转发设置好后，下一个要做的事情就是去检测目标设备端ViewServer线程是否已经启动起来了。我们进入setupViewServer调用的DeviceBridge的isViewServerRunning方法：165 public static boolean isViewS

上一节我们看到在启动AndroidDebugBridge的过程中会调用其start方法，而该方法会做2个主要的事情:715行startAdb:开启AndroidDebugBridge722-723行:初始化android设备监控并启动DeviceMonitor设备监控线程。 其中第一点我们上一小节已经做了详尽分析了，那么我们往下就去分析下第2点。 DeviceMonitor主要的功能就是监控是否有

从网络过来的命令字串需要解析翻译出来，有些命令会在翻译好后直接执行然后返回，但有一大部分命令在翻译后需要转换成对应的事件，然后放入到命令队列里面等待执行。Monkey在取出一个事件执行的时候主要是执行其injectEvent方法来注入事件，而注入事件根据是否需要往系统注入事件分为两种:需要通过系统服务往系统注入事件:如MonkeyKeyEvent事件会通过系统的InputManager往系统窗口注

本节我们先看下Monkey是怎么启动起来的。在今后分析到MonkeyRunner的原理的时候我们会看到客户端是通过ADB往Android目标测试机器发送一个”monkey -port 12345”的命令来启动Monkey服务的。那么这个命令做了什么事情呢？它其实就是通过调用monkey这个shell脚本来把Monkey服务给启动起来然后监听目标设备上的端口12345，最后MonkeyRunner等其他主机端的应用就能