以這條Monkey指令為例:
#monkey -s 12 --throttle 450 -p com.android.cameraswitch --kill-process-after-error --ignore-timeouts --ignore-security-exceptions -v 10000
這條monkey指令是測試:在camera模塊中產生1萬次偽隨機操作(包括觸摸、按鍵、手勢等)。
下面簡單介紹下涉及到的各參數:
-s :
偽隨機數生成器的 seed 值。如果用相同的 seed 值再次運行 Monkey ,它將生成相同的事件序列。
--throttle :
在事件之間插入固定延遲。通過這個選項可以減緩 Monkey 的執行速度。如果不指定該選項, Monkey 將不會被延遲,事件將盡可能快地被產成。
-p:
如果用此參數指定了一個或幾個包,Monkey將只允許系統啟動這些包里的Activity。 如果你的應用程序還需要訪問其它包里的Activity(如選擇取一個聯系人),那些包也需要在此 同時指定。如果不指定任何包,Monkey將允許系統啟動全部包里的Activity。要指定多個 包,需要使用多個 -p選項,每個-p選項只能用於一個包。
--kill-process-after-error:
通常,當Monkey由於一個錯誤而停止時,出錯的應用程序將繼續處於運行狀態。當設置了此選項時,將會通知系 統停止發生錯誤的進程。注意,正常的(成功的)結束,並沒有停止啟動的進程,設備只是在結束事件之 后,簡單地保持在最后的狀態。
--ignore-timeouts:
通常,當應用程序發生任何超時錯誤(如“Application Not Responding”對 話框)時,Monkey將停止運行。如果設置此選項,Monkey將繼 續向系統發送事件,直到計數完成。
--ignore-security-exceptions:
通常,當應用程序發生許可錯誤(如啟動一個需要某些許可的Activity)時,Monkey將 停止運行。如果設置了此選項,Monkey將繼續向系統發送事件,直到計數完成。
-v:
命令行的每一個 -v 將增加反饋信息的級別。 Level 0( 缺省值 ) 除啟動提示、測試完成和最終結果之外,提供較少信息。 Level 1 提供較為詳細的測試信息,如逐個發送到 ActivITy 的事件。 Level 2 提供更加詳細的設置信息,如測試中被選中的或未被選中的 Activity 。下面的例子使用了"-v -v -v",表示輸出最詳盡的monkey log。
#adb shell monkey -p com.thunderst.radio --throttle 500 -s 600 -v -v -v 800000 >C:\long_radio_report.txt
Monkey測試簡介
Monkey測試是Android平台自動化測試的一種手段,通過Monkey程序模擬用戶觸摸屏幕、滑動Trackball、按鍵等操作來對設備上的程序進行壓力測試,檢測程序多久的時間會發生異常。
Monkey程序介紹
1) Monkey程序由Android系統自帶,使用Java語言寫成,在Android文件系統中的存放路徑是:/system/framework/monkey.jar;
2) Monkey.jar程序是由一個名為“monkey”的Shell腳本來啟動執行,shell腳本在Android文件系統中的存放路徑是:/system/bin/monkey;
這樣就可以通過在CMD窗口中執行: adb shell monkey {+命令參數}來進行Monkey測試了。
Monkey命令的簡單幫助
要獲取Monkey命令自帶的簡單幫助,在CMD中執行命令:
adb shell monkey –help
Monkey命令參數介紹
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個隨機事件。
要查看設備中所有的包,在CMD窗口中執行以下命令:
>adb shell #cd data #ls
2) 參數: -v
用於指定反饋信息級別(信息級別就是日志的詳細程度),總共分3個級別,分別對應的參數如下表所示:
- 日志級別 Level0
示例 adb shellmonkey -p com.htc.Weather –v 100
說明 缺省值,僅提供啟動提示、測試完成和最終結果等少量信息
- 日志級別 Level 1
示例 adb shellmonkey -p com.htc.Weather –v -v 100
說明 提供較為詳細的日志,包括每個發送到Activity的事件信息
- 日志級別 Level 2
示例 adb shellmonkey -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 <毫秒>
用於指定用戶操作(即事件)間的時延,單位是毫秒;
示例:adb shell monkey -p com.htc.Weather –throttle 3000 100
5) 參數: --ignore-crashes
用於指定當應用程序崩潰時(Force& Close錯誤),Monkey是否停止運行。如果使用此參數,即使應用程序崩潰,Monkey依然會發送事件,直到事件計數完成。
示例1:adb shellmonkey -p com.htc.Weather --ignore-crashes 1000
測試過程中即使Weather程序崩潰,Monkey依然會繼續發送事件直到事件數目達到1000為止;
示例2:adb shellmonkey -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%; Bottom of Form
五測試結果分析
1. Search “ANR” : 判斷是否有 ANR 問題。
2. 搜索 “Exception”:
下面的屬於monkey自己的問題。不用管。
:Sending Flip keyboardOpen=false
Got IOException performing flipjava.io.IOException: write failed: EINVAL (Invalid argument)
// Injection Failed
3. System hang : 查看跑完之后板子是hang掉。
4. CP assert: 查看板子是否有cp assert。
一. 初步分析方法:
Monkey測試出現錯誤后,一般的差錯步驟為以下幾步:
1、 找到是monkey里面的哪個地方出錯
2、 查看Monkey里面出錯前的一些事件動作,並手動執行該動作
3、 若以上步驟還不能找出,可以使用之前執行的monkey命令再執行一遍,注意seed值要一樣
一般的測試結果分析:
1、 ANR問題:在日志中搜索“ANR”
2、 崩潰問題:在日志中搜索“Exception”
二. 詳細分析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