Monkey 命令行工具

寫完應用之后，作完單元測試和功能測試，有必要對應用的抗打擊能力做個測試，最好的方法是雇個“猴子”在測試，猴子可以胡亂瞎按鍵，在這種情況下，你的應用是否還能正常工作呢？

Android 測試包中提供了一個 Monkey 工具，就提供了“猴子”功能，不過比真”猴子“還要智能一些，你還可以指揮這個猴子， 比如按鍵的比例，觸發(fā)某個事件的頻率等等。

一個簡單的用法，比如你的應用程序的包名為：com.pstreets.navigator

可以使用 adb shell monkey -p com.pstreets.navigator -v 500

使用缺省的配置 向應用發(fā)送 500 個隨機事件（包括按鍵，touch 事件，系統(tǒng)事件等），該命令會首先啟動對應的 Activity，然后向該應用發(fā)送隨機事件：

http://wiki.jikexueyuan.com/project/android-test-course/images/17.1.jpg" alt="picutre17.1" />

Monkey 工具的詳細說明如下：

它是一個命令行工具 ，可以運行在模擬器里或實際設備中。它向系統(tǒng)發(fā)送偽隨機的用戶事件流，實現(xiàn)對正在開發(fā)的應用程序進行壓力測試。Monkey 包括許多選項，它們大致分為四大類：

• 基本配置 選項，如設置嘗試的事件數(shù)量。
• 運行約束選項，如設置只對單獨的一個包進行測試。
• 事件類型 和頻率。
• 調試選項。

在 Monkey 運行的時候，它生成事件，并把它們發(fā)給系統(tǒng)。同時，Monkey 還對測試中的系統(tǒng)進行監(jiān)測，對下列三種情況進行特殊處理：

• 如果限定了 Monkey 運行在一個或幾個特定的包上，那么它會監(jiān)測試圖轉到其它包的操作，并對其進行阻止。
• 如果應用程序崩潰或接收到任何失控異常 ，Monkey 將停止并報錯。
• 如果應用程序產生了應用程序不響應(application not responding)的錯誤，Monkey 將會停止并報錯。

按照選定的不同級別的反饋信息，在 Monkey 中還可以看到其執(zhí)行過程報告和生成的事件。

Monkey 基本用法

可以通過開發(fā)機器上的命令行或腳本來啟動 Monkey。由于 Monkey 運行在模擬器/設備環(huán)境中，所以必須用其環(huán)境中的 shell 來進行啟動?？梢酝ㄟ^在每條命令前加上 adb shell 來達到目的，也可以進入 Shell 后直接輸入 Monkey 命令。基本語法如下：

$ adb shell monkey [options]

如果不指定 options，Monkey 將以無反饋模式啟動，并把事件任意發(fā)送到安裝 在目標環(huán)境中的全部包。下面是一個更為典型的命令行示例，它啟動指定的應用程序，并向其發(fā)送 500 個偽隨機事件：

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

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

-s

偽隨機數(shù)生成器的 seed 值。如果用相同的 seed 值再次運行 Monkey ，它將生成相同的事件序列。

–throttle

在事件之間插入固定延遲。通過這個選項可以減緩 Monkey 的執(zhí)行速度。如果不指定該選項， Monkey 將不會被延遲，事件將盡可能快地被產成。

–pct-touch

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

–pct-motion

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

–pct-trackball

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

–pct-nav

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

–pct-majornav

調整“主要”導航事件的百分比 ( 這些導航事件通常引發(fā)圖形界面中的動作，如： 5-way 鍵盤的中間按鍵、回退按鍵、菜單按鍵 )

–pct-syskeys

調整“系統(tǒng)”按鍵事件的百分比 ( 這些按鍵通常被保留，由系統(tǒng)使用，如 Home 、 Back 、 Start Call 、 End Call 及音量控制鍵 ) 。

–pct-appswitch

調整啟動 Activity 的百分比。在隨機間隔里， Monkey 將執(zhí)行一個 startActivity () 調用，作為最大程度覆蓋包中全部 Activity 的一種方法。

–pct-anyevent

調整其它類型事件的百分比。它包羅了所有其它類型的事件，如：按鍵、其它不常用的設備按鈕、等等。 約束限制

-p

如果用此參數(shù)指定了一個或幾個包， Monkey 將只允許系統(tǒng)啟動這些包里的 Activity 。如果你的應用程序還需要訪問其它包里的 Activity( 如選擇取一個聯(lián)系人 ) ，那些包也需要在此同時指定。如果不指定任何包， Monkey 將允許系統(tǒng)啟動全部包里的 Activity 。要指定多個包，需要使用多個 -p 選項，每個 -p 選項只能用于一個包。

-c

如果用此參數(shù)指定了一個或幾個類別， Monkey 將只允許系統(tǒng)啟動被這些類別中的某個類別列出的 Activity 。如果不指定任何類別， Monkey 將選擇下列類別中列出的 Activity ： Intent.CATEGORY_LAUNCHER 或 Intent.CATEGORY_MONKEY 。要指定多個類別，需要使用多個 -c 選項，每個 -c 選項只能用于一個類別。

調試

–dbg-no-events

設置此選項， Monkey 將執(zhí)行初始啟動，進入到一個測試 Activity ，然后不會再進一步生成事件。為了得到最佳結果，把它與 -v 、一個或幾個包約束、以及一個保持 Monkey 運行 30 秒或更長時間的非零值聯(lián)合起來，從而提供一個環(huán)境，可以監(jiān)視應用程序所調用的包之間的轉換。

–hprof

設置此選項，將在 Monkey 事件序列之前和之后立即生成 profiling 報告。這將會在 data/misc 中生成大文件 (~5Mb) ，所以要小心使用它。

–ignore-crashes

通常，當應用程序崩潰或發(fā)生任何失控異常時， Monkey 將停止運行。如果設置此選項， Monkey 將繼續(xù)向系統(tǒng)發(fā)送事件，直到計數(shù)完成。

–ignore-timeouts

通常，當應用程序發(fā)生任何超時錯誤 ( 如“ Application Not Responding ”對話框 ) 時， Monkey 將停止運行。如果設置此選項， Monkey 將繼續(xù)向系統(tǒng)發(fā)送事件，直到計數(shù)完成。

–ignore-security-exceptions

通常，當應用程序發(fā)生許可錯誤 ( 如啟動一個需要某些許可的 Activity) 時， Monkey 將停止運行。如果設置了此選項， Monkey 將繼續(xù)向系統(tǒng)發(fā)送事件，直到計數(shù)完成。

–kill-process-after-error

通常，當 Monkey 由于一個錯誤而停止時，出錯的應用程序將繼續(xù)處于運行狀態(tài)。當設置了此選項時，將會通知系統(tǒng)停止發(fā)生錯誤的進程。注意，正常的 ( 成功的 ) 結束，并沒有停止啟動的進程，設備只是在結束事件之后，簡單地保持在最后的狀態(tài)。

–monitor-native-crashes

監(jiān)視并報告 Android 系統(tǒng)中本地代碼的崩潰事件。如果設置了 –kill-process-after-error ，系統(tǒng)將停止運行。

–wait-dbg

停止執(zhí)行中的 Monkey ，直到有調試器和它相連接。