Monkey入門

1,簡介     

Monkey是一個命令行工具,您可以在任何模擬器實例或設備上運行。它發送用戶事件的僞隨機流進系統,它作爲對正在開發的應用軟件壓力測試。

Monkey程序在模擬器或設備運行的時候,如果用戶出發了比如點擊,觸摸,手勢或一些系統級別的事件的時候,它就會產生隨機脈衝,所以可以用Monkey用隨機重複的方法去負荷測試你開發的軟件.Monkey測試是一種爲了測試軟件的穩定性、健壯性的快速有效的方法。

2,準備(前提:安卓環境已經搭建完成)

首先要有被測對象:機器以及應用程序,機器可以是模擬器也可以是真機,需要獲得機器的root權限

1)查看設備號

cmd中 adb devices可以查看到有設備連接到PC

霧山的學習筆記--Monkey入門

PS:此處就遇到一個問題,如果有多個機器時怎麼明確對象?

霧山的學習筆記--Monkey入門
選擇機器,只需要adb -s device名稱命令即可針對所選機器進行操作

2)查看要測試的應用程序包名

切換到data/data路徑,然後列出所有應用,標記所要跑的應用包名即可

霧山的學習筆記--Monkey入門

3,基本命令格式

基本語法如下:

  $ adb shell monkey [options]

  如果不指定optionsMonkey將以無反饋模式啓動,並把事件任意發送到安裝在目標環境中的全部包。

    下面是一個更爲典型的命令行示例,它啓動指定的應用程序,並向其發送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測試1adb shell monkey -p com.htc.Weather –s 10 100
Monkey測試2adb 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依然會發送事件,直到事件計數完成。

* 示例1adb shell monkey -p com.htc.Weather --ignore-crashes 1000
  測試過程中即使Weather程序崩潰,Monkey依然會繼續發送事件直到事件數目達到1000爲止;

* 示例2adb shell monkey -p com.htc.Weather 1000
  測試過程中,如果Weather程序崩潰,Monkey將會停止運行。


6) 參數:  --ignore-timeouts
用於指定當應用程序發生ANRApplication 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 +百分比}
調整“系統”按鍵事件的百分比(這些按鍵通常被保留,由系統使用,如HomeBackStart CallEnd 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進程.例如: 
adb forward tcp:8000 jdwp:472 
jdb -attach localhost:8000

Data

install 

安裝Android爲(可以模擬器/設施的數據文件.apk指定完整的路徑).

 

pull  

將指定的文件從模擬器/設施的拷貝到電腦上.

 

push  

將指定的文件從電腦上拷貝到模擬器/設備中.

 

Ports and Networking

forward  

用本地指定的端口通過socket方法遠程連接模擬器/設施

端口需要描述下列信息:

  • tcp:
  • local:
  • dev:
  • jdwp:

ppp  [parm]...

通過USB運行ppp

  •  — the tty for PPP stream. For exampledev:/dev/omap_csmi_ttyl.
  • [parm]... &mdash zero or more PPP/PPPD options, such asdefaultroute , local ,notty , etc.

需要提醒你的不能自動啓動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命令,執行完畢後退出遠程shelll.

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

調整系統按鍵事件的百分比(這些按鍵通常被保留,由系統使用,如HomeBackStart CallEnd Call及音量控制鍵)

--pct-appswitch

調整啓動Activity的百分比。在隨機間隔裏,Monkey將執行一個startActivity()調用,作爲最大程度覆蓋包中全部Activity的一種方法。

--pct-anyevent

調整其它類型事件的百分比。它包羅了所有其它類型的事件,如:按鍵、其它不常用的設備按鈕、等等。

約束限制

-p

如果用此參數指定了一個或幾個包,Monkey將只允許系統啓動這些包裏的Activity。如果你的應用程序還需要訪問其它包裏的Activity(如選擇取一個連絡人),那些包也需要在此同時指定。如果不指定任何包,Monkey將允許系統啓動全部包裏的Activity。要指定多個包,需要使用多個 -p選項,每個-p選項只能用於一個包。

-c

如果用此參數指定了一個或幾個類別,Monkey將只允許系統啓動被這些類別中的某個類別列出的Activity。如果不指定任何類別,Monkey將選擇下列類別中列出的ActivityIntent.CATEGORY_LAUNCHERIntent.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 .

優先級有下列集中,是按照從低到高順利排列的:

  1. V — Verbose (lowest priority)
  2. D — Debug
  3. I — Info
  4. W — Warning
  5. E — Error
  6. F — Fatal
  7. S — Silent (highest priority, on which nothing is ever printed) 
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章