1. 程式人生 > >monkey命令引數的詳解

monkey命令引數的詳解

簡要步驟:adb devices---瞭解包名--adb shell monkey -p 包名 -v 執行次數(多個引數的組合形成不同的用例以求最大的覆蓋)--當崩潰或無響應時分析monkey日誌

常規monkey命令(可直接在專案裡使用):

adb shell monkey -p com.jiochat.jiochatapp --throttle 100 --ignore-crashes --ignore-timeouts --ignore-security-exceptions --ignore-native-crashes --monitor-native-crashes -v -v -v 1000000>d:\b.log

重現bug:monkey日誌搜尋關鍵詞ANR exception,將之前的事件重新操作,尤其是seed值要一模一樣,如monkey -p 包名 -v seed 0 500

日誌分析:檢視是否有crash等關鍵字,找上下文,進行簡單分析將你所能定位的錯誤資訊發給開發。

一、Monkey 簡介

Monkey 就是SDK中附帶的一個工具。Monkey是Android中的一個命令列工具,可以執行在模擬器裡或實際裝置中。它向系統傳送偽隨機的使用者事件流(如按鍵輸入、觸控式螢幕輸入、手勢輸入等),實現對正在開發的應用程式進行壓力測試。Monkey測試是一種為了測試軟體的穩定性、健壯性的快速有效的方法。

該工具用於進行壓力測試。然後開發人員結合monkey 列印的日誌和系統列印的日誌,分析測試中的問題

Monkey 測試的特點:

Monkey 測試,所有的事件都是隨機產生的,不帶任何人的主觀性。

1、測試的物件僅為應用程式包,有一定的侷限性。

2、Monky測試使用的事件資料流是隨機的,不能進行自定義。

3、可對MonkeyTest的物件,事件數量,型別,頻率等進行設定。

二、Monkey的基本用法

基本語法如下:

$ adb shell monkey [options]

如果不指定options,Monkey將以無反饋模式啟動,並把事件任意傳送到安裝在目標環境中的全部包。下面是一個更為典型的命令列示例,它啟動指定的應用程式,並向其傳送500個偽隨機事件:

$ adb shell monkey -p your.package.name -v 500
使用android自動化測試工具monkeyrunner啟動應用時,需要填寫被測程式的包名和啟動的Activity,以下有兩種檢視應用包名package和入口activity名稱的方法:

方法一:使用aapt    //aapt是sdk自帶的一個工具,在sdk\builds-tools\目錄下

1.以ES檔案瀏覽器為例,命令列中切換到aapt.exe目錄執行:aapt dump badging E:\apk\es3.apk

2.

注:在android sdk目錄搜尋可以找到aapt.exe,如果沒有可以下載apktool。

 

三、Monkey測試的一個例項

通過這個例項,我們能理解Monkey測試的步驟以及如何知道哪些應用程式能夠用Monkey進行測試。

Windows下(注:2—4步是為了檢視我們可以測試哪些應用程式包,可省略):

1、通過eclipse啟動一個Android的emulator

2、在命令列中輸入:adb devices檢視裝置連線情況

C:\Documents and Settings\Administrator>adb devices

List of devices attached

emulator-5554   device

3、在有裝置連線的前提下,在命令列中輸入:adb shell 進入shell介面

C:\Documents and Settings\Administrator>adb shell

#

4、檢視data/data資料夾下的應用程式包。注:我們能測試的應用程式包都在這個目錄下面

C:\Documents and Settings\Administrator>adb shell

# ls data/data

ls data/data

5、以com.android.calculator2作為物件進行MonkeyTest

#monkey -p com.android.calculator2 -v 500

其中-p表示物件包 –v 表示反饋資訊級別

執行過程中,Emulator中的應用程式在不斷地切換畫面。

按照選定的不同級別的反饋資訊,在Monkey中還可以看到其執行過程報告和生成的事件。 

四、使用monkey help 命令檢視命令引數

