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()