Monkey、Monkeyrunner之间的区别

Monkey、Monkeyrunner之间的区别

---

一.Monkey

Monkey是Android中的一个命令行工具，可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等)，实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件稳定性、健壮性的快速有效的方法。

Monkey介绍与安装

Monkey程序由Android系统自带，使用Java语言写成，在Android文件系统中的存放路径是：/system/framework/monkey.jar。Monkey.jar程序是由一个名为“monkey”的shell脚本来启动执行，shell脚本在Android文件系统中的存放路是：/system/bin/monkey；

这样就可以通过在 Shell 窗口中执行: adb shell monkey ｛+命令参数｝来进行Monkey测试了。
打开 Shell 窗口，输入adb shell ls /system/framework，可以查看到monkey.jar；同理，可查看monkey。

[root@BenLam-vm_0 ~]# adb connect 127.0.0.1
connected to 127.0.0.1:6666
[root@BenLam-vm_0 ~]# adb shell ls /system/framework
monkey.jar
monkey.odex

monkey 帮助详细：

[root@BenLam-vm_0 ~]# 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

Monkey 教程

Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包。下面是一个更为典型的命令行示例，它启动指定的应用程序，并向其发送 10 个伪随机事件：

[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name -v 10
:Monkey: seed=1551470463890 count=10
:AllowPackage: com.TestApp
: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.TestApp/.launcher.LauncherActivity;end
    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.TestApp/.launcher.LauncherActivity } in package com.TestApp
:Sending Trackball (ACTION_MOVE): 0:(1.0,3.0)Events injected: 10
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=54ms (0ms mobile, 0ms wifi, 54ms not connected)
// Monkey finished
[root@BenLam-vm_0 ~]# 

---

总结 Monkey 分为四大类—— 日志、事件选项、约束选项、调试选项

1. 日志

输出日志级别，也就是打印结果更详细的，演示：

