Android Monkey测试脚本

转载于：http://blog.csdn.net/quaful/article/details/6863914。

Android 的 monkey test 工具提供了 -f scriptfile 参数，可以指定 test 脚本，然而翻遍了 Android 的网站也没有找到这个脚本的文档，最终只在 monkey 的源码 MonkeySourceScript.java 中找到了一小段注释，里面给了一个不到 10 行例子:

/** 
 * monkey event queue. It takes a script to produce events 
 *  
 * sample script format: 
 *      type= raw events 
 *      count= 10 
 *      speed= 1.0 
 *      start data >> 
 *      captureDispatchPointer(5109520,5109520,0,230.75429,458.1814,0.20784314, 
 *          0.06666667,0,0.0,0.0,65539,0) 
 *      captureDispatchKey(5113146,5113146,0,20,0,0,0,0) 
 *      captureDispatchFlip(true) 
 *      ... 
 */

1）前三行是脚本头。count为脚本中包含的指令数目。speed为执行速度。

2）start data后面是执行的命令。

用法：

adb shell monkey -f <script file> <运行脚本的次数>

例如，我们放一个脚本到 /sdcard/monkey.script，然后运行：

adb shell monkey -f /sdcard/monkey.script 10，那么这个脚本里面指定的动作就会被执行10次。

有了这个例子之后稍微好办了些，至少有搜索的关键词了，于是用 captureDispatchPointer 很快就找到了一篇自动化测试的文章：

http://qatesttech.wordpress.com/category/android-monkey-script/

（以下是引用）

"DispatchPointer";"DispatchTrackball";"DispatchKey";"DispatchFlip";这几个最主要的函数  
按键事件：参见android.view KeyEvent.java  
DispatchKey(downTime, //@param： The time (in {@link android.os.SystemClock#uptimeMillis}) at which this key code originally went down.毫秒  
eventTime,     //at which this event happened.                     
action,        //Action code: either {@link #ACTION_DOWN=0}, {@link #ACTION_UP=1}, or {@link #ACTION_MULTIPLE=2}.  
code,    //The key code. 见附录1， 比如KEYCODE_DPAD_DOWN（20）KEYCODE_DPAD_UP（19）  
repeat, //A repeat count for down events (> 0 if this is after the initial down) or event count for multiple events.  
metaState, //Flags indicating which meta keys are currently pressed.  
device, //The device ID that generated the key event.  
scancode) //Raw device scan code of the event.  
  
DispatchPointer，DispatchTrackball(downTime, eventTime,  
                        action, x, y, pressure, size, metaState, xPrecision, yPrecision,  
                        device, edgeFlags);  
@action The kind of action being performed -- one of either{@link #ACTION_DOWN=0}, {@link #ACTION_MOVE=1}, {@link #ACTION_UP=2}, or{@link #ACTION_CANCEL=3}.  
@param x The X coordinate of this event.  
@param y The Y coordinate of this event.  
@param pressure The current pressure of this event.  The pressure generally ranges from 0 (no pressure at all) to 1 (normal pressure), however values higher than 1 may be generated depending on the calibration of the input device.  
@param size： A scaled value of the approximate size of the area being pressed touched with the finger. The actual value in pixels corresponding to the finger touch is normalized with a device specific range of values and scaled to a value between 0 and 1.  
@param metaState The state of any meta / modifier keys that were in effect when the event was generated.  
@param xPrecision The precision of the X coordinate being reported.  
@param yPrecision The precision of the Y coordinate being reported.  
@param deviceId The id for the device that this event came from.  An id of zero indicates that the event didn't come from a physical device; other numbers are arbitrary and you shouldn't depend on the values.  
@param edgeFlags A bitfield indicating which edges, if any, where touched by this MotionEvent  
captureDispatchFlip(true)是否打开滑盖，true是打开  

剩下具体每个函数的用法，就只能在源码里面慢慢发掘了。另外搜索到一个例子：

http://qatesttech.wordpress.com/2011/05/05/android-my-monkey-script/

# Start of Script  
type= user  
count= 49  
speed= 1.0  
start data >>  
LaunchActivity(com.mpowerlabs.coin.android, com.mpowerlabs.coin.android.LoginActivity)  
# 3120021258  
DispatchPress(KEYCODE_3)  
UserWait(200)  
DispatchPress(KEYCODE_1)  
UserWait(200)  
DispatchPress(KEYCODE_3)  
UserWait(200)  
DispatchPress(KEYCODE_5)  
UserWait(200)  
DispatchPress(KEYCODE_0)  
UserWait(200)  
DispatchPress(KEYCODE_2)  
UserWait(200)  
DispatchPress(KEYCODE_1)  
UserWait(200)  
DispatchPress(KEYCODE_2)  
UserWait(200)  
DispatchPress(KEYCODE_5)  
UserWait(200)  
DispatchPress(KEYCODE_8)  
UserWait(200)  
# Pin 12345  
DispatchPress(KEYCODE_DPAD_DOWN)  
UserWait(250)  
DispatchPress(KEYCODE_1)  
UserWait(200)  
DispatchPress(KEYCODE_2)  
UserWait(200)  
DispatchPress(KEYCODE_3)  
UserWait(200)  
DispatchPress(KEYCODE_4)  
UserWait(200)  
DispatchPress(KEYCODE_5)  
UserWait(200)  
# Down and enter  
DispatchPress(KEYCODE_DPAD_DOWN)  
UserWait(250)  
DispatchPress(KEYCODE_ENTER) 

整理的脚本函数列表：

DispatchPointer(downTime, eventTime,action, x, y, pressure, size, metaState,                               xPrecision,yPrecision,device, edgeFlags)
      @param long downTime  //键最初被按下的时间
      @param long eventTime  //事件发生的时间                   
      @param int action  //（ACTION_DOWN=0，ACTION_UP=1，ACTION_MOVE=2，ACTION_CANCEL=3）
      @param float x  //x坐标
      @param float y  //y坐标
      @param float pressure  //当前事件的压力，范围0-1
      @param float size  //触摸的近似值，范围0-1
      @param int metaState  //当前按下的meta键的标识
      @param float xPrecision  //x坐标精确值
      @param float yPrecision  //y坐标精确值
      @param int device  //事件来源，范围0-x，0表示不来自物理设备
      @param int sedgeFlags  //  
DispatchTrackball(long downTime,  long eventTime, int action,  
  
    float x, float y, float pressure, float size, int metaState,  
  
    float xPrecision, float yPrecision, int device, int edgeFlags) 
DispatchKey(downTime,eventTime,action,code,repeat,metaState,device,scancode)
      @param long downTime  //键最初被按下的时间
      @param long eventTime  //事件发生的时间                   
      @param int action  //（ACTION_DOWN=0，ACTION_UP=1，ACTION_MULTIPLE=2）
      @param int code  //键值，比如KEYCODE_DPAD_DOWN（20）
      @param int repeat  //
      @param int metaState  //当前按下的meta键的标识
      @param int device  //事件发生的设备id
      @param int scancode  //  
 
DispatchFlip(boolean keyboardOpen)  
  
DispatchPress(int keyCode)  
  
LaunchActivity(String pkg_name, String cl_name)  
  
UserWait(long sleeptime)  
  
LongPress()