Monkey Test 命令使用

1.  命令使用

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還能夠執行腳本：官網上沒有詳細介紹，在網絡上有簡單介紹

http://groups.google.com/group/android-developers/browse_thread/thread/44522b92a6796d3

http://programfeelings.blogspot.com/2010/04/monkey-script-test.html

通常此命令用的不多。

簡而言之，Helen_Fu的方法可做爲通常測試的經常使用方法。

Focus AP：

$ adb shell monkey  -p your.package.name -v 45001--throttle 1000

adb shell monkey -p com.risingsun.ktool  -v 45001   --throttle 10 -s 100  

Full Monkey Test：

$ adb shell monkey   -v 90001--throttle 1000

 

可是對於時間的測試方法，我以爲不是很合理例如：

$ adb shell monkey   -v 90001--throttle 1000

1000：事件產生的時間間隔。

90001：產生事件的數量。

共90001個事件，每一個事件發生後休息一秒，再產生下一事件，至關於測試時間= 1000 × 90001ms=90001s

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

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

 

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

2.  Debug分析

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

推薦：http://www.cnblogs.com/wfh1988/archive/2010/11/16/1878224.html

 

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

:Sending Pointer ACTION_UP x=0.0 y=0.0

:Sending Pointer ACTION_MOVE x=-4.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