C:\Users\chenfenping>adb shell monkey -help
usage: monkey [-p ALLOWED_PACKAGE [-p ALLOWED_PACKAGE] ...]
[-c MAIN_CATEGORY [-c MAIN_CATEGORY] ...]
[--ignore-crashes] [--ignore-timeouts]
[--ignore-security-exceptions]
[--monitor-native-crashes] [--ignore-native-crashes]
[--kill-process-after-error] [--hprof]
[--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] [--pct-pinchzoom PERCENT]
[--pkg-blacklist-file PACKAGE_BLACKLIST_FILE]
[--pkg-whitelist-file PACKAGE_WHITELIST_FILE]
[--wait-dbg] [--dbg-no-events]
[--setup scriptfile] [-f scriptfile [-f scriptfile] ...]
[--port port]
[-s SEED] [-v [-v] ...]
[--throttle MILLISEC] [--randomize-throttle]
[--profile-wait MILLISEC]
[--device-sleep-time MILLISEC]
[--randomize-script]
[--script-log]
[--bugreport]
[--periodic-bugreport]
COUNT

1 引數: -p

用於約束限制,用此引數指定一個或多個包(Package,即App)。指定包之後,monkey將只允許系統啟動指定的APP,如果不指定包,將允許系統啟動裝置中的所有APP.

* 指定一個包: adb shell monkey -p cn.emoney.acg 10

* 指定多個包:adb shell monkey -p cn.emoney.acg –p cn.emoney.wea -p cn.emoney.acg 100

* 不指定包:adb shell monkey 100

2 引數: -v

用於指定反饋資訊級別(資訊級別就是日誌的詳細程度),總共分3個級別,分別對應的引數如下表所示:

日誌級別 Level0

示例 adb shell monkey -p cn.emoney.acg –v 100

說明預設值,僅提供啟動提示、測試完成和最終結果等少量資訊

日誌級別 Level 1

示例 adb shell monkey -p cn.emoney.acg –v -v 100

說明提供較為詳細的日誌,包括每個傳送到Activity的事件資訊

日誌級別 Level 2

示例 adb shell monkey -p cn.emoney.acg –v -v –v 100

說明最詳細的日誌,包括了測試中選中/未選中的Activity資訊

3 引數: -s

用於指定偽隨機數生成器的seed值,如果seed相同,則兩次Monkey測試所產生的事件序列也相同的。

Monkey 測試1:adb shell monkey -p cn.emoney.acg -s 10  100

Monkey 測試2:adb shell monkey -p cn.emoney.acg –s 10 100

兩次測試的效果是相同的,因為模擬的使用者操作序列(每次操作按照一定的先後順序所組成的一系列操作,即一個序列)是一樣的。


4 引數: --throttle<毫秒>

用於指定使用者操作(即事件)間的時延,單位是毫秒;

adb shell monkey -p cn.emoney.acg --throttle 5000 100

5 引數: --ignore-crashes

用於指定當應用程式崩潰時(Force& Close錯誤),Monkey是否停止執行。如果使用此引數,即使應用程式崩潰,Monkey依然會發送事件,直到事件計數完成。

adb shellmonkey -p cn.emoney.acg --ignore-crashes 1000

測試過程中即使程式崩潰,Monkey依然會繼續傳送事件直到事件數目達到1000為止

adb shellmonkey -p cn.emoney.acg 1000

測試過程中,如果acg程式崩潰,Monkey將會停止執行

6 引數: --ignore-timeouts

用於指定當應用程式發生ANR(Application No Responding)錯誤時,Monkey是否停止執行。如果使用此引數,即使應用程式發生ANR錯誤,Monkey依然會發送事件,直到事件計數完成。

adb shellmonkey -p cn.emoney.acg --ignore-timeouts 1000

7 引數: --ignore-security-exceptions

用於指定當應用程式發生許可錯誤時(如證書許可,網路許可等),Monkey是否停止執行。如果使用此引數,即使應用程式發生許可錯誤,Monkey依然會發送事件,直到事件計數完成。

