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