Android(安卓)Monkey源码解析

本文旨在对Android Monkey的源码进行解析，这样能在后续的定制改造中得心应手。

对于此源码，自己获取的过程也是废了一般周折，尝试过去手机里反编译，去各种地方找，后来发现，通过Google搜索“android monkey source code”，第一条就是，附上地址：https://github.com/android/platform_development/tree/master/cmds/monkey

所以有个感想，有时候得用英文搜，然后最好用Google搜。

一、使用

Monkey的使用很简单，需要注意的是各个参数的意义要搞清楚。

这篇文章并不会讲其使用，具体可以参见Google的官方文档[1]，或者一篇博客[2]。

二、源码解析

1 ，阅读代码首先得理清楚主线，也即是执行流程。对应到Monkey中，也就是怎么通过在控制台中输入一串命令，就可以得到相应的测试结果的。因为主类Monkey中有main方法存在，再调用run()方法，一路跟下去，便可以理清楚其主线。下图是自己画的一个UML顺序图。本小节先对主线做简要介绍，后面两小节重点解析MonkeyEventSource和MonkeyEvent。

　　1）在run() 方法中，第一个比较重要的是参数处理方法processOptions()，用来解析命令行传入的参数，设置相应的变量。

　　2）然后会初始化EventSource，主要是最后一种，MonkeySourceRandom。这时会把通过命令行读入的参数全部设置到对应的变量中。在通过调用validate()方法，将传入的参数结合默认的参数进行调整和校验。

　　3）再调用runMonkeyCycles()方法执行具体事件。通过EventSource调用getNextEvent()获取到MonkeyEvent，对于具体的事件则调用injectEvent()触发真正的执行。对于返回的结果做相应的处理。

　　4）处理好后，在打印相应的日志结果即可。

　　5）对于其中的ActivityController，由于继承的是内部隐藏的类，可不比关注。

2，对于MonkeyEventSource，它是一个接口，主要的实现类是MonkeySourceRandom，也就是默认的随机事件，当然也还有网络，脚本两种事件源，其继承关系如下图。

（这是一种典型的面向对象的编程范式）

　　1）由于基于网络的事件只能作用于localhost，而基于脚本的事件其脚本并不友好，因此一般就用MonkeySourceRandom这个事件源，也就是默认的通过命令行触发的事件。下面就分析下MonkeySourceRandom这个类。

　　2）该类首先是定义了10种事件，分别是TOUCH, MOTION, PINCHZOOM, TRACKBALL, NAV, MAJORNAV, SYSOPS, APPSWITCH, FLIP和ANYTHING，这些事件和命令行中的可设置10种参数对应。

　　在构造函数中设置了各个事件的初始占比，并定了一个用于存储事件的队列。并定义了3种手势，TAP，DRAG， PINCH_OR_ZOOM。

　　3）然后，提供接口setFactors()给Monkey类对各个参数进行设置。再通过接口adjustEventFactors()，结合命令行输入和默认值，调整10个事件的比例，进行归一化。

　　4）该类中关键的作用是用于生成随机事件，通过generateEvents()这个私有方法完成。

　　对于TOUCH, MOTION, PINCHZOOM这三种，分别对应于TAP，DRAG和 PINCH_OR_ZOOM三种手势，利用generatePointerEvent()方法完成；对于TRACKBALL，利用方法generateTrackballEvent()完成。

　　在generatePointerEvent()方法里，实际生成的都是MonkeyTouchEvent。如果传入的手势是TAP，则随机按下一个点，移动一次，再放开；如果是DRAG，则按下后，会随机移动一定数量的点后再放开；如果是PINCH_OR_ZOOM，由于是按下的是两个点，各自的id分别为0和1，然后随机一定数量的点再放开。

　　在generateTrackballEvent()方法里，生成的是MonkeyTrackballEvent。首先是随机的移动10次，然后还有10%的概率在移动完进行一次点击。

　　对于APPSWITCH，生成一个MonkeyActivityEvent事件；对于FLIP，生成一个MonkeyFlipEvent事件；而剩下的NAV, MAJORNAV, SYSOPS，都从各自的可选点中随机选出一个，对于ANYTHING则随机生成一个，这四种最后都生成MonkeyKeyEvent事件。

　　由此可以总结出，命令行中可配置的10种事件类型，装换为了Monkey中的5种Event，其对应关系如下表：

