Monkey是Android SDK自帶的測試工具,在實際應用中經常有公司用來做一些APP的穩定性測試,由于測試事件和數據都是隨機的,有一定的局限性。
一 monkey測試的相關的原理
monkey測試的原理就是利用socket通訊的方式來模擬用戶的按鍵輸入,觸摸屏輸入,手勢輸入等,看設備多長時間會出異常。當Monkey程序在模擬器或設備運行的時候,如果用戶出發了比如點擊,觸摸,手勢或一些系統級別的事件的時候,它就會產生隨機脈沖,所以可以用Monkey用隨機重復的方法去負荷測試你開發的軟件。
二、Monkey程序介紹
Monkey程序由Android系統自帶,使用Java語言寫成,在Android文件系統中的存放路徑是:/system/framework/monkey.jar;
Monkey.jar程序是由一個名為“monkey”的Shell腳本來啟動執行,shell腳本在Android文件系統中的存放路徑是:/system/bin/monkey;
可以通過在CMD窗口中執行: adb shell monkey {+命令參數}來進行Monkey測試。
注意前提條件是,你已經配置好Java和Android的環境變量。(配置步驟請百度,簡單的來說就是做好以下的配置)
配置Andriod環境變量前提是要先安裝好JAVA環境
打開計算機屬性——高級系統設置——環境變量
新建一個環境變量,變量名:ANDROID_HOME,變量值:D:\adt-bundle-windows-x86_64-20140702\sdk(以你安裝目錄為準,確認里面有tools和add-ons等多個文件夾),點擊確認。
新建一個環境變量,變量名:ANDROID_SDK_HOME,變量值:D:\adt-bundle-windows-x86_64-20140702\sdk(以你安裝目錄為準,確認里面有tools和add-ons等多個文件夾),點擊確認。
在系統變量PATH后面加上變量值:%ANDROID_SDK_HOME%\platform-tools;%ANDROID_SDK_HOME%\tools;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools;
Android SDK配置完成,接下來驗證配置是否成功。
問題來了,Monkey的命令參數是怎么設置的呢?(繼續往下看)
三、Monkey命令的簡單幫助
要獲取Monkey命令自帶的簡單幫助,在CMD中執行命令:
adb shell monkey –help
這樣子,就有他的各種各樣的提示命令的參數。
- 參數: -p
參數-p用于約束限制,用此參數指定一個或多個包(Package,即App)。指定包之后,Monkey將只允許系統啟動指定的APP。如果不指定包,Monkey將允許系統啟動設備中的所有APP。
- 指定一個包: adb shell monkey -p com.android.calculator2 100
說明:com.android.calculator2 為包名,100是事件計數(即讓Monkey程序模擬100次隨機用戶事件)。
cal - 指定多個包:adb shell monkey -p com.android.calculator2 –p com.android.canlendar 100 如圖所示:
cmd3 - 不指定包:adb shell monkey 100
說明:Monkey隨機啟動APP并發送100個隨機事件。 - 要查看設備中所有的包,在CMD窗口中執行以下命令:
adb shell
cd data/data
ls
注意:手機沒有root時不能用這個屬性,模擬器上可以。
- 參數: -v
用于指定反饋信息級別(信息級別就是日志的詳細程度),總共分3個級別,分別對應的參數如下表所示:
日志級別 Level 0
示例 adb shell monkey -p com.android.calculator2 –v 100
說明 缺省值,僅提供啟動提示、測試完成和最終結果等少量信息 相應源代碼如圖所示了,這十分有利于調試了。
cmd2
日志級別 Level 1
示例 adb shell monkey -p com.android.calculator2 –v -v 100
說明 提供較為詳細的日志,包括每個發送到Activity的事件信息
日志級別 Level 2
示例 adb shell monkey -p com.android.calculator2 –v -v –v 100
說明 最詳細的日志,包括了測試中選中/未選中的Activity信息
-s
用于指定偽隨機數生成器的seed值,如果seed相同,則兩次Monkey測試所產生的事件序列也相同的。
- 示例:
Monkey測試1:adb shell monkey -p com.android.calculator2 –s 10 100
Monkey 測試2:adb shell monkey -p com.android.calculator2 –s 10 100
兩次測試的效果是相同的,因為模擬的用戶操作序列(每次操作按照一定的先后順序所組成的一系列操作,即一個序列)是一樣的。操作序列雖 然是隨機生成的,但是只要我們指定了相同的Seed值,就可以保證兩次測試產生的隨機操作序列是完全相同的,所以這個操作序列偽隨機的;
四、Monkey測試的停止條件1、如果限定了Monkey運行在一個或幾個特定的包上,那么它會監測試圖轉到其它包的操作,并對其進行阻止。
2、如果應用程序崩潰或接收到任何失控異常,Monkey將停止并報錯。
3、如果應用程序產生了應用程序不響應-ANR(application not responding)的錯誤,Monkey將會停止并報錯。
monkey很好,很強大,能用好就是一個好工具。
官網參考:https://developer.android.com/studio/test/monkey.html
Monkey事件
-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
調整其它類型事件的百分比。它包羅了所有其它類型的事件,如:按鍵、其它不常用的
設備按鈕、等等
Monkey約束限制
-p
如果用此參數指定了一個或幾個包,Monkey 將只允許系統啟動這些包里的 Activity。 如
果你的應用程序還需要訪問其它包里的 Activity(如選擇取一個聯系人),那些包也需要在此
同時指定。如果不指定任何包, Monkey 將允許系統啟動全部包里的 Activity。要指定多個 包,需要使用多個 -p選項,每個-p選項只能用于一個包。
-c
如果用此參數指定了一個或幾個類別, Monkey 將只允許系統啟動被這些類別中的某個類
別列出的 Activity。 如果不指定任何類別,Monkey 將選 擇下列類別中列出的 Activity:
Intent.CATEGORY_LAUNCHER 或 Intent.CATEGORY_MONKEY。要指定多 個類別,需要使用多個-c 選項,每個-c 選 項只能用于一個類別。
Monkey調試
--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測試結果分析
一. 初步分析方法:
Monkey測試出現錯誤后,一般的差錯步驟為以下幾步:
1、 找到是monkey里面的哪個地方出錯
2、 查看Monkey里面出錯前的一些事件動作,并手動執行該動作
3、 若以上步驟還不能找出,可以使用之前執行的monkey命令再執行一遍,注意seed值要一樣
一般的測試結果分析:
1、 ANR問題:在日志中搜索“ANR”
2、 崩潰問題:在日志中搜索“Exception”
導出日志的命令
adb shell monkey -p com.android.calculator2 1000>C:\monkey.txt
這種方式不管你是連接真機還是虛擬機都可以看到日志啦。
二. 詳細分析monkey日志:
將執行Monkey生成的log,從手機中導出并打開查看該log;在log的最開始都會顯示Monkey執行的seed值、執行次數和測試的包名。
首先我們需要查看Monkey測試中是否出現了ANR或者異常,具體方法如上述。
然后我們要分析log中的具體信息,方法如下:
查看log中第一個Switch,主要是查看Monkey執行的是那一個Activity,譬如下面的log中,執行的是com.tencent.smtt.SplashActivity,在下一個swtich之間的,如果出現了崩潰或其他異常,可以在該Activity中查找問題的所在。
:Switch:#Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=com.tencent.smtt/.SplashActivity;end
// Allowing start of Intent {act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER]cmp=com.tencent.smtt/.SplashActivity } in package com.tencent.smtt
在下面的log中,Sending Pointer ACTION_DOWN和Sending Pointer ACTION_UP代表當前執行了一個單擊的操作;
Sleeping for 500 milliseconds這句log是執行Monkey測試時,throttle設定的間隔時間,每出現一次,就代表一個事件。
SendKey(ACTION_DOWN) //KEYCODE_DPAD_DOWN 代表當前執行了一個點擊下導航鍵的操作;
Sending Pointer ACTION_MOVE 代表當前執行了一個滑動界面的操作。
:Sending Pointer ACTION_DOWN x=47.0 y=438.0
:Sending Pointer ACTION_UP x=47.0 y=438.0
Sleeping for 500 milliseconds
:SendKey (ACTION_DOWN): 20 //KEYCODE_DPAD_DOWN
:SendKey (ACTION_UP): 20 //KEYCODE_DPAD_DOWN
Sleeping for 500 milliseconds
:Sending Pointer ACTION_MOVE x=-2.0 y=3.0
:Sending Pointer ACTION_MOVE x=4.0 y=-3.0
:Sending Pointer ACTION_MOVE x=-5.0 y=-3.0
:Sending Pointer ACTION_MOVE x=3.0 y=4.0
:Sending Pointer ACTION_MOVE x=-4.0 y=1.0
:Sending Pointer ACTION_MOVE x=-1.0 y=-1.0
:Sending Pointer ACTION_MOVE x=-2.0 y=-4.0
如果Monkey測試順利執行完成,在log的最后,會打印出當前執行事件的次數和所花費的時間;// Monkey finished代表執行完成。Monkey執行中斷,在log的最后也能查看到當前已執行的次數。Monkey執行完成的log具體如下:
Events injected: 6000
:Dropped: keys=0 pointers=9 trackballs=0 flips=0
Network stats: elapsed time=808384ms (0ms mobile, 808384ms wifi, 0msnot connected)
// Monkey finished