Monkey Test 指令使用

Monkey是一個指令列工具 ，可以運作在仿真器裡或實際裝置中。它向系統發送僞随機的使用者事件流，實作對正在開發的應用程式進行壓力測試。Monkey包括許多選項，它們大緻分為四大類： 

Ø        基本配置選項，如設定測試的事件數量。

Ø        運作限制選項，如設定隻對單獨的一個包進行測試。

Ø        事件類型和頻率。

Ø        調試選項。

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

Ø        如果限定了Monkey運作在一個或幾個特定的包上，那麼它會監測試圖轉到其它包的操作，并對其進行阻止。 

Ø        如果應用程式崩潰或接收到任何失控異常，Monkey将停止并報錯。 

Ø        如果應用程式産生了應用程式不響應(applicationnot responding)的錯誤，Monkey将會停止并報錯。

按照標明的不同級别的回饋資訊，在Monkey中還可以看到其執行過程報告和生成的事件。

類别

選項

說明

正常

--help

列出簡單的用法。

-v

指令列的每一個 -v 将增加回報資訊的級别。 Level 0( 預設值 ) 除啟動提示、測試完成和最終結果之外，提供較少資訊。 Level 1 提供較為詳細的測試資訊，如逐個發送到 Activity的事件。 Level 2 提供更加詳細的設定資訊，如測試中被選中的或未被選中的 Activity 。

一般，一個v就足夠了

事件

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

另外monkey還可以執行腳本：官網上沒有詳細介紹，在網絡上有簡單介紹

<a href="http://groups.google.com/group/android-developers/browse_thread/thread/44522b92a6796d3">http://groups.google.com/group/android-developers/browse_thread/thread/44522b92a6796d3</a>

<a href="http://programfeelings.blogspot.com/2010/04/monkey-script-test.html">http://programfeelings.blogspot.com/2010/04/monkey-script-test.html</a>

一般此指令用的很少。

簡而言之，Helen_Fu的方法可作為一般測試的常用方法。

但是對于時間的測試方法，我覺得不是很合理例如：

共90001個事件，每個事件發生後休息一秒，再産生下一事件，相當于測試時間= 1000 × 90001ms=90001s

指定每次事件後的延遲時間（--throttle 1000）實際上加入了人為的假定，即假設Monkey内建的事件産生間隔也為1s。我認為應該采用Monkey預設的事件間隔，指定一個較大的事件産生個數，是足以滿足測試時間的。難點在于這個測試時間比較難估計，我想多測試幾次，應該能有結果。例如：

         我先指定測試500次，看看monkey幾秒執行完畢。假設執行500次事件，monkey耗時n秒。那麼測試時間12h，測指定測試事件個數為(12*3600*500*impact_factor))/n,其中impact_facor為影響因子（或安全系數），保證測試時長&gt;=12h。

其次Full Monkey Test，指的是對所有應用的package進行測試，而不應該認為Monkey能測試系統。

網上有比較多的測試結果分析

monkey -pcom.example.android.apis  -v -v -v 100

:Monkey: seed=0 count=100

:AllowPackage: com.example.android.apis 

IncludeCategory:android.intent.category.LAUNCHER

IncludeCategory:android.intent.category.MONKEY 

//種事件所占的比例。

//各數字分别表示:

[--pct-touch PERCENT]

[--pct-motion PERCENT]

[--pct-trackball PERCENT]

[--pct-syskeys PERCENT]

[--pct-nav PERCENT] 

[--pct-majornav PERCENT] 

[--pct-appswitch PERCENT]

[--pct-flip PERCENT]

[--pct-anyevent PERCENT] 

// Event percentages: 

//   0: 15.0% 

//   1: 10.0% 

//   2: 15.0% 

//   3: 25.0% 

//   4: 15.0% 

//   5: 2.0% 

//   6: 2.0% 

//   7: 1.0% 

//   8: 15.0% 

:Switch: 

//表示跳轉到com.example.android.apis裡面的ApiDemos這一個Activity裡。  

#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=com.example.android.apis/.ApiDemos;end 

//允許此Intent跳轉，

// Allowing start ofIntent { act=android.intent.action.MAIN

//cat=[android.intent.category.LAUNCHER]cmp=com.example.android.apis/.ApiDemos } in

//packagecom.example.android.apis 

//發送的一些動作，如點選按下，點選放開，移動。

:Sending Pointer ACTION_MOVE x=-4.0 y=2.0

:Sending Pointer ACTION_UP x=0.0 y=0.0

:Sending Pointer ACTION_DOWN x=207.0y=282.0

:Sending Pointer ACTION_UP x=189.0 y=289.0

079 :Sending Pointer ACTION_DOWN x=95.0y=259.0

080 :Sending Pointer ACTION_UP x=95.0y=259.0

081 :Sending Pointer ACTION_DOWN x=295.0y=223.0

082 :Sending Pointer ACTION_UP x=290.0y=213.0

083 :Sending Pointer ACTION_MOVE x=-5.0y=3.0

084 :Sending Pointer ACTION_MOVE x=0.0y=-5.0

//拒絕此跳轉，因為它是跳轉到非它自己的包的Activity，本測試中是指寫測試它程式所在的包，此跳轉是跳出本程式，進入到桌面。 

// Rejecting start ofIntent { act=android.intent.action.MAIN cat=[android.intent.category.HOME]

//cmp=com.android.launcher/.Launcher} in package com.android.launcher 

//繼續發送動作。 

:Sending Pointer ACTION_DOWN x=74.0 y=201.0

:Sending Pointer ACTION_UP x=74.0 y=201.0

:Sending Pointer ACTION_MOVE x=3.0 y=-2.0

Events injected: 100

//丢棄的，鍵＝0，指針＝0，軌迹球＝0，翻轉＝0。 

:Dropped: keys=0 pointers=0 trackballs=0flips=0

//網絡統計經過時間為4202ms，其中4202ms是用于在手機上的，0ms用于無線網絡上，沒

//有連接配接的時間為0ms。 

## Network stats: elapsed time=4202ms(4202ms mobile, 0ms wifi, 0ms not connected) 

//monkey測試完成。 

// Monkey finished