UI/Application Exerciser Monkey

Monkey 是一個在您模擬器或裝置上執行的程式，會產生使用者事件 (例如點擊、輕觸或手勢) 的偽隨機資料流，以及一些系統層級事件。您可以使用 Monkey，以隨機但可重複的方式，對您開發的應用程式進行壓力測試。

總覽

Monkey 是一款指令列工具，可在任何模擬器執行個體或裝置上執行。此工具可將使用者事件的偽隨機資料流傳送到系統中，以便對您開發的應用程式軟體進行壓力測試。

Monkey 包含若干選項，但主要分為以下四個類別：

  • 基本設定選項，例如設定要嘗試的事件數量。
  • 操作限制，例如限制只對單一套件進行測試。
  • 事件類型和頻率。
  • 偵錯選項。

Monkey 會在執行時產生事件並傳送至系統。此工具也會「監控」測試中的系統，並針對三個情況進行特別處理：

  • 如果您已將 Monkey 限制在一或多個特定套件中執行，Monkey 會監測並封鎖前往任何其他套件的嘗試。
  • 如果您的應用程式當機或收到任何未處理的例外狀況，Monkey 將會停止並回報錯誤。
  • 如果您的應用程式產生「應用程式無回應」錯誤，Monkey 將會停止並回報錯誤。

視您選取的詳細程度等級而定，您也會看到關於 Monkey 進度和目前產生事件的報告。

Monkey 基本用法

您可以使用開發機器的指令列啟動 Monkey，也可以從指令碼中啟動此工具。由於 Monkey 是在模擬器/裝置環境中執行，因此必須從該環境的殼層中啟動。如要執行這項操作，請在每個指令前面加上 adb shell，或直接進入殼層並輸入 Monkey 指令。

基本語法如下：

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

如果您未指定任何選項，Monkey 會在安靜 (非詳細) 模式下啟動，並將事件傳送到目標上安裝的所有套件。以下是較為常見的指令列，除了會啟動您的應用程式，也會向其傳送 500 個偽隨機事件：

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

指令選項參考資料

下表列出可在 Monkey 指令列加入的所有選項。

類別 選項 說明
一般 --help 輸出簡易的使用指南。
-v 指令列中的每個 -v 都會增加詳細程度等級。等級 0 (預設) 表示除了啟動通知、測試完成和最終結果以外，幾乎不提供任何其他資訊。等級 1 會在測試執行時提供更多相關詳細資料，例如傳送到您活動的個別事件。等級 2 則會提供更詳細的設定資訊，例如已選取或未選取用於測試的活動。
事件 -s <seed> 偽隨機號碼產生器的種子值。如果使用相同的種子值重新執行 Monkey，則會產生相同的事件序列。
--throttle <milliseconds> 在事件之間插入固定延遲。您可使用此選項來減緩 Monkey 的速度。如未指定，系統就不會延遲，而會盡快產生事件。
--pct-touch <percent> 調整觸控事件的百分比 (觸控事件是螢幕上單一位置的點擊後放開事件)。
--pct-motion <percent> 調整動作事件的百分比 (動作事件包括螢幕上某個位置的點擊事件、一連串偽隨機動作，以及放開事件)。
--pct-trackball <percent> 調整軌跡球事件的百分比 (軌跡球事件包括一或多個隨機動作，有時後面會接著一次點擊)。
--pct-nav <percent> 調整「基本」導覽事件的百分比 (導覽事件包括向上/向下/向左/向右，具體取決於方向輸入裝置的輸入內容)。
--pct-majornav <percent> 調整「主要」導覽事件的百分比 (這些導覽事件通常會引起 UI 中的動作，像是 5 向鍵中的中間按鈕、返回鍵或選單鍵這類 UI)。
--pct-syskeys <percent> 調整「系統」重要事件的百分比 (這些按鍵通常保留供系統使用，例如「首頁」、「返回」、「開始通話」、「結束通話」或「音量控制」)。
--pct-appswitch <percent> 調整活動啟動的百分比。Monkey 會隨機發出一個 startActivity() 呼叫，盡可能提高套件中所有活動的涵蓋範圍。
--pct-anyevent <percent> 調整其他類型事件的百分比。這涵蓋所有其他類型的事件 (例如按鍵操作、裝置上其他不常用的按鈕等)。
限制 -p <allowed-package-name> 如果您依此方式指定一或多個套件，Monkey 將「僅」允許系統造訪這些套件中的活動。如果應用程式必須存取其他套件中的活動 (例如選取聯絡人)，您還需要指定這些套件。如果您未指定任何套件，Monkey 將允許系統啟動所有套件中的活動。若要指定多個套件，請多次使用 -p 選項，每個套件對應一個 -p 選項。
-c <main-category> 如果您依此方式指定一或多個類別，Monkey 將「僅」允許系統造訪其中一個指定類別所列的活動。如果您未指定任何類別，Monkey 將選取 Intent.CATEGORY_LAUNCHER 或 Intent.CATEGORY_MONKEY 類別所列的活動。若要指定多個類別，請多次使用 -c 選項，每個類別對應一個 -c 選項。
偵錯 --dbg-no-events 如果指定此選項，Monkey 將在測試活動中執行初始啟動作業，但不會產生任何進一步事件。為獲得最佳結果，請搭配使用 -v、一或多個套件限制，以及非零節流，讓 Monkey 運作 30 秒以上。在這個環境中，您可以監控應用程式叫用的套件轉換操作。
--hprof 如果設定的話，此選項將在 Monkey 事件序列前後立即產生剖析報告。這會導致 data/misc 中產生大型 (約 5 Mb) 檔案，使用時請謹慎小心。如要瞭解如何分析剖析報告，請參閱「分析應用程式效能」。
--ignore-crashes 一般來說，如果應用程式當機或發生任何類型的未處理例外狀況，Monkey 就會停止運作。如果您指定此選項，Monkey 會繼續向系統傳送事件，直到計數完成為止。
--ignore-timeouts 一般來說，如果應用程式發生任何類型的逾時錯誤 (例如顯示「應用程式無回應」對話方塊)，Monkey 就會停止運作。如果您指定此選項，Monkey 會繼續向系統傳送事件，直到計數完成為止。
--ignore-security-exceptions 一般來說，如果應用程式發生任何類型的權限錯誤 (例如嘗試啟動需要特定權限的活動)，Monkey 就會停止運作。如果您指定此選項，Monkey 會繼續向系統傳送事件，直到計數完成為止。
--kill-process-after-error 一般來說，當 Monkey 因錯誤而停止時，故障的應用程式將保持運行狀態。如果您設定此選項，將會指示系統終止發生錯誤的程序。請注意，在正常 (順利) 完成的情況下，已啟動的程序不會停止，且裝置只會保持在最終事件後的最後狀態。
--monitor-native-crashes 監控並回報 Android 系統原生程式碼發生的當機情形。如果設定了 --kill-process-after-error，系統將會停止運作。
--wait-dbg 停止執行 Monkey，直到附加偵錯工具為止。