1. Monkey腳本格式
1.1 Monkey腳本主要包含兩部分,一部分是頭文件信息,一部分是具體的monkey命令。
1.2 文件格式如下,e .g.
//頭文件,控制monkey發送消息的參數,e.g.
- type = raw events
- count = 5
- speed = 1.0
- //下面爲monkey命令
- start data >>
- 具體的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 編寫腳本
- #頭文件信息
- type=raw events
- count=10
- speed=1.0
- start data >>
- #具體的腳本內容
- LaunchActivity(com.example.package,com.example.ui.SplashActivity)
- Tap(972,1818)
- UserWait(2000)
- Tap(540,607)
- DispatchFlip(false)
- DispatchString(1234567)
- Tap(636,859)
- UserWait(2000)
- Tap(388,895)
- UserWait(1000)
- DispatchString(123456)
- DispatchFlip(false)
- UserWait(2000)
- Tap(540,1104)
3.2 執行腳本
- adb push monkey.txt /sdcard/
- 103 KB/s (490 bytes in 0.004s)
- adb shell
- shell@pisces:/ $ monkey -f /sdcard/monkey.txt -v 1
3.3 執行日誌
- :Monkey: seed=1459495139508 count=1
- :IncludeCategory: android.intent.category.LAUNCHER
- :IncludeCategory: android.intent.category.MONKEY
- Replaying 0 events with speed 0.0
- :Switch: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10200000;component=package/.ui.SplashActivity;end
- // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=packagename/.ui.SplashActivity } in package xxx
- :Sending Touch (ACTION_DOWN): 0:(972.0,1818.0)
- :Sending Touch (ACTION_UP): 0:(972.0,1818.0)
- // Allowing start of Intent { cmp=packagename/.ui.mine.MineActivity } in package xxx
- :Sending Touch (ACTION_DOWN): 0:(540.0,607.0)
- :Sending Touch (ACTION_UP): 0:(540.0,607.0)
- :Sending Flip keyboardOpen=false
- // Allowing start of Intent { cmp=pacakgename/.ui.usercenter.UserLoginActivity } in package xxx
- // Shell command input text 1234567 status was 0
- :Sending Touch (ACTION_DOWN): 0:(636.0,859.0)
- :Sending Touch (ACTION_UP): 0:(636.0,859.0)
- :Sending Touch (ACTION_DOWN): 0:(388.0,895.0)
- :Sending Touch (ACTION_UP): 0:(388.0,895.0)
- // Shell command input text 123456 status was 0
- :Sending Flip keyboardOpen=false
- :Sending Touch (ACTION_DOWN): 0:(540.0,1104.0)
- :Sending Touch (ACTION_UP): 0:(540.0,1104.0)
- Events injected: 19
- :Sending rotation degree=0, persist=false
- :Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
- ## Network stats: elapsed time=9245ms (0ms mobile, 0ms wifi, 9245ms not connected)
- // 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:
- //喚醒屏幕
- wake
- OK
- //點擊指定座標
- tap 500 600
- OK
- //輸入字符串
- type 1000
- OK
- //點擊按鈕
- press KEYCODE_VOLUME_UP
- OK
- //列出系統變量
- listvar
- 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
- //獲取指定系統變量值,e.g.分辨率
- getvar display.height
- OK:1920
- getvar display.width
- OK:1080
- //列出待測應用裏的所有視圖id
- listviews
- 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