shell, monkey, system, Android, 檔案系統Monkey, 示例, 簡介

一、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

  #cddata/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%；

開啟cmd命令列視窗

輸入：

adb shell ps | grep monkey

返回來的第一個數字，即是monkey的程序號

2.kill 命令結束程序繼續輸入:

adb shell kill [剛才查到的程序號]

同理結束其他程序，和其他應用也可用此法，屢試不爽

APK應用集合分為黑名單和白名單，黑名單是指系統將執行除了黑名單中以外的apk；白名單則是隻執行在白名單中的apk。

  黑名單的設定方法：

a.建立一個名稱為blacklist的txt文件，在檔案中輸入應用程式的包名，如mms應用，則在檔案中輸入com.android.mms；如果有多個應用程式不想被執行，則在檔案中新增多個包名，注意包名與包名之間均用回車鍵。

b.將blacklist.txt的檔案匯入到手機的/data目錄下，然後在執行monkey測試的時候使用--pkg-blacklist-file引數再加上blacklist檔案的儲存路徑，其他的引數設定則和測試單一apk沒有區別。

白名單的設定方法：

白名單的設定方法和黑名單的設定方法基本一致，只是在建立txt文件的時候，檔案的命令應為whitelist。在執行monkey的時候，只執行白名單中的應用。

執行單一apk：

monkey –p <options> -c <options> -s <seed> <限制語句> --throttle <milliseconds> -v 執行次數> C:\monkey_test.txt

執行apk集合：

monkey –pkg-blacklist-file /data/blacklist.txt -c <options> -s <seed> <限制語句> --throttle <milliseconds> -v 執行次數> C:\blacklist_test.txt //執行黑名單以外的應用

或

monkey –pkg-whitelist-file /data/whitelist.txt -c <options> -s <seed> <限制語句> --throttle <milliseconds> -v 執行次數 > C:\whitelist_test.txt //執行白名單的應用

五、設定不依賴USB

在執行monkey測試的時候，如果將monkey測試的日誌存放在手機的sdcard或者其他目錄下，在monkey測試命令的最後加上一個&符號，則可以再不連線USB的情況下繼續執行monkey。如：

monkey –p com.android.mms –s 100 --throttle 1000 –v –v –v 15000 > /mnt/sdcard/monkey_test.txt&

Nowdays, Android Monkey Test writing more information about your running test (you can specify more options for run your test).

Example of run with all provide options:

./adb.exe shell monkey -p your.package.name --pct-touch 1--pct-motion 2--pct-pinchzoom 3--pct-trackball 4--pct-rotation 5--pct-nav 6--pct-majornav 7--pct-syskeys 8--pct-appswitch 9--pct-flip 10--pct-anyevent 45--throttle 500-v 50

Monkey write something like this (added appropriate switcher):

// Event percentages://   0: 1.0%    (--pct-touch 1)         //   1: 2.0%    (--pct-motion 2)        //   2: 3.0%    (--pct-pinchzoom 3)     //   3: 4.0%    (--pct-trackball 4)     //   4: 5.0%    (--pct-rotation 5)      //   5: 6.0%    (--pct-nav 6)           //   6: 7.0%    (--pct-majornav 7)      //   7: 8.0%    (--pct-syskeys 8)       //   8: 9.0%    (--pct-appswitch 9)     //   9: 10.0%   (--pct-flip 10)         //   10: 45.0%  (--pct-anyevent 45)