adb shellmonkey -p cn.emoney.acg --ignore-security-exception 1000


8 引數: --kill-process-after-error


用於指定當應用程式發生錯誤時,是否停止其執行。如果指定此引數,當應用程式發生錯誤時,應用程式停止執行並保持在當前狀態

(注意:應用程式僅是靜止在發生錯誤時的狀態,系統並不會結束該應用程式的程序)。

adb shellmonkey -p cn.emoney.acg --kill-process-after-error 1000


9 引數: --monitor-native-crashes

用於指定是否監視並報告應用程式發生崩潰的原生代碼。

adb shellmonkey -p cn.emoney.acg --monitor-native-crashes 1000

10 引數: --pct-{+事件類別}{+事件類別百分比}

用於指定每種類別事件的數目百分比(在Monkey事件序列中,該類事件數目佔總事件數目的百分比)
示例:
--pct-touch{+百分比}
調整觸控事件的百分比(觸控事件是一個down-up事件,它發生在螢幕上的某單一位置)

adb shell monkey -p cn.emoney.acg --pct-touch 10 1000


--pct-motion {+百分比}
調整動作事件的百分比(動作事件由螢幕上某處的一個down事件、一系列的偽隨件機事和一個up事件組成)

adb shell monkey -p cn.emoney.acg --pct-motion 20 1000


--pct-trackball {+百分比}
調整軌跡事件的百分比(軌跡事件由一個或幾個隨機的移動組成,有時還伴隨有點選)

adb shell monkey -p cn.emoney.acg --pct-trackball 30 1000


--pct-nav {+百分比}

調整“基本”導航事件的百分比(導航事件由來自方向輸入裝置的up/down/left/right組成)

adb shell monkey -p cn.emoney.acg --pct-nav 40 1000


--pct-majornav {+百分比}
調整“主要”導航事件的百分比(這些導航事件通常引發圖形介面中的動作,如:5-way鍵盤的中間按鍵、回退按鍵、選單按鍵)

adb shell monkey -p cn.emoney.acg --pct-majornav 50 1000

七、輸出monkeylog

跑monkey的時候或者想抓程式log匯出時,有時會提示:cannot create D:monkeytest.txt: read-only file system

為什麼有時候可以有時候不可以?

後來發現跟使用使用習慣不一樣,一會是先進入adb shell 再用命令,一會是直接命令進入。

進入adb shell後再用命令就會失敗~

正確方法:退出shell或者執行命令時先不要進shell

C:\Documents and Settings\Administrator>adb shell monkey -p 包名

 -v 300  >e:\text.txt

進入adb shell後就相當於進入linux的root下面,沒有許可權在裡面建立檔案~

五、Monkey測試結果分析

一. 初步分析方法:

Monkey測試出現錯誤後,一般的查錯步驟為以下幾步:

1、找到是monkey裡面的哪個地方出錯

2、檢視Monkey裡面出錯前的一些事件動作,並手動執行該動作

3、若以上步驟還不能找出,可以使用之前執行的monkey命令再執行一遍,注意seed值要一樣--復現

一般的測試結果分析:

1、 ANR問題:在日誌中搜索“ANR”

2、崩潰問題:在日誌中搜索“Exception”  Force Close

二. 詳細分析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_MOVE x=-2.0 y=-4.0
ANR
如果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

範例:

Monkey測試結果:

# monkey -p wfh.LessonTable -v -v -v 200

:Monkey: seed=0 count=200

:AllowPackage: wfh.LessonTable

:IncludeCategory: android.intent.category.LAUNCHER

:IncludeCategory: android.intent.category.MONKEY

// Selecting main activities from category android.intent.category.LAUNCHER

//   - NOT USING main activity com.android.browser.BrowserActivity (from package com.android.browser)

// Seeded: 0

