AutoMonkey使用手册

autoMonkey框架原理

基础知识与测试场景

在Android的官方自动化测试领域有一只非常著名的“猴子”叫Monkey,这只“猴子”一旦启动,就会让被测的Android应用程序像猴子一样到处乱跑。我们常用这只“猴子”对被测程序进行压力测试,检查和评估被测程序的稳定性。

Android官方对这只“猴子”的描述:Monkey是Google提供的一个命令行工具,可运行在模拟器或实际设备中。它可以在规定的次数范围内做任何随机的操作,随机操作包括点击、滑动、Application切换、横竖屏、应用关闭等等,用户能做的操作都可以模拟,从而对正在运行的应用程序进行压力测试,目的是看设备多长时间会出现异常,并观察系统的稳定性和容错性能。

Monkey测试出crash的bug等级永远为1,版本发布前,Monkey跑出的结果中crash要为0。

业内标准:最终发布版本前,Monkey跑完的总次数不少于25W次,其结果里不允许有nullPointException出现。

Monkey程序是Android系统自带的,其启动脚本是位于Android系统的/system/bin目录的Monkey文件,其jar包是位于Android系统的/system/framework目录的Monkey. jar文件。用户主要是通过adb 命令来启动Monkey。Monkey在运行时,会根据命令行参数的配置,生成伪随机的事件流,并在Android设备上执行对应的测试事件。

按照选定的不同级别的反馈信息,在Monkey中还可以看到其执行过程报告和生成的事件。

AutoMonkey使用手册

弊端

  1. 无法准确地得知bug的复现步骤
  2. 发送的用户事件流的有效性成问题,很多是无效操作

测试目的

希望通过Monkey测试来模拟用户长时间的随机操作,检查被测APP是否会出现异常(应用崩溃、内存泄漏或者无响应)。

测试步骤

  1. 连接PC,命令  adb devices 查看连接设备

AutoMonkey使用手册

  1. 测试指定的APP包 adb shell pm list packages 列出所有的报名进行查找(所测包名如果可以通过开发人员获取则更为便捷)

AutoMonkey使用手册

  1. 对指定包进行测试命令 adb shell monkey -p <package.name>  [repeatnum]

AutoMonkey使用手册

Monkey命令基本参数

一个完整的Monkey命令:

adb shell monkey -p $package_name --hprof --pct-touch 40 --pct-motion 25 --pct-appswitch 10 --pct-rotation 10 --pct-majornav 10 -s 10000 --throttle 500 --ignore-crashes --ignore-timeouts -v -v -v 500000

常规类参数

  1. adb shell monkey –help 或者adb shell monkey

作用:列出简单的用法

AutoMonkey使用手册

  1. adb shell monkey –v

-v,除了启动、测试完成和最终结果外只提供较少的信息;

-v -v,提供了较为详细的测试信息,如逐个发送到Activity的事件信息;

-v –v -v,提供了更多的设置信息,如测试中选中或未选中的Activity信息;

注:比较常用的是-v -v -v,即最多详细信息,一般会保存到指定文件*开发人员查找bug原因时使用。

AutoMonkey使用手册

事件类参数

  1. adb shell monkey -s [seed值] -v 10

作用:伪随机数生成器的seed值。如果用相同的seed值再次运行monkey,将生成相同的事件序列

AutoMonkey使用手册

  1. adb shell monkey --throttle [延迟时间间隔] -v 10

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

注:常用参数,一般设置为300毫秒,原因是实际用户操作的最快300毫秒左右一个动作事件,所以此处一般设置为300毫秒。

AutoMonkey使用手册

  1. adb shell monkey --pct-touch [percent] -v 10

作用:调整触摸事件的百分比。(触摸事件是指在屏幕中的一个down-up事件,即在屏幕某处按下并抬起的操作)

注:常用参数,此参数设置要适应当前被测应用程序的操作,比如一个应用80%的操作都是触摸,那就可以将此参数的百分比设置成相应较高的百分比。

AutoMonkey使用手册

  1. adb shell monkey --pct-motion [percent] -v 10

作用:调整motion事件百分比。(motion事件是由屏幕上某处一个down事件、一系列伪随机的移动事件和一个up事件组成)

