Monkey API學習與腳本編寫小記

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 常用命令

命令

命令格式

說明

flip flip open、filp closed 打開或關閉鍵盤
touch touch [down|up|move] [x] [y] 模擬手指按下邊界的操作
trackball trackball [dx] [dy] 發送一個軌跡球操作事件
key key [down|up] [keycode] 發送一個按鍵事件
sleep sleep [暫停時間] 服務器暫停一點時間
type type [String] 向當前應用發送一個字符串
wake wake 喚醒設備
tap tap [x] [y] 發送一個單擊座標的命令
press press [keycode] 發送一個按鍵
deferreturn deferrenturn [event] [timepue] [command] 執行一個命令在指定延時之內等待一個event事件

4.2 查詢命令:

命令

命令格式

說明

listvar listvar 列出可查看的系統變量
getvar getvar [variable name] 獲取一個系統變量的值
listviews listviews 列出待測應用裏的所有視圖的ID
getrootview getrootview 獲取待測試應用的最上層控件的ID
getviewswithtext getviewswithtext [text] 返回所有包含指定文本的控件ID
queryview queryview 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

轉載自:安靜的偏執  http://blog.csdn.net/swordgirl2011/article/details/50918665

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章