monkey 介紹
Monkey是Google提供的一個用于穩定性與壓力測試的命令行工具。可以運行在模擬器或者實際設備中。它向系統發送偽隨機的用戶事件(如按鍵、手勢、觸摸屏等輸入),對軟件進行穩定性與壓力測試。
Monkye路徑:
- Monkey程序由Android系統自帶,使用Java語言寫成,在Android文件系統中的存放路徑是:/system/framework/monkey.jar;
- Monkey.jar程序是由一個名為“monkey”的Shell腳本來啟動執行,shell腳本在Android文件系統中的存放路徑是:/system/bin/monkey;
Monkey環境變量的配置
Monkey是由adb命令啟動,故只要配置adb環境
- (1)下載Android SDK,解壓;
- (2)將SDK目錄下的platform-tools和tools目錄配置到系統環境變量中;
- (3)打開cmd窗口,輸入adb,有adb幫助信息則配置成功。
monkey參數如下
注意:以下例子中命令均為Windows cmd命令窗口運行環境,往外官網列出的參數并不是全部參數,更全的參數要看monkey源代碼。
常規參數
-
-help
作用:列出簡單的用法。
例:adb shell monkey -help
注:一般很少用到此參數,偷懶的做法直接輸入adb shell monkey
就可以看到簡單用法列表。 -v
作用:命令行上的每一個-v都將增加反饋信息的詳細級別。Level0(默認-v),除了啟動、測試完成和最終結果外只提供較少的信息。
Level1(-v -v),提供了較為詳細的測試信息,如逐個發送到Activity的事件信息。
Level2(-v -v -v),提供了更多的設置信息,如測試中選中或未選中的Activity信息。
例:adb shell monkey -v 10
注:比較常用的是-v -v -v,即最多詳細信息,一般會保存到指定文件中供開發人員查找bug原因時使用。
事件
-
-s <seed>
作用:偽隨機數生成器的seed值。如果用相同的seed值再次運行monkey,將生成相同的事件序列。
例:adb shell monkey -s 12345 -v 10
-
--throttle <milliseconds>
作用:在事件之間插入固定的時間(毫秒)延遲,你可以使用這個設置來減緩Monkey的運行速度,如果你不指定這個參數,則事件之間將沒有延遲,事件將以最快的速度生成。
例:adb shell monkey --throttle 300 -v 10
注:常用參數,一般設置為300毫秒,原因是實際用戶操作的最快300毫秒左右一個動作事件,所以此處一般設置為300毫秒。 -
--pct-touch <percent>
作用:調整觸摸事件的百分比。(觸摸事件是指在屏幕中的一個down-up事件,即在屏幕某處按下并抬起的操作)
例:adb shell monkey --pct-touch 100 -v 10
注:常用參數,此參數設置要適應當前被測應用程序的操作,比如一個應用80%的操作都是觸摸,那就可以將此參數的百分比設置成相應較高的百分比。 -
--pct-motion <percent>
作用:調整motion事件百分比。(motion事件是由屏幕上某處一個down事件、一系列偽隨機的移動事件和一個up事件組成)
例:adb shell monkey --pct-motion 100 -v 10
注:常用參數,需注意的是移動事件是直線滑動,下面的trackball移動包含曲線移動。 -
--pct-trackball <percent>
作用:調整滾動球事件百分比。(滾動球事件由一個或多個隨機的移動事件組成,有時會伴隨著點擊事件)
例:adb shell monkey --pct-trackball 100 -v 10
注:不常使用參數,現在手機幾乎沒有滾動球,但滾動球事件中包含曲線滑動事件,在被測程序需要曲線滑動時可以選用此參數。 -
--pct-nav <percent>
作用:調整基本的導航事件百分比。(導航事件由方向輸入設備的上下左右按鍵所觸發的事件組成)
例:adb shell monkey --pct-nav 100 -v 10
注:不常用操作。 -
--pct-majornav <percent>
作用:調整主要導航事件的百分比。(這些導航事件通常會導致UI界面中的動作事件,如5-way鍵盤的中間鍵,回退按鍵、菜單按鍵)
例:adb shell monkey --pct-majornav 100 -v 10
注: -
--pct-syskeys <percent>
作用:調整系統事件百分比。(這些按鍵通常由系統保留使用,如Home、Back、Start Call、End Call、音量調節)
例:adb shell monkey --pct-syskeys 100 -v 10
注:不常用。 -
--pct-appswitch <percent>
作用:調整Activity啟動的百分比。(在隨機的時間間隔中,Monkey將執行一個startActivity()調用,作為最大程度覆蓋被測包中全部Activity的一種方法)
例:adb shell monkey --pct-appswitch 100 -v 5
注:不常用。 -
--pct-anyevent
作用:調整其他事件的百分比。(這包含所有其他事件,如按鍵、其他在設備上不常用的按鈕等)
例:adb shell monkey --pct-anyevent 100 -v 5
注:不常使用。
約束條件
-
-p <allowed-package-name>
作用:如果你指定一個或多個包,Monkey將只允許訪問這些包中的Activity。如果你的應用程序需要訪問這些包(如選擇聯系人)以外的Activity,你需要指定這些包。如果你不指定任何包,Monkey將允許系統啟動所有包的Activity。指定多個包,使用多個-p,一個-p后面接一個包名。
例:adb shell monkey -p com.android.browser -v 10
注:常用參數。 -c <main-category>
作用:如果你指定一個或多個類別,Monkey將只允許系統啟動這些指定類別中列出的Activity。如果你不指定任何類別,Monkey將選擇謝列類別中列出的Activity,Intent.CATEGORY_LAUNCHER和Intent.CATEGORY_MONKEY。指定多個類別使用多個-c,每個-c指定一個類別。
例:adb shell monkey -p com.android.browser/mainActivity -v 10
注:不常用。--dbg-no-events
作用:設置此選項,Monkey將執行初始啟動,進入一個測試Activity,并不會在進一步生成事件。為了得到最佳結果,結合參數-v,一個或多個包的約束,以及一個保持Monkey運行30秒或更長時間的非零值,從而提供了一個可以監視應用程序所調用的包之間轉換的環境。
例:
注:不常用。--hprof
作用:設置此選項,將在Monkey生成事件序列前后生成profilling報告。在data/misc路徑下生成大文件(~5Mb),所以要小心使用。
例:
注:不常用。****--ignore-crashes**
作用:通常,應用發生崩潰或異常時Monkey會停止運行。如果設置此項,Monkey將繼續發送事件給系統,直到事件計數完成。
例:
注:常用。--ignore-timeouts**
作用:通常,應用程序發生任何超時錯誤(如“Application Not responding”對話框)Monkey將停止運行,設置此項,Monkey將繼續發送事件給系統,直到事件計數完成。
例:
注:常用。--ignore-security-exception **
作用:通常,當程序發生許可錯誤(例如啟動一些需要許可的Activity)導致的異常時,Monkey將停止運行。設置此項,Monkey將繼續發送事件給系統,直到事件計數完成。
例:
注:常用。****--kill-process-after-error**
作用:通常,當Monkey由于一個錯誤而停止時,出錯的應用程序將繼續處于運行狀態。設置此項,將會通知系統停止發生錯誤的進程。注意,正常(成功)的結束,并沒有停止啟動的進程,設備只是在結束事件之后簡單的保持在最后的狀態。
例:
注:
--monitor-native-crashes**
作用:監視并報告Andorid系統中本地代碼的崩潰事件。如果設置--kill-process-after-error,系統將停止運行。
例:
注:--wait-dbg
作用:停止執行中的Monkey,直到有調試器和它相連接。
例:
注:
以下參數為Monkey官網中為列出,但命令行幫助中可以顯示的參數,先列出,以后抽時間整理其使用方法
- --pct-rotation
- --pct-pinchzoom
- --pkg-blacklist-file
- --pkg-whitelist-file
- --randomize-throttle
- --port
- --setup
- -f
- --profile-wait
- --device-sleep-time
- --randomize-script
- --script-log
- --bugreport
- --periodic-bugreport
- -h
白名單和黑名單
- 只測試這部分應用(跟上一節說的 -p 的作用一樣)但是如果-p的程序過多就需要用到白名單了
- 黑名單:不測試的應用
--pkg-blacklist-file 后面跟的是文件的路徑
--pkg-whitelist-file 后面跟的是文件的路徑
可以自定義設置目錄 /data/local/tmp/
- 設置白名單
在d:\writelist.txt中設置白名單格式如下:
com.pageage.test
......
- 把白名單push到手機
adb push d:\whitelist.txt /data/local/tmp/
- 執行白名單
adb shell monkey -- pkg-whitelist-file /data/local/tmp/whitelist.txt --throttle 200 300
這個命令的意思就是 只跑白名單里面的應用,延遲200毫秒 執行300次,黑名單的執行方法和白名單一樣
其他實例
- 跑ALL APK命令:(>2小時)
monkey --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 30000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑單個APK命令(>6小時):
monkey --pkg-whitelist-file /mnt/sdcard/whitelist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 90000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑單個APK命令(>2小時):
monkey --pkg-whitelist-file /mnt/sdcard/whitelist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 30000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑ALL APK命令(>12小時):
monkey --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 180000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑ALL APK命令(>12小時)加入黑名單:
monkey --pkg-blacklist-file /mnt/sdcard/blacklist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 180000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑單個APK命令(>12小時):
monkey --pkg-whitelist-file /mnt/sdcard/whitelist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 180000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑ALL APK命令(>24小時):
monkey --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 360000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑ALL APK命令(>24小時)加入黑名單:
monkey --pkg-blacklist-file /mnt/sdcard/blacklist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 360000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
- 跑單個APK命令(>24小時):
monkey --pkg-whitelist-file /mnt/sdcard/whitelist.txt --throttle 1000 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -s 1000 -v -v -v 360000 1 >> /mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt
注:跑單個APK時一定記住在手機存儲根目錄里面放一個白名單文件:whitelist.txt,txt文本寫入要測的模塊APK應用的包名即可,表示只跑指定apk,如果是在手機根目錄中放blacklist.txt,填寫相應包名,指跑除blacklist.txt上指定應用的所有應用。Monkey跑完后檢查log里面是否有crash、anr(在根目錄下的/mnt/sdcard/Stability_base.txt 2>> /mnt/sdcard/Stability_base_err.txt)
其實僅僅就是拿到手機后,將/mnt/sdcard放入whitelist.txt或則blacklist.txt,里面放上應用包名,然后adb shell---》mokey命名,就可以了
來自
- http://blog.csdn.net/jlminghui/article/details/38238443
- http://blog.csdn.net/u013947002/article/details/49024587