Monkey API学习与脚本编写小记

转自http://blog.csdn.net/swordgirl2011/article/details/50918665

安静的偏执的专栏

1. Monkey脚本格式

1.1 Monkey脚本主要包含两部分，一部分是头文件信息，一部分是具体的monkey命令。

1.2 文件格式如下，e .g.

//头文件，控制monkey发送消息的参数,e.g. 

[plain] view plain copy

1. type = raw events  
2. count = 5  
3. speed = 1.0  
4. //下面为monkey命令  
5. start data >>   
6. 具体的monkey脚本内容  

2. Monkey脚本API简介

LaunchActivity(pkg_name, cl_name): 启动应用的Activity。参数：包名和启动的Activity。

Tap(x, y, tapDuration): 模拟一次手指单击事件。参数：x,y为控件坐标，tapDuration为点击的持续时间，此参数可省略。

DispatchPress(keyName): 按键。参数： keycode。 详细的Android Keycode列表：Android Keycode列表。

RotateScreen(rotationDegree, persist): 旋转屏幕。 参数：rotationDegree为旋转角度， e.g. 1代表90度；persist表示旋转之后是否固定，0表示旋转后恢复，非0则表示固定不变。

DispatchFlip(true/false): 打开或者关闭软键盘。

LongPress():  长按2秒。

PressAndHold(x, y, pressDuration):  模拟长按事件。

DispatchString(input):  输入字符串。

Drag(xStart, yStart, xEnd, yEnd, stepCount):  用于模拟一个拖拽操作。

PinchZoom(x1Start, y1Start, x1End, y1End, x2Start, y2Start, x2End, y2End, stepCount): 模拟缩放手势。

UserWait(sleepTime): 休眠一段时间

DeviceWakeUp(): 唤醒屏幕。

PowerLog(power_log_type, test_case_status): 模拟电池电量信息。

WriteLog(): 将电池信息写入sd卡。

RunCmd(cmd): 运行shell命令。

DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFlags)：向指定位置，发送单个手势。

DispatchPointer(downtime,eventTime,action,x,yxpressure,size,metastate,xPrecision,yPrecision,device,edgeFilags) ：发送按键消息。

LaunchInstrumentation(test_name,runner_name): 运行一个instrumentation测试用例。

DispatchTrackball: 模拟发送轨迹球事件。

ProfileWait: 等待5秒。

StartCaptureFramerate():  获取帧率。

EndCaptureFramerate(input): 结束获取帧率。

3. 编写monkey脚本，简单的点击应用,并且登陆

3.1 编写脚本

[plain] view plain copy

1. #头文件信息  
2. type=raw events  
3. count=10  
4. speed=1.0  
5. start data >>  
6. #具体的脚本内容  
7. LaunchActivity(com.example.package,com.example.ui.SplashActivity)  
8. Tap(972,1818)  
9. UserWait(2000)  
10. Tap(540,607)  
11. DispatchFlip(false)  
12. DispatchString(1234567)  
13. Tap(636,859)  
14. UserWait(2000)  
15. Tap(388,895)  
16. UserWait(1000)  
17. DispatchString(123456)  
18. DispatchFlip(false)  
19. UserWait(2000)  
20. Tap(540,1104)  

3.2 执行脚本

[plain] view plain copy

1. adb push monkey.txt /sdcard/  
2. 103 KB/s (490 bytes in 0.004s)  
3. adb shell  
4. shell@pisces:/ $ monkey -f /sdcard/monkey.txt -v 1   

3.3 执行日志

[plain] view plain copy

1. :Monkey: seed=1459495139508 count=1  
2. :IncludeCategory: android.intent.category.LAUNCHER  
3. :IncludeCategory: android.intent.category.MONKEY  
4. Replaying 0 events with speed 0.0  
5. :Switch: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10200000;component=package/.ui.SplashActivity;end  
6.     // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=packagename/.ui.SplashActivity } in package xxx  
7. :Sending Touch (ACTION_DOWN): 0:(972.0,1818.0)  
8. :Sending Touch (ACTION_UP): 0:(972.0,1818.0)  
9.     // Allowing start of Intent { cmp=packagename/.ui.mine.MineActivity } in package xxx  
10. :Sending Touch (ACTION_DOWN): 0:(540.0,607.0)  
11. :Sending Touch (ACTION_UP): 0:(540.0,607.0)  
12. :Sending Flip keyboardOpen=false  
13.     // Allowing start of Intent { cmp=pacakgename/.ui.usercenter.UserLoginActivity } in package xxx  
14. // Shell command input text 1234567 status was 0  
15. :Sending Touch (ACTION_DOWN): 0:(636.0,859.0)  
16. :Sending Touch (ACTION_UP): 0:(636.0,859.0)  
17. :Sending Touch (ACTION_DOWN): 0:(388.0,895.0)  
18. :Sending Touch (ACTION_UP): 0:(388.0,895.0)  
19. // Shell command input text 123456 status was 0  
20. :Sending Flip keyboardOpen=false  
21. :Sending Touch (ACTION_DOWN): 0:(540.0,1104.0)  
22. :Sending Touch (ACTION_UP): 0:(540.0,1104.0)  
23. Events injected: 19  
24. :Sending rotation degree=0, persist=false  
25. :Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0  
26. ## Network stats: elapsed time=9245ms (0ms mobile, 0ms wifi, 9245ms not connected)  
27. // Monkey finished  

