Monkey命令行可用的全部選項
常規
--help
列出簡單的用法。
-v
命令行的每一個-v將增加反饋信息的級別。
Level 0(缺省值)除啟動提示、測試完成和最終結果之外,提供較少信息。
Level 1提供較為詳細的測試信息,如逐個發送到Activity的事件。
Level 2提供更加詳細的設置信息,如測試中被選中的或未被選中的Activity。
日志級別 Level 0
*示例 adbshell monkey -p com.htc.Weather –v 100
說明缺省值,僅提供啟動提示、測試完成和最終結果等少量信息
日志級別 Level 1
*示例 adbshell monkey -p com.htc.Weather –v -v 100
說明? 提供較為詳細的日志,包括每個發送到Activity的事件信息
日志級別 Level 2
*示例 adbshell monkey -p com.htc.Weather –v -v –v 100
說明? 最詳細的日志,包括了測試中選中/未選中的Activity信息
事件
-s
用于指定偽隨機數生成器的seed值,如果seed相同,則兩次Monkey測試所產生的事件序列也相同的。
* 示例:
Monkey測試1:adb shellmonkey -p com.htc.Weather –s 10 100
Monkey 測試2:adb shellmonkey -p com.htc.Weather –s 10 100
兩次測試的效果是相同的,因為模擬的用戶操作序列(每次操作按照一定的先后順序所組成的一系列操作,即一個序列)是一樣的。操作序列雖? 然是隨機生成的,但是只要我們指定了相同的Seed值,就可以保證兩次測試產生的隨機操作序列是完全相同的,所以這個操作序列偽隨機的;
--throttle
在事件之間插入固定延遲。通過這個選項可以減緩Monkey的執行速度。如果不指定該選項,Monkey將不會被延遲,事件將盡可能快地被產成。
* 示例:adb shellmonkey -p com.htc.Weather –throttle 3000 100
--pct-touch
調整觸摸事件的百分比(觸摸事件是一個down-up事件,它發生在屏幕上的某單一位置)。
* 示例:adb shellmonkey -p com.htc.Weather --pct-touch 10 1000
--pct-motion
調整動作事件的百分比(動作事件由屏幕上某處的一個down事件、一系列的偽隨機事件和一個up事件組成)。
* 示例:adb shellmonkey -p com.htc.Weather --pct-motion 20 1000
--pct-trackball
調整軌跡事件的百分比(軌跡事件由一個或幾個隨機的移動組成,有時還伴隨有點擊)。
* 示例:adb shellmonkey -p com.htc.Weather --pct-trackball 30 1000
--pct-nav
調整“基本”導航事件的百分比(導航事件由來自方向輸入設備的up/down/left/right組成)。
* 示例:adb shellmonkey -p com.htc.Weather --pct-nav 40 1000
--pct-majornav
調整“主要”導航事件的百分比(這些導航事件通常引發圖形界面中的動作,如:5-way鍵盤的中間按鍵、回退按鍵、菜單按鍵)
* 示例:adb shellmonkey -p com.htc.Weather --pct-majornav 50 1000
--pct-syskeys
調整“系統”按鍵事件的百分比(這些按鍵通常被保留,由系統使用,如Home、Back、Start Call、End Call及音量控制鍵)。
* 示例:adb shellmonkey -p com.htc.Weather --pct-syskeys 60 1000
--pct-appswitch
調整啟動Activity的百分比。在隨機間隔里,Monkey將執行一個startActivity()調用,作為最大程度覆蓋包中全部Activity的一種方法。
* 示例:adb shellmonkey -p com.htc.Weather --pct-appswitch 70 1000
--pct-anyevent
調整其它類型事件的百分比。它包羅了所有其它類型的事件,如:按鍵、其它不常用的設備按鈕、等等。* 示例:adb shell monkey -p com.htc.Weather
--pct -anyevent 1001000* 指定多個類型事件的百分比:
adb shell monkey -pcom.htc.Weather --pct-anyevent 50 --pct-appswitch 50 1000
注意:各事件類型的百分比總數不能超過100%;
約束限制
-p
如果用此參數指定了一個或幾個包,Monkey將只允許系統啟動這些包里的Activity。如果你的應用程序還需要訪問其它包里的Activity(如選擇取一個聯系人),那些包也需要在此同時指定。如果不指定任何包,Monkey將允許系統啟動全部包里的Activity。要指定多個包,需要使用多個 -p選項,每個-p選項只能用于一個包。
* 指定一個包: adb shell monkey -p com.htc.Weather? 100
說明:com.htc.Weather為包名,100是事件計數(即讓Monkey程序模擬100次隨機用戶事件)。
* 指定多個包:adb shell monkey -p com.htc.Weather –pcom.htc.pdfreader? -p com.htc.photo.widgets 100
* 不指定包:adb shell monkey 100
說明:Monkey隨機啟動APP并發送100個隨機事件。
* 要查看設備中所有的包,在CMD窗口中執行以下命令:
>adb shell
#cd data/data
#ls
-c
如果用此參數指定了一個或幾個類別,Monkey將只允許系統啟動被這些類別中的某個類別列出的Activity。如果不指定任何類別,Monkey將選 擇下列類別中列出的Activity: Intent.CATEGORY_LAUNCHER或Intent.CATEGORY_MONKEY。要指定多個類別,需要使用多個-c選項,每個-c選 項只能用于一個類別。
調試
--dbg-no-events
設置此選項,Monkey將執行初始啟動,進入到一個測試Activity,然后不會再進一步生成事件。為了得到最佳結果,把它與-v、一個或幾個包約 束、以及一個保持Monkey運行30秒或更長時間的非零值聯合起來,從而提供一個環境,可以監視應用程序所調用的包之間的轉換。
--hprof
設置此選項,將在Monkey事件序列之前和之后立即生成profiling報告。這將會在data/misc中生成大文件(~5Mb),所以要小心使用它。
--ignore-crashes
通常,當應用程序崩潰或發生任何失控異常時,Monkey將停止運行。如果設置此選項,Monkey將繼續向系統發送事件,直到計數完成。
* 示例1:adb shellmonkey -p com.htc.Weather --ignore-crashes 1000
測試過程中即使Weather程序崩潰,Monkey依然會繼續發送事件直到事件數目達到1000為止;
* 示例2:adb shell monkey -p com.htc.Weather 1000
測試過程中,如果Weather程序崩潰,Monkey將會停止運行。
--ignore-timeouts
通常,當應用程序發生任何超時錯誤(如“Application Not Responding”對話框)時,Monkey將停止運行。如果設置此選項,Monkey將繼續向系統發送事件,直到計數完成。
--ignore-security-exceptions
通常,當應用程序發生許可錯誤(如啟動一個需要某些許可的Activity)時,Monkey將停止運行。如果設置了此選項,Monkey將繼續向系統發送事件,直到計數完成。
--kill-process-after-error
通常,當Monkey由于一個錯誤而停止時,出錯的應用程序將繼續處于運行狀態。當設置了此選項時,將會通知系統停止發生錯誤的進程。注意,正常的(成功的)結束,并沒有停止啟動的進程,設備只是在結束事件之后,簡單地保持在最后的狀態。
--monitor-native-crashes
監視并報告Android系統中本地代碼的崩潰事件。如果設置了--kill-process-after-error,系統將停止運行。
--wait-dbg
停止執行中的Monkey,直到有調試器和它相連接。