注:常用参数,需注意的是移动事件是直线滑动

AutoMonkey使用手册

  1. adb shell monkey --pct-trackball [percent] -v 10

作用:调整滚动球事件百分比(滚动球事件由一个或多个随机的移动事件组成,有时会伴随着点击事件)

注:不常使用参数,现在手机几乎没有滚动球,但滚动球事件中包含曲线滑动事件,在被测程序需要曲线滑动时可以选用此参数。

AutoMonkey使用手册

  1. adb shell monkey --pct-nav [percent] -v 10

作用:调整基本的导航事件百分比。(导航事件由方向输入设备的上下左右按键所触发的事件组成)

注:不常用操作。

AutoMonkey使用手册

  1. adb shell monkey --pct-majornav [percent] -v 10

作用:调整主要导航事件的百分比。(这些导航事件通常会导致UI界面中的动作事件,如5-way键盘的中间键,回退按键、菜单按键)

注:不常用操作。

AutoMonkey使用手册

  1. adb shell monkey --pct-syskeys [percent] -v 10

作用:调整系统事件百分比。(这些按键通常由系统保留使用,如HomeBackStart CallEnd Call、音量调节)

注:不常用。

AutoMonkey使用手册

  1. adb shell monkey --pct-appswitch [percent] -v 5

作用:调整Activity启动的百分比。(在随机的时间间隔中,Monkey将执行一个startActivity()调用,作为最大程度覆盖被测包中全部Activity的一种方法)

注:不常用。

AutoMonkey使用手册

  1. adb shell monkey --pct-anyevent [percent] -v 5

作用:调整其他事件的百分比。(这包含所有其他事件,如按键、其他在设备上不常用的按钮等)

注:不常用。

AutoMonkey使用手册

约束类参数

  1. adb shell monkey -p [allowed-package-name] -v 10

AutoMonkey使用手册

  1. adb shell monkey --ignore-crashes -p [allowed-package-name] -v 10

作用:通常应用发生崩溃或异常时Monkey会停止运行。如果设置此项,Monkey将继续发送事件给系统,直到事件计数完成。

 

AutoMonkey使用手册

  1. adb shell monkey --ignore-timeouts -p [allowed-package-name] -v 10

作用:通常应用程序发生任何超时错误(如“Application Not responding”对话框)Monkey将停止运行,设置此项,Monkey将继续发送事件给系统,直到事件计数完成。

AutoMonkey使用手册

  1. adb shell monkey --ignore-security-exception -p [allowed-package-name] -v 10

作用:通常当程序发生许可错误(例如启动一些需要许可的Activity)导致的异常时,Monkey将停止运行。设置此项,Monkey将继续发送事件给系统,直到事件计数完成。

AutoMonkey使用手册

  1. adb shell monkey --kill-process-after-error -p [allowed-package-name] -v 10

作用:通常当Monkey由于一个错误而停止时,出错的应用程序将继续处于运行状态。设置此项,将会通知系统停止发生错误的进程。注意,正常(成功)的结束,并没有停止启动的进程,设备只是在结束事件之后简单的保持在最后的状态。

AutoMonkey使用手册

  1. adb shell monkey --monitor-native-crashes -p [allowed-package-name] -v 10

作用:监视并报告Andorid系统中本地代码的崩溃事件。如果设置--kill-process-after-error,系统将停止运行。

AutoMonkey使用手册

  1. adb shell monkey --wait-dbg -p [allowed-package-name] -v 10

作用:停止执行中的Monkey,直到有调试器和它相连接。

AutoMonkey使用手册

数据类命令

  1. 获取内存信息:

adb shell dumpsys meminfo [package_name or pid]

AutoMonkey使用手册

  1. 记录logcat日志信息:

adb shell logcat -v time > logcat.txt

  1. 获取CPU信息:

adb shell top -n 1 |findstr [package_name or pid]

AutoMonkey使用手册

  1. 获取电量信息:

adb shell dumpsys battery

AutoMonkey使用手册

  1. 获取GPU信息:

adb shell dumpsys gfxinfo [package_name or pid]

AutoMonkey使用手册

注:要获取GPU信息,在“开发者选项”中打开“GPU呈现模式分析”,如下图所示:

AutoMonkey使用手册