4. Monkey服务器命令

4.1 常用命令

命令

命令格式

说明

flipflip open、filp closed打开或关闭键盘touchtouch [down|up|move] [x] [y]模拟手指按下边界的操作trackballtrackball [dx] [dy]发送一个轨迹球操作事件keykey [down|up] [keycode]发送一个按键事件sleepsleep [暂停时间]服务器暂停一点时间typetype [String]向当前应用发送一个字符串wakewake唤醒设备taptap [x] [y]发送一个单击坐标的命令presspress [keycode]发送一个按键deferreturndeferrenturn [event] [timepue] [command]执行一个命令在指定延时之内等待一个event事件

4.2 查询命令：

命令

命令格式

说明

listvarlistvar列出可查看的系统变量getvargetvar [variable name]获取一个系统变量的值listviewslistviews列出待测应用里的所有视图的IDgetrootviewgetrootview获取待测试应用的最上层控件的IDgetviewswithtextgetviewswithtext [text]返回所有包含指定文本的控件IDqueryviewqueryview viewed [id] [command] 
queryview accessibilityids [id1] [id2] [command]根据指定ID来查询控件

5. Monkey服务器命令使用示例

5.1 打开手机端口：

5.2 转发端口，并建立连接：

5.3 同时按control + ], 回车即可开始输入命令 e.g:

[plain] view plain copy

1. //唤醒屏幕  
2. wake  
3. OK  
4.   
5. //点击指定坐标  
6. tap 500 600  
7. OK  
8.   
9. //输入字符串  
10. type 1000  
11. OK  
12.   
13. //点击按钮  
14. press KEYCODE_VOLUME_UP  
15. OK  
16.   
17. //列出系统变量  
18. listvar  
19. OK:am.current.action am.current.categories am.current.comp.class am.current.comp.package am.current.data am.current.package build.board build.brand build.cpu_abi build.device build.display build.fingerprint build.host build.id build.manufacturer build.model build.product build.tags build.type build.user build.version.codename build.version.incremental build.version.release build.version.sdk clock.millis clock.realtime clock.uptime display.density display.height display.width monkey.version   
20.   
21. //获取指定系统变量值，e.g.分辨率  
22. getvar display.height  
23. OK:1920  
24. getvar display.width  
25. OK:1080  
26.   
27. //列出待测应用里的所有视图id  
28. listviews  
29. OK:action0 action_bar action_bar_activity_content action_bar_container action_bar_root action_bar_spinner action_bar_subtitle action_bar_title action_context_bar action_divider action_menu_divider action_menu_presenter action_mode_bar action_mode_bar_stub action_mode_close_button action_settings activity_chooser_view_content adjust_height adjust_width alertTitle always avatar beginning buttonPanel cancel_action checkbox checkoutWebView chronometer collapseActionView container contentPanel currentUrl custom customPanel decor_content_parent default_activity_button desktopText desktopView desktop_graphic disableHome drawerLayout drawerPane edit_query editbox_shape end end_padder expand_activities_button expanded_menu home homeAsUp icon ifRoom image info install_update line1 line3 listMode list_item mainView media_actions middle multiply navAvatar navDesktop navList never none normal not_now parentPanel powerLantern profileBox progress_circular progress_horizontal radio receive_lantern screen scrollView search_badge search_bar search_button search_close_btn search_edit_frame search_go_btn search_mag_icon search_plate search_src_text search_voice_btn select_dialog_listview sendBtn sendEmail separator settings_icon shortcut showCustom showHome showTitle split_action_bar src_atop src_in src_over status_bar_latest_event_content status_image status_layout_root submit_area tabMode text text2 textSpacerNoButtons time title title_template toast_off toast_on topPanel up update_available update_icon updater updater_view useLogo userName versionNum withText wrap_content  

备注：

Monkey源代码地址： https://github.com/android/platform_development/tree/master/cmds/monkey