Android Monkey 介紹與使用

描述

Monkey主要是用來做穩定性或是壓力測試，它可以執行在實體裝置或是模擬器上，藉由產生一系列的隨機事件(e.g., touch, click, gestures）來測試應用程序。

基本語法

adb shell monkey [options] <event-count>

[options] 為參數，<event-count>為事件數。

常用範例介紹

1.啟動monkey
直接執行 monkey, 發送event count 數量的事件：

adb shell monkey <event count>

2.停止monkey
2-1.搜尋 monkey 的 pid

adb shell ps | grep 'monkey'

2-2.kill monkey by pid

adb shell kill <Step 1.找到的 pid>

Note：ctrl + c無法停止 monkey

3.執行在 com.package.name 上, 發送 event count 數量的事件

adb shell monkey -p com.package.name <event count>

4.執行在 com.package.name 上, 發送 event count 數量的事件，顯示最詳細的訊息

adb shell monkey -v-v-v -p com.package.name <event count>

5.執行在 com.package.name 上, 發送 event count 數量的事件，每個事件等待1秒，顯示最詳細的訊息，事件隨機分配。

adb shell monkey -v-v-v -p com.package.name --throttle 1000 <event count>

6.執行在 com.package.name 上, 發送 event count 數量的事件，每個事件等待1秒，調整 touch 事件為50%，剩餘百分比隨機分配，顯示最詳細的訊息

adb shell monkey -v-v-v -p com.package.name --pct-touch 50 --throttle 1000 <event count>

7.執行在 com.package.name 上, 發送 event count 數量的事件，每個事件等待1秒，調整 touch 事件 50%，motion事件 25%，剩餘百分比隨機分配，顯示最詳細的訊息

adb shell monkey -v-v-v -p com.package.name --pct-touch 50 --pct-motion 25 --throttle 1000 <event count>

monkey 參數[options]介紹：

參數總共分4大類，為一般(General)類，事件(Events)類，限制(Constraints)類，除錯(Debugging)類。

一般類

-h : 幫助訊息

adb shell monkey -h
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

-v：顯示log訊息
越多 -v，顯示的訊息越多，最多可以有3個 -v

adb shell monkey -v-v-v 10
:Monkey: seed=0 count=10
:IncludeCategory: android.intent.category.LAUNCHER
:IncludeCategory: android.intent.category.MONKEY
// Event percentages:
//   0: 15.0%
//   1: 10.0%
//   2: 2.0%
//   3: 15.0%
//   4: -0.0%
//   5: 25.0%
//   6: 15.0%
//   7: 2.0%
//   8: 2.0%
//   9: 1.0%
//   10: 13.0%
:Switch: #Intent;action=android.intent.action.MAIN;category=android.intent.category.LAUNCHER;launchFlags=0x10200000;component=com.google.android.street/.Street;end
    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.google.android.street/.Street } in package com.google.android.street
:Sending Flip keyboardOpen=false
:Sending Touch (ACTION_DOWN): 0:(313.0,367.0)
:Sending Touch (ACTION_UP): 0:(313.19876,367.49512)
Events injected: 10
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=247ms (0ms mobile, 247ms wifi, 0ms not connected)
// Monkey finished

第2行 seed=0代表事件使用的隨機數，如果指定相同的隨機數，將會產生相同的事件。
count=10代表事件數量
第3~4行 :IncludeCategory: android.intent.category.LAUNCHER
:IncludeCategory: android.intent.category.MONKEY
代表 monkey 會去執行指定category的類別，預設是LAUNCHER or MONKEY
當在指令中使用 -c 參數時會顯示在這裡，若找不到指定的category會顯示以下訊息。

// Warning: no activities found for category android.intent.category.test
** No activities found to run, monkey aborted.

第5～16行：事件比例，對照如下

// Event percentages:
// 0: 15.0% (--pct-touch )
// 1: 10.0% (--pct-motion)
// 2: 2.0% (--pct-pinchzoom)
// 3: 15.0% (--pct-trackball)
// 4: -0.0% (--pct-rotation)
// 5: 25.0% (--pct-nav)
// 6: 15.0% (--pct-majornav)
// 7: 2.0% (--pct-syskeys)
// 8: 2.0% (--pct-appswitch)
// 9: 1.0% (--pct-flip)
// 10: 13.0%(--pct-anyevent)

