Monkey

轉自 ：http://www.linuxidc.com/Linux/2010-11/29684.htm

Monkey是一個命令行工具 ，能夠運行在模擬器裏或實際設備中。它向系統發送僞隨機的用戶事件流，實現對正在開發的應用程序進行壓力測試。Monkey包括許多選項，它們大體分爲四大類：

· 基本配置 選項，如設置嘗試的事件數量。

· 運行約束選項，如設置只對單獨的一個包進行測試。

· 事件類型 和頻率。

· 調試選項。

在Monkey運行的時候，它生成事件，並把它們發給系統。同時，Monkey還對測試中的系統進行監測，對下列三種狀況進行特殊處理：

· 若是限定了Monkey運行在一個或幾個特定的包上，那麼它會監測試圖轉到其它包的操做，並對其進行阻止。

· 若是應用程序崩潰或接收到任何失控異常 ，Monkey將中止並報錯。

· 若是應用程序產生了應用程序不響應(application not responding)的錯誤，Monkey將會中止並報錯。

按照選定的不一樣級別的反饋信息，在Monkey中還能夠看到其執行過程報告和生成的事件。

Monkey基本用法

能夠經過開發機器上的命令行或腳原本啓動Monkey。因爲Monkey運行在模擬器/設備環境中，因此必須用其環境中的shell來進行啓動。能夠經過在每條命令前加上adb shell來達到目的，也能夠進入Shell後直接輸入Monkey命令。基本語法以下：

$ adb shell monkey [options]

若是不指定options，Monkey將以無反饋模式啓動，並把事件任意發送到安裝 在目標環境中的所有包。下面是一個更爲典型的命令行示例，它啓動指定的應用程序，並向其發送500個僞隨機事件：

$ adb shell monkey -p your.package.name -v 500

--v

命令行的每個 -v 將增長反饋信息的級別。 Level 0( 缺省值 ) 除啓動提示、測試完成和最終結果以外，提供較少信息。 Level 1 提供較爲詳細的測試信息，如逐個發送到 Activity 的事件。 Level 2 提供更加詳細的設置信息，如測試中被選中的或未被選中的 Activity 。

事件

-s <seed>

僞隨機數生成器的 seed 值。若是用相同的 seed 值再次運行 Monkey ，它將生成相同的事件序列。

--throttle <milliseconds>

在事件之間插入固定延遲。經過這個選項能夠減緩 Monkey 的執行速度。若是不指定該選項， Monkey 將不會被延遲，事件將盡量快地被產成。

--pct-touch <percent>

調整觸摸事件的百分比 ( 觸摸事件是一個 down-up 事件，它發生在屏幕上的某單一位置 ) 。

--pct-motion <percent>

調整動做事件的百分比 ( 動做事件由屏幕上某處的一個 down 事件、一系列 的僞隨機事件和一個 up 事件組成 ) 。

--pct-trackball <percent>

調整軌跡事件的百分比 ( 軌跡事件由一個或幾個隨機的移動組成，有時還伴隨有點擊 ) 。

--pct-nav <percent>

調整「基本」導航事件的百分比 ( 導航事件由來自方向輸入設備的 up/down/left/right 組成 ) 。

--pct-majornav <percent>

調整「主要」導航事件的百分比 ( 這些導航事件一般引起圖形界面中的動做，如： 5-way 鍵盤的中間按鍵、回退按鍵、菜單按鍵 )

--pct-syskeys <percent>

調整「系統」按鍵事件的百分比 ( 這些按鍵一般被保留，由系統使用，如 Home 、 Back 、 Start Call 、 End Call 及音量控制鍵 ) 。

--pct-appswitch <percent>

調整啓動 Activity 的百分比。在隨機間隔裏， Monkey 將執行一個 startActivity () 調用，做爲最大程度覆蓋包中所有 Activity 的一種方法。

--pct-anyevent <percent>

調整其它類型事件的百分比。它包羅了全部其它類型的事件，如：按鍵、其它不經常使用的設備按鈕、等等。

約束限制

-p <allowed-package-name>

若是用此參數指定了一個或幾個包， Monkey 將只容許系統啓動這些包裏的 Activity 。若是你的應用程序還須要訪問其它包裏的 Activity( 如選擇取一個聯繫人 ) ，那些包也須要在此同時指定。若是不指定任何包， Monkey 將容許系統啓動所有包裏的 Activity 。要指定多個包，須要使用多個 -p 選項，每一個 -p 選項只能用於一個包。

-c <main-category>

若是用此參數指定了一個或幾個類別， 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 將繼續向系統發送事件，直到計數完成。

--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 ，直到有調試器和它相鏈接。