命令行可选参数	FACTOR	MonkeyEvent类型
--pct-touch	FACTOR_TOUCH	MonkeyTouchEvent
--pct-motion	FACTOR_MOTION
--pct-pinchzoom	FACTOR_PINCHZOOM
--pct-trackball	FACTOR_TRACKBALL	MonkeyTrackballEvent
--pct-syskeys	FACTOR_SYSOPS	MonkeyKeyEvent
--pct-nav	FACTOR_NAV
--pct-majornav	FACTOR_MAJORNAV
--pct-anyevent	FACTOR_ANYTHING
--pct-appswitch	FACTOR_APPSWITCH	MonkeyActivityEvent
--pct-flip	FACTOR_FLIP	MonkeyFlipEvent

　　5）该类通过getNextEvent()方法，供主类Monkey调用。所有事件放在MonkeyEventQueue中维护，如果为空则创建，不为空则返回第一个。

3，对于MonkeyEvent，有多种，也都是继承了基类MonkeyEvent，其关系如下图。（这同样是一种典型的面向对象的编程范式）

　　1）对于基类MonkeyEvent，定义了七种事件类型，都以EVENT_TYPE_开头，有KEY, TOUCH, TRACKBALL, ACTIVITY, FLIP, THROTTLE, NOOP。分别对应上面的各个叶子类（Motion派生出了Touch和Trackball）。在各个子类的构造函数中，都会根据类型调用基类的构造函数。当然需要注意的是，对于ACTIVITY这个类型，除了MonkeyActivityEvent，还有MonkeyCommandEvent, MonkeyGetFrameRateEvent, MonkeyInstrumentationEvent, MonkeyPowerEvent这四种事件也对应该类型。（具体原因还有待分析）

　　2）基类MonkeyEvent中还定了了四种执行结果的返回码，分别是SUCESS, FAIL, REMOTE_EXCEPTION, SECURITY_EXCEPTION。在各个派生类都要覆写的抽象方法injectEvent()中，都需要按情况返回对应的某种结果编码。

　　3）下面重点看下MonkeyMotionEvent（以及其派生出的MonkeyTouchEvent和MonkeyTrackBallEvent）。在设计上，采用了构建者（Builder）设计模式，可以让MonkeySource方便的构建出所需的特定事件。在内部事件处理中，采用Android的view组件中的MotionEvent，具体执行时，将MotionEvent对象传给派生类TouchEvent和TrackBallEvent处理，它们分别调用系统内部IWindowManager,的接口执行对应的Touch和TrackBall事件。需要注意的事，MotionEvent执行完最好进行recycle()。

　　4）对于MonkeyKeyEvent，采用了和MonkeyMotionEvent类似的思路，采用Android的view组件中的KeyEvent，具体事件执行也是利用IWindowManager调用。而对于MonkeyActivityEvent，也类似，采用了Android的content组件中的Intent，利用IActivityManager执行具体事件。至于MonkeyThrottleEvent，就是休眠一段时间；而MonkeyNoopEvent，就什么都不干。

　　对于MonkeyCommandEvent, MonkeyGetFrameRateEvent, MonkeyInstrumentationEvent, MonkeyPowerEvent，主要用在脚本执行（MonkeySourceScript）中，现实中很少用到。

　　5）通过对各个具体Event的分析，主要是在方法injectEvent()中通过特定的方式去执行相应的事件，有的简单，有的利用了系统的接口。如果后面需要改造这个代码，让其在用在自己的项目中，那就必须得去掉这些系统的内部接口，改用其他的方式。

4，再看下MonkeyEventQueue这个类，它继承自LinkedList，用来维护Monkey Event。

（在MonkeySourceRandom中，产生的事件都放在MonkeyEventQueue定义的mQ中；当在Monkey中需要获取一个事件时，也通过mQ的getFirst来获取。）

重点看下MonkeyEventQueue覆写的LinedList的addLast方法，其主要是对有间隔时间的事件做特殊处理，如果设置间隔时间随机则还要取一个随机数。

 1  public void addLast(MonkeyEvent e) { 2         super.add(e); 3         if (e.isThrottlable()) { 4             long throttle = mThrottle; 5             if (mRandomizeThrottle && (mThrottle > 0)) { 6                 throttle = mRandom.nextLong(); 7                 if (throttle < 0) { 8                     throttle = -throttle; 9                 }10                 throttle %= mThrottle;11                 ++throttle;12             }13             super.add(new MonkeyThrottleEvent(throttle));14         }15     }

三、代码的改造

　　通过以上的分析，发现可改造的一点是，在具体事件的执行上，去掉对IWindowManager和IActivityManager的依赖。

（暂时先写到这边）

参考：

[1] Google关于monkey的官方文档：http://developer.android.com/tools/help/monkey.html

[2] 博客：http://www.cnblogs.com/by-dream/p/5157308.html

转载于:https://www.cnblogs.com/luceion/p/5494976.html

一、使用

二、源码解析

三、代码的改造

更多相关文章

随机推荐