// 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: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10000000;component=wfh.LessonTable/.MainTable;end

    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=wfh.LessonTable/.MainTable } in package wfh.LessonTable

Sleeping for 0 milliseconds

:SendKey (ACTION_DOWN): 21    // KEYCODE_DPAD_LEFT

:SendKey (ACTION_UP): 21    // KEYCODE_DPAD_LEFT

Sleeping for 0 milliseconds  //------------------------------------用--throttle來設定一個起效的事件發生後時延時。

:Sending Pointer ACTION_DOWN x=0.0 y=0.0

:Sending Pointer ACTION_UP x=0.0 y=0.0

Sleeping for 0 milliseconds

:Sending Pointer ACTION_MOVE x=0.0 y=0.0

當測試到ACTION_MOVE x=0.0 y=0.0這個動作時,發生了FC(Force Close)錯誤,以下為輸出錯誤資訊。同時在LogCat裡面也有錯誤輸出,而且LogCat裡面的錯誤資訊更為詳細,在實際的測試中應該結合兩者輸出的資訊進行除錯程式。

// CRASH: wfh.LessonTable (pid 1973)

// Short Msg: java.lang.NullPointerException

// Long Msg: java.lang.NullPointerException

// Build Label: android:generic/sdk/generic/:2.1-update1/ECLAIR/35983:eng/test-keys

// Build Changelist: 35983

// Build Time: 1273161972

// ID:

// Tag: AndroidRuntime

// java.lang.NullPointerException:

//   at android.widget.TabHost.dispatchKeyEvent(TabHost.java:279)

//   at android.view.ViewGroup.dispatchKeyEvent(ViewGroup.java:748)

** Monkey aborted due to error.

Events injected: 190

:Dropped: keys=0 pointers=11 trackballs=0 flips=0

## Network stats: elapsed time=27954ms (27954ms mobile, 0ms wifi, 0ms not connected)

** System appears to have crashed at event 190 of 200 using seed 0

#

開始monkey測試時android的LogCat輸出的資訊:

11-01 08:52:53.712: DEBUG/AndroidRuntime(2077): >>>>>>>>>>>>>> AndroidRuntime START <<<<<<<<<<<<<<

11-01 08:52:53.742: DEBUG/AndroidRuntime(2077): CheckJNI is ON

11-01 08:52:54.453: DEBUG/AndroidRuntime(2077): ---

以下為LogCat輸出的錯誤資訊,在以下的資訊中首先從自己的包中找錯誤,如果沒有自己的包的話就再找發生錯誤的包的第一個發生了異常。由錯誤提示可以看出很大的可能是因為TabHost引發的異常。經過檢視程式碼發現是由於TabHost的編寫不規範,TabHost與其中一個view放在了一起,在monkey測試做滾球上下滾動時當滾到TabHost時就發生了異常了。所以把TabHost與Activity分開寫就不會出現些問題了。

11-01 08:53:27.113: ERROR/AndroidRuntime(1973): Uncaught handler: thread main exiting due to uncaught exception

11-01 08:53:27.133: ERROR/AndroidRuntime(1973): java.lang.NullPointerException

11-01 08:53:27.133: ERROR/AndroidRuntime(1973):     at android.widget.TabHost.dispatchKeyEvent(TabHost.java:279)

11-01 08:53:27.133: ERROR/AndroidRuntime(1973):     at android.view.ViewGroup.dispatchKeyEvent(ViewGroup.java:748)

四、總結:

在monkey測試中常用的命令組合有:

1、monkey -p com.yourpackage -v 500//簡單的輸出測試的資訊。

2、monkey -p com.yourpackage -v -v  500 //以深度為二級輸出測試資訊。

4、monkey -p com.yourpackage -s 數字 -v 500//為隨機數的事件序列定一個值,若出現問題下次可以重複同樣的系列進行排錯。

5、monkey -p com.yourpackage -v --throttle 3000 500//為每一次執行一次有效的事件後休眠3000毫秒。