第17～22行：monkey 切換訊息。其中包括 action，category，component的訊息。action 和category 請參考 android developer 參考。而 component 即為啟動的 package全名和 activity名稱。
第23行之後包含相關的測試訊息觸碰座標，旋轉螢幕等等。

事件類

-s：隨機數，指定相同的隨機數會有相同的事件產生。
–throttle：每個事件之間延遲的時間，以mill second 來計算，預設沒有延遲。
–pct-touch：觸碰事件，觸碰事件為按下–放開事件。
–pct-motion：運動事件，運動事件為按下事件加上一連串的隨機事件最後加上放開事件。
–pct-trackball：軌跡球事件，軌跡球事件為一個或多個亂數動作。
–pct-nav：基本導航事件，基本導航事件為裝置的上，下，左，右輸入。
–pct-majornav：主要導航事件，主要導航事件為引發圖形介面的動作(e.g.,返回鍵，或選單鍵)。
–pct-syskeys：系統事件，系統按鍵事件為home鍵，返回鍵，撥號鍵，音量鍵等等。
–pct-appswitch：activity啟動事件， activity啟動事件為影響monkey 最大化的平均切換同一個package內的所有activity 的機率。
–pct-anyevent：其他事件，包含以上沒有提到事件。

//執行在 com.example.mypackage 上, 發送 100 數量的事件，調整 touch 事件為10%，motion事件20%，軌跡球事件為 15%，剩餘百分比隨機分配，顯示最詳細的訊息
adb shell monkey -v-v-v -p com.example.mypackage -s 999 --pct-touch 10 --pct-motion 20 --pct-trackball 15 100

限制類

-p：指定 monkey 運作的 package，可以有一個到多個 package，monkey會啟動在該package內的activity，如果 app 需要存取其他的 package（e.g., 聯絡人)。也必須在此指定。預設是隨機啟動該裝置中任何一個package。

//執行在 com.example.mypackage 上, 發送 100 數量的事件，事件隨機分配，顯示最詳細的訊息
adb shell monkey -v-v-v -p com.example.mypackage 100

-c：指定 monkey 運作的 category，通常可用來指定 monkey 啟動的 activity，category 在AndroidManifest.xml 中設定(e.g.,預設為啟動Intent.CATEGORY_LAUNCHER or Intent.CATEGORY_MONKEY。

//執行在 com.example.mypackage 上, 限制 category 為 LAUNCHER 以及 MONKEY,發送 100 數量的事件，事件隨機分配，顯示最詳細的訊息
adb shell monkey -v-v-v -p com.example.mypackage -c android.intent.category.LAUNCHER -c android.intent.category.MONKEY 100

AndroidManifest.xml example

...
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.example.mypackage.MainActivity"
            android:label="@string/app_name"
            android:screenOrientation="portrait" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
...

第14行即為 category 指定的方式，因此 monkey 將會執行在com.example.mypakcage.MainActivity 。

除錯類

-hprof：在 monkey 執行事件的前後產生報告，報告大約有 5mb，路徑為data/misc。
–ignore-crashes：monkey 預設當測試發生 exception 或 crash 會立即停止，當設定該參數 monkey將不會停止。
–ignore-timeouts：monkey 預設當測試發生 ANR會立即停止，當設定該參數 monkey將不會停止。
–ignore-security-exceptions：monkey 預設當測試發生 permission error會立即停止，當設定該參數 monkey將不會停止。
–kill-process-after-error：monkey 預設當測試發生錯誤時不會停止啟動的程序，當設定該參數 monkey將會停止該程序。Note: 當 monkey 成功完成測試後，也不會停止該程序，只會保留在測試結束的最後一個階段。
–montion-native-crashes：監看並報告當測試發生native code 的錯誤。
–wait-dbg：停止執行中的 monkey直到有除錯器連接為止。
–dbg-no-events：設定後，monkey 進入activity 前不會產生事件，一般會和 -v , -p，-throttle 一起使用來監視 packages 之間的切換。

What you think is what you get

What you think is what you get

描述

基本語法

常用範例介紹

monkey 參數[options]介紹：

一般類

事件類

限制類

除錯類

把安裝在手機的 apk 複製到本地端

error LNK 2001 & error LNK 2019 錯誤解決紀錄

zgh149