[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name -v 10  # 日志Level：0
[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name -v -v 10  # 日志Level：1
[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name -v -v -v 10  # 输出更详细的日志

2. 事件选项解释

-s：指定产生随机事件种子值，相同的种子值产生相同的事件序列。如： -s 200
--throttle：每个事件结束后的间隔时间——降低系统的压力（如不指定，系统会尽快的发送事件序列）。如：--throttle 100
--pct-touch：指定触摸事件的百分比，如：--pct-touch 5% ， 相关的还有以下option：
--pct-motion <percent> （滑动事件）
--pct-trackball <percent> （轨迹球事件）
--pct-nav<percent> （导航事件 up/down/left/right）
--pct-majornav<percent> （主要导航事件 back key 、 menu key）
--pct-syskeys<percent> （系统按键事件 Home 、Back 、startCall 、 endCall 、 volumeControl）
--pct-appswitch<percent> （activity之间的切换）
--pct-anyevent<percent>（任意事件）

演示：

[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name –s 10 20 
Events injected: 20
## Network stats: elapsed time=68ms (0ms mobile, 0ms wifi, 68ms not connected)

在事件之间插入固定的时间（毫秒）延迟，你可以使用这个设置来减缓Monkey的运行速度，如果你不指定这个参数，则事件之间将没有延迟，事件将以最快的速度生成。演示：

[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name --throttle 300 -v 10 
:Monkey: seed=1551471341700 count=10
:AllowPackage: com.TestApp
: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.TestApp/.launcher.LauncherActivity;end
    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.TestApp/.launcher.LauncherActivity } in package com.TestApp
Events injected: 10
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=207ms (0ms mobile, 0ms wifi, 207ms not connected)
// Monkey finished

3. 约束选项

# -p：指定有效的package（如不指定，则对系统中所有package有效）
# -c：activity必须至少包含一个指定的category，才能被启动，否则启动不了。

[root@BenLam-vm_0 ~]# adb shell dumpsys activity | findstr  mFocusedActivity 即可找出 -p、-c的包名

4. 调试选项

--dbg-no-events：初始化启动的activity，但是不产生任何事件。
--hprof：指定该项后在事件序列发送前后会立即生成分析报告  —— 一般建议指定该项。
--ignore-crashes：忽略崩溃
--ignore-timeouts：忽略超时
--ignore-security-exceptions：忽略安全异常
--kill-process-after-error：发生错误后直接杀掉进程
--monitor-native-crashes：跟踪本地方法的崩溃问题
--wait-dbg：知道连接了调试器才执行monkey测试。

5. 实战与分析

通过以上几点让我们更了解 Monkey 自身的特性，那么他到底是来“搞笑”还是“救兵”。
实战：

[root@BenLam-vm_0 ~]# adb shell monkey -p your_app_name -v 10
:Monkey: seed=1551470463890 count=10
:AllowPackage: com.TestApp
: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.TestApp/.launcher.LauncherActivity;end
    // Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.TestApp/.launcher.LauncherActivity } in package com.TestApp
:Sending Trackball (ACTION_MOVE): 0:(1.0,3.0)Events injected: 10
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=54ms (0ms mobile, 0ms wifi, 54ms not connected)
// Monkey finished
[root@BenLam-vm_0 ~]# 

分析：

1）输出日志中需要查看 Monkey 测试中是否出现了 ANR 或者异常，在log的最开始都会显示 Monkey 执行的 seed 值、执行次数和测试的包名。
2）查看log中第一个Switch，主要是查看Monkey执行的是那一个 Activity，譬如下面的log中，执行的是launcher.LauncherActivity，在下一个swtich之间的，如果出现了崩溃或其他异常，可以在该Activity中查找问题的所在。
2）如果 Monkey 测试顺利执行完成，在log的最后，会打印出当前执行事件的次数和所花费的时间；
// Monkey finished代表执行完成。Monkey执行中断，在log的最后也能查看到当前已执行的次数。Monkey执行完成的log具体如下：
	Events injected: 10
	:Sending rotation degree=0, persist=false
	:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
	## Network stats: elapsed time=54ms (0ms mobile, 0ms wifi, 54ms not connected)
	// Monkey finished

二.Monkeyrunner

Monkeyrunner介绍

monkeyrunner即android SDK中自带的工具之一，此工具提供API可按制android设备或模拟器，提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。主要目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。

Monkeyrunner 与 Monkey 区别

Monkey 工具直接运行在设备或模拟器的adb shell中，生成用户或系统的伪随机事件流。
Monkeyrunner 工具是在工作站上通过API定义的特定命令和事件控制设备或模拟器。
可以理解 Monkeyrunner 更强大点

Monkeyrunner环境搭建

Monkeyrunner环境搭建比较繁琐，需要安装：Jdk + Android-sdk + Python
（这里就说如何安装了，毕竟大家都懂了~，tar解压，然后make编译配置环境变量即可）

[root@BenLam-vm_0 ~]# java -version
java version "1.8.0_161"
Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)

[root@BenLam-vm_0 ~]# python
Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:54:40) [MSC v.1900 64 bit (AMD64)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

[root@BenLam-vm_0 ~]# adb
Android Debug Bridge version 1.0.40
Version 4797878
Installed as /home/test/android-sdk/platform-tools/adb
''''''''''

[root@BenLam-vm_0 ~]# monkeyrunner
Jython 2.5.3 (2.5:c56500f08d34+, Aug 13 2012, 14:54:35)
[Java HotSpot(TM) 64-Bit Server VM (Oracle Corporation)] on java1.8.0_161
>>>

只要在终端成功运行 monkeyrunner 命令即可表示你已安装成功~

Monkeyrunner编译

以下代码另存为：demo.py

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage
device = MonkeyRunner.waitForConnection()    # 连接手机设备
device.removePackage("your_app_name")    # 卸载 App
MonkeyRunner.sleep(5)    # 暂停5秒
device.installPackage("Test.apk")    # 安装 App
print ('Install Success!')

通过命令编译：

[root@BenLam-vm_0 ~]# monkeyrunner demo.py
Install Success!

# 检查你的设备是否已安装指定的测试APP