一、monkey简介
在Android的官方自动化测试领域有一只非常著名的“猴子”叫Monkey，这只“猴子”一旦启动，就会让被测的Android应用程序像猴子一样活蹦乱跳，到处乱跑。人们常用这只“猴子”来对被测程序进行压力测试，检查和评估被测程序的稳定性。
monkey官方文档：http://www.android-doc.com/tools/help/monkey.html
Moneky 路径
Monkey程序是Android系统自带的，其启动脚本是位于Android系统的/system/bin目录的Monkey文件，其jar包是位于Android系统的/system/framework目录的Monkey.jar文件。用户主要是通过adb命令来启动Monkey的，Monkey在运行时，会根据命令行参数的配置，生成伪随机的事件流，并在Android设备上执行对应的测试事件。同时，Monkey还会对测试系统进行监测，当出现以下三种情况时会进行特殊处理：
- 如限定了Monkey运行在特定包上，当监测到试图转到其他包的操作，将对其进行阻止。
- 如应用程序崩溃或接收到任何失控异常，Monkey将记录对应的错误日志，并根据命令行参数判断是停止运行还是继续运行。
- 如果应用程序发生了程序无响应（application not responding）的错误，Monkey将记录对应的错误日志，并根据命令行参数判断是停止运行还是继续运行。
- 按照选定的不同级别的反馈信息，在Monkey中还可以看到其执行过程报告和生成的事件。
Monkey启动步骤
- 连接移动设备
- 连接成功后输入命令
adb shell
- 进入到指定目录
cd /system/bin
4.输入 monkey命令看到如下提示则说明启动成功。
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
- adb shell ps 查看全部在运行的进程
- 查找出com.android.commands.monkey 进程PID
- adb shell kill pid 杀掉monkey进程
monkey 命令
monkey命令格式如下：
$ adb shell monkey [options] <event-count>
- [options] 是指monkey可传入的参数，是可选项（如果不指定options，Monkey将以无反馈模式启动，并把事件任意发送到安装在目标环境中的全部包）
- <event-count> 是指随机发送事件数。如：输入100就是执行100个伪随机事件，为必选项。
二、monkey事件
操作事件简介
Monkey所执行的随机事件流中包含11大事件，分别是触摸事件、手势事件、二指缩放事件、轨迹事件、屏幕旋转事件、基本导航事件、主要导航事件、系统按键事件、启动Activity事件、键盘事件、其他类型事件。Monkey通过这11大事件来模拟用户的常规操作，对手机App进行稳定性测试。下面让我们来详细了解这11大事件。
1.触摸事件
触摸事件是指在屏幕某处按下并抬起的操作，可通过--pct-touch参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到。 该事件由一组Touch（ACTION_DOWN）和Touch（ACTION_UP）事件组成，在手机上看到实际操作类似于点击。
2.手势事件
手势事件是指在屏幕某处的按下、随机移动、抬起的操作，即直线滑动操作。可通过--pct-motion参数来配置其事件百分比。
该事件是由一个ACTION_DOWN事件、一系列ACTION_MOVE事件和一个ACTION_UP事件组成的，在手机上看到的实际操作是一个没有拐弯的直线滑动操作。
3.二指缩放事件
二指缩放事件是指在屏幕上的两处同时按下，并同时移动，最后同时抬起的操作，即智能机上的放大缩小手势操作。可通过--pct-pinchzoom参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：
该事件起始是一个ACTION_DOWN事件和一个ACTION_POINTER_DOWN事件，即模拟两个手指同时点下；中间是一系列的ACTION_MOVE事件，即两个手指同时在屏幕上直线滑动；结束是由一个ACTION_POINTER_UP事件和一个ACTION_UP事件组成的，即两个手指同时放开。
4.轨迹事件
轨迹事件是由一个或多个随机的移动组成的，有时会伴随着点击。很早之前的Android手机带有轨迹球，这个事件就是模拟的轨迹球的操作。现在的手机几乎都没有轨迹球，但轨迹球事件中包含曲线滑动操作，如果被测程序需要曲线滑动时可以选用此参数。可通过--pct-trackball参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：
该事件是由一系列的Trackball（ACTION_MOVE）事件组成的，观察手机上的操作，即为一系列的曲线滑动操作。
5.屏幕旋转事件
屏幕旋转事件是一个隐藏事件，在Android官方文档中并没有记录这个事件。它其实是模拟的Android手机的横屏和竖屏切换。可通过--pct-rotation参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件由一个rotation事件组成，其中degree表示的是旋转方向，顺时针旋转，0表示旋转90度的方向，1表示旋转180度的方向，2表示旋转270度的方向，3表示旋转360度的方向。在执行过程中，可以看到手机屏幕在横竖屏之间不断地切换。
6.基本导航事件
基本导航事件是指点击方向输入设备的上、下、左、右按键的操作，现在手机上很少有上、下、左、右按键，这种事件一般用得比较少。可通过--pct-nav参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到：
该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的就是上、下、左、右四个方向按键。
7.主要导航事件
主要导航事件是指点击“主要导航”按键的操作，这些按键通常会导致UI界面中的动作，如键盘的中间键、回退按键、菜单按键。可通过--pct-majornav参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的按键就是中间键和菜单键。
8.系统按键事件
系统按键事件是指点击系统保留使用的按键的操作，如点击Home键、返回键、音量调节键等。可通过--pct-syskeys参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的就是上面说到的几个系统按键。
9.启动Activity事件
启动Activity事件是指在手机上启动一个Activity的操作。在随机的时间间隔中，Monkey将执行一个startActivity（）方法，作为最大限度上覆盖被测包中全部Activity的一种方法。可通过--pct-appswitch参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Switch操作组成的，从手机上看，上面的操作实际是打开了com.android.settings这个应用的一个com.android.settings.Settings的Activity界面。
10.键盘事件
键盘事件主要是一些与键盘相关的操作。比如点击输入框、键盘弹起、点击输入框以外区域、键盘收回等。可通过--pct-flip参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 如日志所示，这里主要是键盘的打开和关闭操作。
11.其他类型事件
其他类型事件包括了除前面提到的10种事件外其他所有的事件，如按键、其他不常用的设备上的按钮等。可通过--pct-anyevent参数来配置其事件百分比。从Monkey执行该事件对外输出的日志可以看到： [代码] 该事件是由一个Key（ACTION_DOWN）和一个Key（ACTION_UP）组成的，点击的按键就是其他的一些系统按键，如字母按键、数字按键等。因为现在手机很少带字母按键或数字按键，所以这个事件一般使用得比较少。
三、monkey参数
monkey 参数
参数分类
- 常规类参数
- 事件类参数
- 约束类参数
- 调试类参数
常规类参数
常规类参数包括帮助参数和日志信息参数。帮助参数用于输出Monkey命令使用指导；日志信息参数将日志分为三个级别，级别越高，日志的信息越详细。
1.帮助类参数
monkey -h
2.日志级别
$ adb shell monkey -v <event-count>
-v：打印出日志信息，每个-v将增加反馈信息的级别。-v越多日志信息越详细，不过目前最多支持3个-v，即：
事件类参数
事件类参数的作用是对随机事件进行调控，从而使其遵照设定运行，如设置各种事件的百分比、设置事件生成所使用的种子值等。频率参数主要限制事件执行的时间间隔。
1.执行指定脚本
$ adb shell monkey -f <scriptfile> <event-count>
eg：
$ adb shell monkey -f /mnt/sdcard/test1
2.伪随机数生成种子值
使用 -s命令可以重复执行之前的伪随机操作。本身每次执行伪随机事件操作也会默认生成一个seed值
$ adb shell monkey -s <seed> <event-count>
eg:
$ adb shell monkey -s 666 100
3.设置间隔 如果你希望在每一个指令之间加上固定的间隔时间，可以用--throttle（注意，前面是--）命令。
$ adb shell monkey --throttle <milliseconds>
eg:
$ adb shell monkey --throttle 3000 5
--throttle：后面接时间，单位为ms（<milliseconds>），表示事件之间的固定延迟（即执行每一个指令间隔的时间），若不接该选项，monkey将不会延迟。
4.调整触摸事件百分比
如果你希望调整触摸事件的百分比，记住使用--pct-touch。
$ adb shell monkey --pct-touch
eg:
$ adb shell monkey -v -v --pct-touch 100 200
<percent>--pct-touch：后面接触摸事件百分比
注意：触摸事件不单单是按键，它泛指发生在某一位置的一个down-up事件。
5.调整手势事件百分比
$ adb shell monkey --pct-motion
eg:
$ adb shell monkey -v -v --pct-motion 100 200
6.调整应用启动事件的百分比
如果你希望调整应用启动事件的百分比，记住使用--pct-app-switch。
$ adb shell monkey --pct-appswtich <percent>
--pct-appswitch：后面接应用启动事件百分比。
应用启动事件（即activity launches）俗称打开应用，通过调用startActivity()方法最大限度地开启该package下的所有应用。
7.调整屏幕旋转事件百分比
$ adb shell monkey --pct-rotation <percent>
--pct-rotation 后面接屏幕旋转事件的比例值。
8.其他参数
约束类参数
1.包约束
-p：后面接一个或多个包名（<allowed-package-name>），如果应用需要访问其他包里的Activity，那相关的包也需要在此同时指定。如果不指定任何包，monkey将允许系统启动全部包里的Activity。
$ adb shell monkey -p <allowed-package-name> <event-count>
eg：
$ adb shell monkey -p com.tal.kaoyan 500
$ adb shell monkey -p com.tal.kaoyan -p com.tencent.mm 500
2.activity类约束
如果你希望将monkey限制在一个或几个类别中，使用如下命令：
adb shell monkey -c <main-category> <event-count>
以下命令表示运行Intent.CATEGORY_LAUNCHER类别的Activity并发送1000个随机事件。
$ adb shell monkey -c Intent.CATEGORY_LAUNCHER 1000
调试类参数
1.应用程序崩溃后继续发送事件
如果你希望monkey在应用程序崩溃后继续发送事件，则需要用到--ignore-crashes命令
$ adb shell monkey --ignore-crashes <event-count>
在设置此选项后，当应用程序崩溃或发生失控异常时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到上述崩溃或异常将停止运行。
2.超时错误继续发送事件
如果你希望monkey在任何超时错误发生后继续发送事件，则需要用到--ignore-timeouts命令。
$ adb shell monkey --ignore-timeouts
<event-count>--ignore-timeouts：在设置此选项后，当应用程序发生任何超时错误（如ANR，即Application Not Responding）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类超时对话框将停止运行。
3.应用程序权限错误发生后继续发送事件
如果你希望monkey在应用程序权限错误发生后继续发送事件，则需要用到--ignore-security-exceptions命令。
$ adb shell monkey --ignore-security-exceptions
<event-count>--ignore-security-exceptions：在设置此选项后，当应用程序发生任何权限错误（如启动一个需要某些权限的Activity）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类权限错误将停止运行。
4.其他
Monkey参数应用综合案例
测试场景
测试考研帮app Android版。测试希望通过Monkey来模拟用户的随机操作，检查被测应用是否会出现异常（应用崩溃或者无响应）。
需求分析
1、测试是指定应用，因此需要使用-p指定被测app包名：com.tal.kaoyan
2、这个测试的目的是希望模拟用户操作，因此需要让Monkey执行的事件尽可能地接近用户的常规操作，这样才可以最大限度地发现用户使用过程中可能出现的问题。因此需要对Monkey执行的事件百分比做一些调整:
触摸事件和手势事件是用户最常见的操作，所以通过--pct-touch和--pct-motion将这两个事件的占比调整到40%与25%；目标应用包含了多个Activity，为了能覆盖大部分的Activity，所以通过--pct-appswitch将Activity切换的事件占比调整到10%；被测应用在测试中出现过不少横竖屏之间切换的问题，这个场景也必须关注，因此通过--pct-rotation把横竖屏切换事件调整到10%。
3、使用-s参数来指定命令执行的seed值 Monkey会根据seed值来生成对应事件流，同一个seed生成的事件流是完全相同的。这里指定了seed值，是为了测试发现问题时，便于进行问题复现。
4、使用--throttle参数来控制Monkey每个操作之间的时间间隔 指定操作之间的时间间隔，一方面是希望能更接近用户的操作场景，正常用户操作都会有一定的时间间隔；另一方面也是不希望因为过于频繁的操作而导致系统崩溃，尤其是在比较低端的手机上执行测试时。因此通过--throttle设置Monkey每个操作固定延迟0.4秒。
5、使用--ignore-crashs和--ignore-timeouts参数使Monkey遇到意外时能继续执行 在执行Monkey测试时，会因为应用的崩溃或没有响应而意外终止，所以需要在命令中增加限制参数--ignore-crash和--ignore-timeouts，让Monkey在遇到崩溃或没有响应的时候，能在日志中记录相关信息，并继续执行后续的测试。
6、使用-v指定log的详细级别 Monkey的日志输出有3个级别：日志的级别越高，其详细程度也越高。为了方便问题的定位，这里将日志设为 -v -v.
测试命令
adb shell monkey -p com.tal.kaoyan
--pct-touch 40 --pct-motion 25
--pct-appswitch 10
--pct-rotation 5
-s 1666 --throttle 400
--ignore-crashes
--ignore-timeouts
-v -v 200
四、monkey自定义脚本实践
monkey 参数
参数分类
- 常规类参数
- 事件类参数
- 约束类参数
- 调试类参数
常规类参数
常规类参数包括帮助参数和日志信息参数。帮助参数用于输出Monkey命令使用指导；日志信息参数将日志分为三个级别，级别越高，日志的信息越详细。
1.帮助类参数
monkey -h
2.日志级别
$ adb shell monkey -v <event-count>
-v：打印出日志信息，每个-v将增加反馈信息的级别。-v越多日志信息越详细，不过目前最多支持3个-v，即：
事件类参数
事件类参数的作用是对随机事件进行调控，从而使其遵照设定运行，如设置各种事件的百分比、设置事件生成所使用的种子值等。频率参数主要限制事件执行的时间间隔。
1.执行指定脚本
$ adb shell monkey -f <scriptfile> <event-count>
eg：
$ adb shell monkey -f /mnt/sdcard/test1
2.伪随机数生成种子值
使用 -s命令可以重复执行之前的伪随机操作。本身每次执行伪随机事件操作也会默认生成一个seed值
$ adb shell monkey -s <seed> <event-count>
eg:
$ adb shell monkey -s 666 100
3.设置间隔 如果你希望在每一个指令之间加上固定的间隔时间，可以用--throttle（注意，前面是--）命令。
$ adb shell monkey --throttle <milliseconds>
eg:
$ adb shell monkey --throttle 3000 5
--throttle：后面接时间，单位为ms（<milliseconds>），表示事件之间的固定延迟（即执行每一个指令间隔的时间），若不接该选项，monkey将不会延迟。
4.调整触摸事件百分比
如果你希望调整触摸事件的百分比，记住使用--pct-touch。
$ adb shell monkey --pct-touch
eg:
$ adb shell monkey -v -v --pct-touch 100 200
<percent>--pct-touch：后面接触摸事件百分比
注意：触摸事件不单单是按键，它泛指发生在某一位置的一个down-up事件。
5.调整手势事件百分比
$ adb shell monkey --pct-motion
eg:
$ adb shell monkey -v -v --pct-motion 100 200
6.调整应用启动事件的百分比
如果你希望调整应用启动事件的百分比，记住使用--pct-app-switch。
$ adb shell monkey --pct-appswtich <percent>
--pct-appswitch：后面接应用启动事件百分比。
应用启动事件（即activity launches）俗称打开应用，通过调用startActivity()方法最大限度地开启该package下的所有应用。
7.调整屏幕旋转事件百分比
$ adb shell monkey --pct-rotation <percent>
--pct-rotation 后面接屏幕旋转事件的比例值。
8.其他参数
约束类参数
1.包约束
-p：后面接一个或多个包名（<allowed-package-name>），如果应用需要访问其他包里的Activity，那相关的包也需要在此同时指定。如果不指定任何包，monkey将允许系统启动全部包里的Activity。
$ adb shell monkey -p <allowed-package-name> <event-count>
eg：
$ adb shell monkey -p com.tal.kaoyan 500
$ adb shell monkey -p com.tal.kaoyan -p com.tencent.mm 500
2.activity类约束
如果你希望将monkey限制在一个或几个类别中，使用如下命令：
adb shell monkey -c <main-category> <event-count>
以下命令表示运行Intent.CATEGORY_LAUNCHER类别的Activity并发送1000个随机事件。
$ adb shell monkey -c Intent.CATEGORY_LAUNCHER 1000
调试类参数
1.应用程序崩溃后继续发送事件
如果你希望monkey在应用程序崩溃后继续发送事件，则需要用到--ignore-crashes命令
$ adb shell monkey --ignore-crashes <event-count>
在设置此选项后，当应用程序崩溃或发生失控异常时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到上述崩溃或异常将停止运行。
2.超时错误继续发送事件
如果你希望monkey在任何超时错误发生后继续发送事件，则需要用到--ignore-timeouts命令。
$ adb shell monkey --ignore-timeouts
<event-count>--ignore-timeouts：在设置此选项后，当应用程序发生任何超时错误（如ANR，即Application Not Responding）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类超时对话框将停止运行。
3.应用程序权限错误发生后继续发送事件
如果你希望monkey在应用程序权限错误发生后继续发送事件，则需要用到--ignore-security-exceptions命令。
$ adb shell monkey --ignore-security-exceptions
<event-count>--ignore-security-exceptions：在设置此选项后，当应用程序发生任何权限错误（如启动一个需要某些权限的Activity）时，monkey将继续运行直到计数完成。如果不设置此选项，monkey遇到此类权限错误将停止运行。
4.其他
Monkey参数应用综合案例
测试场景
测试考研帮app Android版。测试希望通过Monkey来模拟用户的随机操作，检查被测应用是否会出现异常（应用崩溃或者无响应）。
需求分析
1、测试是指定应用，因此需要使用-p指定被测app包名：com.tal.kaoyan
2、这个测试的目的是希望模拟用户操作，因此需要让Monkey执行的事件尽可能地接近用户的常规操作，这样才可以最大限度地发现用户使用过程中可能出现的问题。因此需要对Monkey执行的事件百分比做一些调整:
触摸事件和手势事件是用户最常见的操作，所以通过--pct-touch和--pct-motion将这两个事件的占比调整到40%与25%；目标应用包含了多个Activity，为了能覆盖大部分的Activity，所以通过--pct-appswitch将Activity切换的事件占比调整到10%；被测应用在测试中出现过不少横竖屏之间切换的问题，这个场景也必须关注，因此通过--pct-rotation把横竖屏切换事件调整到10%。
3、使用-s参数来指定命令执行的seed值 Monkey会根据seed值来生成对应事件流，同一个seed生成的事件流是完全相同的。这里指定了seed值，是为了测试发现问题时，便于进行问题复现。
4、使用--throttle参数来控制Monkey每个操作之间的时间间隔 指定操作之间的时间间隔，一方面是希望能更接近用户的操作场景，正常用户操作都会有一定的时间间隔；另一方面也是不希望因为过于频繁的操作而导致系统崩溃，尤其是在比较低端的手机上执行测试时。因此通过--throttle设置Monkey每个操作固定延迟0.4秒。
5、使用--ignore-crashs和--ignore-timeouts参数使Monkey遇到意外时能继续执行 在执行Monkey测试时，会因为应用的崩溃或没有响应而意外终止，所以需要在命令中增加限制参数--ignore-crash和--ignore-timeouts，让Monkey在遇到崩溃或没有响应的时候，能在日志中记录相关信息，并继续执行后续的测试。
6、使用-v指定log的详细级别 Monkey的日志输出有3个级别：日志的级别越高，其详细程度也越高。为了方便问题的定位，这里将日志设为 -v -v.
测试命令
adb shell monkey -p com.tal.kaoyan
--pct-touch 40 --pct-motion 25
--pct-appswitch 10
--pct-rotation 5
-s 1666 --throttle 400
--ignore-crashes
--ignore-timeouts
-v -v 200
五、monkey日志管理
日志管理作用
Monkey日志管理是Monkey测试中非常重要的一个环节，通过日志管理分析，可以获取当前测试对象在测试过程中是否会发生异常，以及发生的概率，同时还可以获取对应的错误信息，帮助开发定位和解决问题。
monkey日志保存方法
- 保存在PC中
- 保存在手机上
- 标准流和错误流分开保存
保存在PC中
>adb shell monkey [option] <count> >d:\monkey.txt
eg：
C:\Users\Shuqing>adb shell monkey -v -v 100 >d:\monkeylog.txt
保存在手机上
C:\Users\Shuqing>adb shell
monkey -v 100 >/sdcard/monkeylog.log
注意：不能写成C:\Users\Shuqing>adb shell monkey -f /sdcard/kyb.txt -v 1 > /mnt/sdcard/monkey.log 否则会报错“系统找不到指定的路径”。
标准流和错误流分开保存
·标准流与错误流分开保存，代码如下：
Monkey [option] <count> 1>/sdcard/monkey.txt 2>/sdcard/error.txt
C:\Users\Shuqing>adb shell monkey -v 100 1>d:\monkey.log 2>d:\error.log
执行以上命令，Monkey的运行日志和异常日志将被分开保存。此时Monkey的运行日志将被保存在monkey.txt文件中，而异常日志将被保存在D盘下的error.txt中。
日志内容分析
运行命令：
adb shell monkey -v 100
运行后log如下：
C:\Users\Shuqing>adb shell monkey -v 100
:Monkey: seed=1524595418646 count=100
: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.android.settings/.Settings;end
// Allowing start of Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.android.settings/.Settings } in package com.android.settings
:Sending Touch (ACTION_DOWN): 0:(381.0,391.0)
:Sending Touch (ACTION_UP): 0:(371.61426,386.54578)
:Sending Touch (ACTION_DOWN): 0:(608.0,610.0)
:Sending Touch (ACTION_UP): 0:(609.2884,609.54736)
:Sending Trackball (ACTION_MOVE): 0:(-3.0,4.0)
:Sending Trackball (ACTION_MOVE): 0:(4.0,4.0)
:Sending Touch (ACTION_DOWN): 0:(42.0,319.0)
:Sending Touch (ACTION_UP): 0:(40.672623,306.90936)
:Sending Touch (ACTION_DOWN): 0:(577.0,372.0)
:Sending Touch (ACTION_UP): 0:(521.3876,386.2045)
:Sending Touch (ACTION_DOWN): 0:(59.0,762.0)
:Sending Touch (ACTION_UP): 0:(92.18322,695.0543)
:Sending Touch (ACTION_DOWN): 0:(46.0,1066.0)
:Sending Touch (ACTION_UP): 0:(118.78821,1042.1993)
:Sending Touch (ACTION_DOWN): 0:(525.0,696.0)
:Sending Touch (ACTION_UP): 0:(557.81305,684.04376)
:Sending Touch (ACTION_DOWN): 0:(466.0,12.0)
:Sending Touch (ACTION_UP): 0:(453.73657,10.844121)
:Sending Trackball (ACTION_MOVE): 0:(0.0,1.0)
Events injected: 100
:Sending rotation degree=0, persist=false
:Dropped: keys=0 pointers=0 trackballs=0 flips=0 rotations=0
## Network stats: elapsed time=924ms (0ms mobile, 0ms wifi, 924ms not connected)
// Monkey finished
六、monkeyrunner简介
monkeyrunner简介
MonkeyRunner工具是使用Jython(使用Java编程语言实现的Python)写出来的，它提供了多个API，通过monkeyrunner API 可以写一个Python的程序来模拟操作控制Android设备app,测试其稳定性并通过截屏可以方便地记录出现的问题。
官网介绍如下
The monkeyrunner tool provides an API for writing programs that control an Android device or emulator from outside of Android code. With monkeyrunner, you can write a Python program that installs an Android application or test package, runs it, sends keystrokes to it, takes screenshots of its user interface, and stores screenshots on the workstation. The monkeyrunner tool is primarily designed to test applications and devices at the functional/framework level and for running unit test suites, but you are free to use it for other purposes.
monkeyrunner工具提供了一个API，用于编写从Android代码之外控制Android设备或模拟器的程序。 通过monkeyrunner，您可以编写一个Python程序，用于安装Android应用程序或测试包，运行它并向它发送按键事件，截取其用户界面的截图，并在工作区上存储屏幕截图。 monkeyrunner工具主要设计用于在功能/框架级别测试应用程序和设备，以及运行单元测试套件，但您可以自由地将其用于其他目的。
monkeyrunner 路径：Andriod_SDK\tools
MonkeyRunner功能
1.多设备控制：API可以跨多个设备，一次启动全部模拟器来实施测试套件;
2.功能测试：为应用自动执行一次功能测试，然后观察输出结果的截屏。
3.可扩展自动化：因为monkeyrunner是一个API工具包，你可以开发基于Python模块的整个系统来控制Android设备;
Monkeyrunner与Monkey区别
monkeyrunner和money没有什么直接的关系，monkey是在设备直接运行adb shell命令生成随机事件来进行测试的。相比较而言，monkeyrunner则是通过API发送特定的命令和事件来控制设备。
monkeyrunner环境搭建
- 安装并配置好jdk环境
- 安装android sdk
- 安装python 安装配置教程
- monkeyrunner环境变量配置： {Path}\Andriod_SDK\tools
安装结果检测
在控制台输入命令：monkeyrunner出现如下显示内容则说明安装成功
C:\Users\Shuqing>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_05
>>>
Tips：退出monkeyrunner命令行模式可以 使用快捷键 ctrl+D退出。
七、monkeyrunner API
MonkeyRunner API
MonkeyRunner工具主要有三个类：
- MonkeyRunner
- MonkeyDevice
- MonkeyImage
官方API文档 ：http://www.android-doc.com/tools/help/monkeyrunner_concepts.html#
1.MonkeyRunner类：
MonkeyRunner提供连接真机和模拟器、输入、暂停、警告框等方法。
常用方法
waitForConnection(float timeout,string deviceid)，
from com.android.monkeyrunner import MonkeyRunner as mr
print("connect devices...")
device=mr.waitForConnection()
# device=mr.waitForConnection(5,'127.0.0.1:62001')
2.MonkeyDevice类
MonkeyDevice类提供了安装和卸载程序包、开启Activity、发送按键和点击事件、运行测试包等方法。
常用方法
- installPackage (string path)
- removePackage (string package)
- startActivity (string uri, string action, string data, string mimetype, iterable categories dictionary extras, component component, flags)
- touch (integer x, integer y, integer type)
touch参数说明
integer x，x坐标值。
integer y，y坐标值。
integer type，key event类型（如DOWN、UP、DOWN_AND_UP）。
DOWN为按下事件 UP为弹起事件 DOWN_AND_UP为按下弹起事件。
- drag (tuple start, tuple end, float duration, integer steps)
drag参数详细说明如下：
tuple start，拖拽起始位置，为tuple类型的(x,y)坐标点。
tuple end，拖拽终点位置，为tuple类型的(x,y)坐标点。
float duration，拖拽手势持续时间，默认为1.0s。
-integer steps，插值点的步数，默认值为10。
实践案例：
连接设备，安装考研帮App并启动
代码实现
kyb_start.py
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
print("connect devices...")
device=mr.waitForConnection()
print("install app...")
device.installPackage(r'C:\Users\Shuqing\Desktop\kaoyan3.1.0.apk')
package = 'com.tal.kaoyan'
activity = 'com.tal.kaoyan.ui.activity.SplashActivity'
runComponent = package + '/' + activity
print("launch App...")
device.startActivity(component=runComponent)
代码执行方式
monkeyrunner scripfile
C:\Users\Shuqing>monkeyrunner E:\monkeyrunner_script\kyb.py
3.MonkeyImage类
MonkeyImage类在测试过程中用来保存各种格式的测试截图，并可以进行图像对比。
常用方法
- takeSnapshot() 进行屏幕截图
- writeToFile() 保存图像文件到指定的文件路径
用法示例
from com.android.monkeyrunner import MonkeyImage as mi
print("takeSnapshot")
screenshot=device.takeSnapshot()
screenshot.writeToFile(r'E:\monkeyrunner_script\test.png','png')
综合实践
测试场景
- 连接设备，自动安装并启动考研帮app
- 启动后登录账号（账号zxw1234 密码：zxw123456），然后截图并保存到指定文件位置。
- 连接设备
- 安装app
- 启动app
- 输入用户名密码点击登录按钮
- 截图
思路分析
脚本实现
kyb_login.py
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
print("connect devices...")
device=mr.waitForConnection()
print(" install app")
device.installPackage(r'C:\Users\Shuqing\Desktop\kaoyan3.1.0.apk')
print("launch app...")
package='com.tal.kaoyan'
activity='com.tal.kaoyan.ui.activity.SplashActivity'
runComponent=package+'/'+activity
device.startActivity(component=runComponent)
mr.sleep(3)
print("touch cancel button")
device.touch(618,895,'DOWN_AND_UP')
mr.sleep(1)
print("touch skip button")
device.touch(804,67,'DOWN_AND_UP')
mr.sleep(1)
print("input username and password")
device.touch(57,373,'DOWN_AND_UP')
mr.sleep(2)
device.type('zxw1234')
device.touch(152,480,'DOWN_AND_UP')
mr.sleep(2)
device.type('zxw123456')
mr.sleep(2)
print("touch login button")
device.touch(331,634,'DOWN_AND_UP')
print("takeSnapshot")
screenshot=device.takeSnapshot()
screenshot.writeToFile(r'D:\monkeyrunner\kyb.png','png')
注意事项
方法调用错误
AttributeError: type object 'com.android.monkeyrunner.XXXXX' has no attribute XXXXXX
检查调用的方法名是否写错，特别是注意区分大小写。
字符编码错误
SyntaxError: Non-ASCII character in file 'E:\monkeyrunner_script\kyb.py', but no encoding declared;
需要在代码顶部补充 # -- coding: utf-8 -- 或者去掉代码中的中文字符