Monkey基本用法與常用引數

可以透過開發機器上的命令列或指令碼來啟動 Monkey 。由於 Monkey 執行在模擬器 / 裝置環境中，所以必須用其環境中的 shell 來進行啟動。可以透過在每條命令前加上 adb shell 來達到目的，也可以進入 Shell 後直接輸入 Monkey 命令。基本語法如下：
$ adb shell monkey [options] 
如果不指定 options ， Monkey 將以無反饋模式啟動，並把事件任意傳送到安裝在目標環境中的全部包。下面是一個更為典型的命令列示例，它啟動指定的應用程式，並向其傳送 500 個偽隨機事件：
$ adb shell monkey -p your.package.name -v 500

You can launch the Monkey using a command line on your development machine or from a script. Because the Monkey runs in the emulator/device environment, you must launch it from a shell in that environment. You can do this by prefacing adb shell to each command, or by entering the shell and entering Monkey commands directly.

The basic syntax is:

$ adb shell monkey [options] <event-count>

With no options specified, the Monkey will launch in a quiet (non-verbose) mode, and will send events to any (and all) packages installed on your target. Here is a more typical command line, which will launch your application and send 500 pseudo-random events to it:

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

命令選項參考

--help
列出簡單的用法。

-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，直到有偵錯程式和它相連線。