1,簡介
Monkey是一個命令行工具,您可以在任何模擬器實例或設備上運行。它發送用戶事件的僞隨機流進系統,它作爲對正在開發的應用軟件壓力測試。
當Monkey程序在模擬器或設備運行的時候,如果用戶出發了比如點擊,觸摸,手勢或一些系統級別的事件的時候,它就會產生隨機脈衝,所以可以用Monkey用隨機重複的方法去負荷測試你開發的軟件.Monkey測試是一種爲了測試軟件的穩定性、健壯性的快速有效的方法。
2,準備(前提:安卓環境已經搭建完成)
首先要有被測對象:機器以及應用程序,機器可以是模擬器也可以是真機,需要獲得機器的root權限
1)查看設備號
cmd中 adb devices可以查看到有設備連接到PC端
PS:此處就遇到一個問題,如果有多個機器時怎麼明確對象?
選擇機器,只需要adb -s device名稱命令即可針對所選機器進行操作
2)查看要測試的應用程序包名
切換到data/data路徑,然後列出所有應用,標記所要跑的應用包名即可
3,基本命令格式
基本語法如下:
$ adb shell monkey [options]
如果不指定options,Monkey將以無反饋模式啓動,並把事件任意發送到安裝在目標環境中的全部包。
下面是一個更爲典型的命令行示例,它啓動指定的應用程序,並向其發送500個僞隨機事件:
$ adb shell monkey -p your.package.name -v 500
(其中程序包名稱可以在串口終端這句命令獲得:ls data/data 顯示所有程序包或者 >adb shell #cd data/data #ls)
發送500個隨機事件,相隔3秒
$ adb shell monkey -p your.package.name --throttle 3000 500
命令參數介紹
1) 參數: -p
參數-p用於約束限制,用此參數指定一個或多個包(Package,即App)。指定包之後,Monkey將只允許系統啓動指定的APP。如果不指定包,Monkey將允許系統啓動設備中的所有APP。
* 指定一個包: adb
shell monkey -p com.htc.Weather 100
說明:com.htc.Weather爲包名,100是事件計數(即讓Monkey程序模擬100次隨機用戶事件)。
* 指定多個包:adb
shell monkey -p com.htc.Weather –p com.htc.pdfreader -p com.htc.photo.widgets 100
* 不指定包:adb
shell monkey 100
說明:Monkey隨機啓動APP併發送100個隨機事件。
2) 參數: -v
用於指定反饋信息級別(信息級別就是日誌的詳細程度),總共分3個級別,分別對應的參數如下表所示:
*日誌級別 Level 0
示例 adb shell monkey -p com.htc.Weather –v 100
說明 缺省值,僅提供啓動提示、測試完成和最終結果等少量信息
*日誌級別 Level 1
示例 adb shell monkey -p com.htc.Weather –v -v 100
說明 提供較爲詳細的日誌,包括每個發送到Activity的事件信息
*日誌級別 Level 2
示例 adb shell monkey -p com.htc.Weather –v -v –v
100
說明 最詳細的日誌,包括了測試中選中/未選中的Activity信息
3)參數: -s
用於指定僞隨機數生成器的seed值,如果seed相同,則兩次Monkey測試所產生的事件序列也相同的。
* 示例:
Monkey測試1:adb shell
monkey -p com.htc.Weather –s 10 100
Monkey測試2:adb
shell monkey -p com.htc.Weather –s 10 100
兩次測試的效果是相同的,因爲模擬的用戶操作序列(每次操作按照一定的先後順序所組成的一系列操作,即一個序列)是一樣的。操作序列雖 然是隨機生成的,但是隻要我們指定了相同的Seed值,就可以保證兩次測試產生的隨機操作序列是完全相同的,所以這個操作序列僞隨機的。
4) 參數: --throttle <</span>毫秒>
用於指定用戶操作(即事件)間的時延,單位是毫秒;
* 示例:adb
shell monkey -p com.htc.Weather --throttle 3000 100
5) 參數: --ignore-crashes
用於指定當應用程序崩潰時(Force & Close錯誤),Monkey是否停止運行。如果使用此參數,即使應用程序崩潰,Monkey依然會發送事件,直到事件計數完成。
* 示例1:adb
shell monkey -p com.htc.Weather --ignore-crashes 1000
測試過程中即使Weather程序崩潰,Monkey依然會繼續發送事件直到事件數目達到1000爲止;
* 示例2:adb
shell monkey -p com.htc.Weather 1000
測試過程中,如果Weather程序崩潰,Monkey將會停止運行。
6) 參數: --ignore-timeouts
用於指定當應用程序發生ANR(Application No Responding)錯誤時,Monkey是否停止運行。如果使用此參數,即使應用程序發生ANR錯誤,Monkey依然會發送事件,直到事件計數完成。
7) 參數: --ignore-security-exceptions
用於指定當應用程序發生許可錯誤時(如證書許可,網絡許可等),Monkey是否停止運行。如果使用此參數,即使應用程序發生許可錯誤,Monkey依然會發送事件,直到事件計數完成。
8) 參數: --kill-process-after-error
用於指定當應用程序發生錯誤時,是否停止其運行。如果指定此參數,當應用程序發生錯誤時,應用程序停止運行並保持在當前狀態(注意:應用程序僅是靜止在發生錯誤時的狀態,系統並不會結束該應用程序的進程)。
9) 參數: --monitor-native-crashes
用於指定是否監視並報告應用程序發生崩潰的本地代碼。
10) 參數: --pct-{+事件類別} {+事件類別百分比}
用於指定每種類別事件的數目百分比(在Monkey事件序列中,該類事件數目佔總事件數目的百分比)
參數:
使用說明:
示例:
--pct-touch {+百分比}
調整觸摸事件的百分比(觸摸事件是一個down-up事件,它發生在屏幕上的某單一位置)
adb shell monkey -p com.htc.Weather --pct-touch 10 1000
--pct-motion {+百分比}
調整動作事件的百分比(動作事件由屏幕上某處的一個down事件、一系列的僞隨機事件和一個up事件組成)adb
shell monkey -p com.htc.Weather --pct-motion 20 1000
--pct-trackball {+百分比}
調整軌跡事件的百分比(軌跡事件由一個或幾個隨機的移動組成,有時還伴隨有點擊)
adb shell monkey -p com.htc.Weather --pct-trackball 30 1000
--pct-nav {+百分比}
調整“基本”導航事件的百分比(導航事件由來自方向輸入設備的up/down/left/right組成)
adb shell monkey -p com.htc.Weather --pct-nav 40 1000
--pct-majornav {+百分比}
調整“主要”導航事件的百分比(這些導航事件通常引發圖形界面中的動作,如:5-way鍵盤的中間按鍵、回退按鍵、菜單按鍵)
adb shell monkey -p com.htc.Weather --pct-majornav 50 1000
--pct-syskeys {+百分比}
調整“系統”按鍵事件的百分比(這些按鍵通常被保留,由系統使用,如Home、Back、Start
Call、End Call及音量控制鍵)
adb shell monkey -p com.htc.Weather --pct-syskeys 60 1000
--pct-appswitch {+百分比}
調整啓動Activity的百分比。在隨機間隔裏,Monkey將執行一個startActivity()調用,作爲最大程度覆蓋包中全部Activity的一種方法
adb shell monkey -p com.htc.Weather --pct-appswitch 70 1000
--pct-anyevent {+百分比}
調整其它類型事件的百分比。它包羅了所有其它類型的事件,如:按鍵、其它不常用的設備按鈕、等等
adb shell monkey -p com.htc.Weather --pct -anyevent 100 1000
指定多個類型事件的百分比:
adb shell monkey -p com.htc.Weather --pct-anyevent 50 --pct-appswitch 50 1000
注意:各事件類型的百分比總數要爲100%
4,舉例
adb -s U956 shell monkey -p xxxx --throttle 500 --pct-touch 30 --pct-motion 30 --pct-nav 0 --pct-trackball 0 --pct-majornav 20 --pct-appswitch 10 --pct-anyevent 10 -s 0227 --ignore-crashes --ignore- timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -v -v -v 250000> d:\monkeytest.log
這是將monkey的log導入D盤,以便查看分析。
附錄:
adb基本命令:
Category |
Command |
Description |
Comments |
Options |
-d |
僅僅通過USB接口來管理abd. |
如果不只是用USB接口來管理則返回錯誤. |
-e |
僅僅通過模擬器實例來管理adb. |
如果不是僅僅通過模擬器實例管理則返回錯誤. |
|
-s |
通過模擬器/設備的允許的命令號碼來發送命令來管理adb (比如: "emulator-5556"). |
如果沒有指定號碼,則會報錯. |
|
General |
devices |
查看所有連接模擬器/設備的設施的清單. |
查看 Querying for Emulator/Device Instances獲取更多相關信息. |
help |
查看adb所支持的所有命令。. |
|
|
version |
查看adb的版本序列號. |
|
|
Debug |
logcat [ |
將日誌數據輸出到屏幕上. |
|
bugreport |
查看bug的報告,如dumpsys ,dumpstate ,和logcat 信息。 |
|
|
jdwp |
查看指定的設施的可用的JDWP信息. |
可以用 forward jdwp:端口映射信息來連接指定的JDWP進程.例如: |
|
Data |
install |
安裝Android爲(可以模擬器/設施的數據文件.apk指定完整的路徑). |
|
pull |
將指定的文件從模擬器/設施的拷貝到電腦上. |
|
|
push |
將指定的文件從電腦上拷貝到模擬器/設備中. |
|
|
Ports and Networking |
forward |
用本地指定的端口通過socket方法遠程連接模擬器/設施 |
端口需要描述下列信息:
|
ppp [parm]... |
通過USB運行ppp:
需要提醒你的不能自動啓動PDP連接. |
|
|
Scripting |
get-serialno |
查看adb實例的序列號. |
查看 Querying for Emulator/Device Instances可以獲得更多信息. |
get-state |
查看模擬器/設施的當前狀態. |
||
wait-for-device |
如果設備不聯機就不讓執行,--也就是實例狀態是 device 時. |
你可以提前把命令轉載在adb的命令器中,在命令器中的命令在模擬器/設備連接之前是不會執行其它命令的. 示例如下: adb wait-for-device shell getprop 需要提醒的是這些命令在所有的系統啓動啓動起來之前是不會啓動adb的 所以在所有的系統啓動起來之前你也不能執行其它的命令. 比如:運用install 的時候就需要Android包,這些包只有系統完全啓動。例如: adb wait-for-device install .apk 上面的命令只有連接上了模擬器/設備連接上了adb服務纔會被執行,而在Android系統完全啓動前執行就會有錯誤發生. |
|
Server |
start-server |
選擇服務是否啓動adb服務進程. |
|
kill-server |
終止adb服務進程. |
|
|
Shell |
shell |
通過遠程shell命令來控制模擬器/設備實例. |
查看 獲取更多信息 for more information. |
shell [] |
連接模擬器/設施執行shell命令,執行完畢後退出遠程shell端l. |
monkey基本命令:
類別 |
選項 |
說明 |
常規 |
--help |
列出簡單的用法。 |
-v |
命令列的每一個 -v 將增加反饋信息的級別。 Level 0( 缺省值 ) 除啓動提示、測試完成和最終結果之外,提供較少信息。 Level 1 提供較爲詳細的測試信息,如逐個發送到 Activity的事件。 Level 2 提供更加詳細的設置信息,如測試中被選中的或未被選中的 Activity 。 一般,一個v就足夠了 |
|
事件 |
-s |
僞隨機數產生器的 seed 值。如果用相同的 seed 值再次運行 Monkey,它將生成相同的事件序列。 |
--throttle |
在事件之間插入固定延遲。通過這個選項可以減緩 Monkey 的執行速度。如果不指定該選項, Monkey 將不會被延遲,事件將儘可能快地被產成。 |
|
--pct-touch |
調整觸摸事件的百分比(觸摸事件是一個down-up事件,它發生在屏幕上的某單一位置)。 |
|
--pct-motion |
調整動作事件的百分比(動作事件由屏幕上某處的一個down事件、一系列的僞隨機事件和一個up事件組成)。 |
|
--pct-trackball |
調整軌跡事件的百分比(軌跡事件由一個或幾個隨機的移動組成,有時還伴隨有點擊)。 |
|
--pct-nav |
調整“基本”導航事件的百分比(導航事件由來自方向輸入裝置的up/down/left/right組成)。 |
|
--pct-majornav |
調整“主要”導航事件的百分比(這些導航事件通常引發圖形接口中的動作,如:5-way鍵盤的中間按鍵、回退按鍵、菜單按鍵) |
|
--pct-syskeys |
調整“系統”按鍵事件的百分比(這些按鍵通常被保留,由系統使用,如Home、Back、Start Call、End Call及音量控制鍵)。 |
|
--pct-appswitch |
調整啓動Activity的百分比。在隨機間隔裏,Monkey將執行一個startActivity()調用,作爲最大程度覆蓋包中全部Activity的一種方法。 |
|
--pct-anyevent |
調整其它類型事件的百分比。它包羅了所有其它類型的事件,如:按鍵、其它不常用的設備按鈕、等等。 |
|
約束限制 |
-p |
如果用此參數指定了一個或幾個包,Monkey將只允許系統啓動這些包裏的Activity。如果你的應用程序還需要訪問其它包裏的Activity(如選擇取一個連絡人),那些包也需要在此同時指定。如果不指定任何包,Monkey將允許系統啓動全部包裏的Activity。要指定多個包,需要使用多個 -p選項,每個-p選項只能用於一個包。 |
-c |
如果用此參數指定了一個或幾個類別,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,直到有調試器和它相連接。 |
logcat基本命令:
Option |
Description |
-b |
加載一個可使用的日誌緩衝區供查看,比如event 和radio . 默認值是main 。具體查看Viewing Alternative Log Buffers. |
-c |
清楚屏幕上的日誌. |
-d |
輸出日誌到屏幕上. |
-f |
指定輸出日誌信息的 ,默認是stdout . |
-g |
輸出指定的日誌緩衝區,輸出後退出. |
-n |
設置日誌的最大數目 .,默認值是4,需要和 -r 選項一起使用。 |
-r |
每 時輸出日誌,默認值爲16,需要和-f 選項一起使用. |
-s |
設置默認的過濾級別爲silent. |
-v |
設置日誌輸入格式,默認的是brief 格式,要知道更多的支持的格式,參看Controlling Log Output Format . |
優先級有下列集中,是按照從低到高順利排列的:
- V — Verbose (lowest priority)
- D — Debug
- I — Info
- W — Warning
- E — Error
- F — Fatal
- S — Silent (highest priority, on which nothing is ever printed)