安卓自动化测试文档

Monkey

1. Monkey

安卓SDK自带的测试工具，    顾名思义，Monkey就是一只猴子，到处乱抓、乱按，属于压力测试软件。
特点： 1.测试对象为程序包，有一定局限性 2.伪随机事件，不能自定义 3.可对事件数量、类型、频率设置

2. 环境变量配置

以macOs为例
运行

1

open ~/.zshrc

新增环境变量

1
2
3

export PATH=${PATH}:/Users/wangchangqin/develop/android/sdk/platform-tools
export PATH=${PATH}:/Users/wangchangqin/develop/android/sdk/tools
export PATH=${PATH}:/Users/wangchangqin/develop/android/sdk/tools/bin

这样就把monkeyrunner 配置到环境变量了。

3. Monkey基本用法

**adb shell monkey [option]**
option为可选参数，如果不加的话,默认会测试所有的APP。

**adb shell monkey -p your.package.name <event count >**
-p用来指定需要测试的APP，后面跟测试APP的包名 event count 表示需要发送事件的个数。

4. Monkey基础参数

• -p
  用于指定一个包或多个包，指定了包之后，Monkey将只启动指定的APP，不指定的话，将允许启动所有的APP。
• -c
  如果用此参数指定了一个或几个类别，Monkey将只允许系统启动被这些类别中的某个类别列出的Activity。如果不指定任何类别，Monkey将选择下列类别中列出的Activity:Intent.CATEGORY.LAUNCHER或Intent.CATEGORY.MONKEY。要指定多个类别，需要使用多个-c选项，每个-c选项只能用于一个类别。
• -v 日志反馈级别。总共分3个级别，分别对应的参数如下所示：
  | Level | cmd | Info |
  | — | — | – |
  | -v | Level 0 : adb shell monkey -p your.package.name -v 100 | 缺省值，仅提供启动提示、测试完 成和最终结果等少量信息 |
  | -v -v | adb shell monkey -p your.package.name -v -v 100 | 提供较为详细的日志，包括每个发送到Activity的事件信息 |
  | -v -v -v | adb shell monkey -p your.package.name -v -v -v 100 | 最详细的日志，包括了测试中选中/未选中的Activity信息 |
• -s (随机数种子)
  用于指定伪随机数生成器的seed值，如果seed相同，则两次Monkey测试所产生的事件序列也相同的。 示例：
  monkey测试1：adb shell monkey -p your.package.name –s 10 100
  monkey测试2：adb shell monkey -p your.package.name –s 10 100
• –throttle <毫秒>
  用于指定用户操作（即事件）间的时延，单位是毫秒；如果不指定这个参数，monkey会尽可能快的 生成和发送消息。
  例：adb shell monkey -p your.package.name –throttle 3000 100

5. Monkey发送事件的类型

• –pct-touch
  调整触摸事件的百分比（触摸事件是一个down-up事件），它发生在屏幕上的某单一位置
• –pct-motion
  调整动作事件的百分比（动作事件是由屏幕上某处的一个down事件、一系列的伪随机事件和一个up事件组成）
• –pct-trackball
  调整轨迹事件的百分比（轨迹事件由一个或几个随机的移动组成，有时还伴随有点击）事件
• –pct-nav
  调整“基本”导航时间的百分比（导航事件由来自方向输入设备的up/down/left/right组成）
• –pct-majornav
  调整“主要”导航事件的百分比（这些导航事件通常引发图形界面中的动作，如5-way键盘的中间按键、回退按键、菜单按键）
• –pct-syskeys
  调整“系统”按钮事件的百分比（这些按键通常被保留，由系统使用，如Home、Back、StartCall、End Call及音量控制键）
• –pct-appswitch
  调整启动Activity的百分比。在随机间隔里，Monkey执行一个startActivity()调用，作为最大程度覆盖包中全部Activity的一种方法
• –pct-anyevent
  调整其他类型事件的百分比。它包罗了所有其他类型的事件，如：按键、其他不常用的设备按钮等
• –pct-flip
• –pct-pinchzoom

6. Monkey调试参数

• –dbg-no-events
  设置此选项，Monkey将执行初始启动，进入到一个测试Activity，然后不会再进一步生成事件。最好将它与-v、一个或几个包约束。以及一个保持Monkey运行30秒或更长事件的非零值联合起来，从而提供一个环境，可以监视应用程序所调用的包之间的转换
• –hprof
  设置此选项，将在Monkey事件序列之前和之后立即生成profiling报告，这将在data/misc中生成大文件（~5MB），所以要小心使用
• –ignore-crashes
  通常，当应用程序崩溃或发生任何失控异常时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成
• –ignore-timeouts
  应用程序发生任何超时错误（如”Application Not Responding”对话框）时，Monkey将停止运行。如果设置此选项，Monkey将继续向系统发送事件，直到计数完成
• –ingore-security-exceptions
  当应用程序发生权限许可错误时，Monkey将停止运行。如果设置了此选项，Monkey将继续向系统发送事件，直到计数完成
• –ingnore-native-crashes
  当应用程序发生底层C/C++代码引起的崩溃事件时，Monkey将停止运行。选择此项，Monkey将继续向系统发送事件，直到计数完成
• –monitor-native-crashes
  监视并报告Android系统中Android C/C++引起的崩溃事件。如果设置了–kill-process-after-error，系统将停止运行
• –kill-process-after-error
  当Monkey由于一个错误而停止时，出错的应用程序将继续处于运行状态。当设置了此选项时，将会通知系统停止发生错误的进程。注意，当Monkey正常执行完毕，它不会关闭所有启动的应用，设备依然保留Monkey结束时的状态
• –wait-dbq

  启动Monkey后，先中断其运行，等待调试器附加上来
  

7. Monkey黑名单与白名单

***黑名单：不测试的应用***
***白名单：只测试这部分应用***
***注意：不能同时设置黑名单和白名单***

• –pkg-blacklist-file
  apk黑名单，屏蔽掉黑名单中的apk
• –pkg-whitelist-file
  apk白名单，只测试包含在白名单中的apk

以黑名单为例，具体的步骤如下：

1.  查找系统的包，并输出到e盘的pkg文档里。adb shell pm list package>e:\pkg.txt
2.  将想要加入黑名单的apk的包名放到blacklist.txt里，最后push进设备。adb push e:\blacklist.txt /data/local/tmp/
3.  执行Monkey命令。adb shell monkey --pkg-blacklist-file /data/local/tmp/blacklist.txt --throttle 200 200

8. MonkeyRunner常用的按键介绍

Home键：KEYCOD_HOME
Back键：KEYCODE_BACK
send键：KEYCODE_CALL
end键：KEYCODE_ENDCALL

上导航键：KEYCODE_DPAD_UP（现在手机已经没有这个键）
下导航键：KEYCODE_DPAD_DOWN（现在手机已经没有这个键）
左导航：KEYCODE_DPAD_LEFT 现在手机已经没有这个键
右导航键：KEYCODE_DPAD_RIGHT 现在手机已经没有这个键

ok键：KEYCODE_DPAD_CENTER

上音量键：KEYCODE_VOLUME_UP
下音量键：KEYCODE_VOLUME_DOWN

power键：KEYCODE_POWER
camera键：KEYCODE_CAMERA
menu键：KEYCODE_MENU
search键：KEYCODE_SEARCH
call键：KEYCODE_CALL

按下HOME键 device.press(‘KEYCODE_HOME’,MonkeyDevice.DOWN_AND_UP)
按下BACK键 device.press(‘KEYCODE_BACK’,MonkeyDevice.DOWN_AND_UP)
按下下导航键 device.press(‘KEYCODE_DPAD_DOWN’,MonkeyDevice.DOWN_AND_UP)
按下上导航键 device.press(‘KEYCODE_DPAD_UP’,MonkeyDevice.DOWN_AND_UP)
按下OK键 device.press(‘KEYCODE_DPAD_CENTER’,MonkeyDevice.DOWN_AND_UP)

device.press(‘KEYCODE_ENTER’,MonkeyDevice.DOWN_AND_UP)#输入回车

device.press(‘KEYCODE_BACK’,MonkeyDevice.DOWN_AND_UP)#点击返回

9. 停止命令

adb shell ps | grep monkey
返回来的第一个数字，即是monkey的进程号
adb shell kill [刚才查到的进程号]

UiAutomator2

1. 环境配置，以Android Studio为例

1
2
3
4
5
6
7
8
9
10

dependencies {
    ...
    //测试框架
    // Force usage of support annotations in the test app, since it is internally used by the runner module.
    androidTestCompile 'com.android.support:support-annotations:25.4.0'
    androidTestCompile 'com.android.support.test:runner:1.0.0'
    // UiAutomator Testing
    androidTestCompile 'com.android.support.test.uiautomator:uiautomator-v18:2.1.3'
    androidTestCompile 'org.hamcrest:hamcrest-integration:1.3'
}

1
2
3
4
5
6
7
8

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.3"
    defaultConfig {
       ...
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
}

2. Google官方Demo

• [Demo](https://github.com/googlesamples/android-testing/tree/master/ui/uiautomator/BasicSample)
• [文档](https://developer.android.com/training/testing/ui-automator.html)

3. 常见API

鸣谢

• http://t.leborn.me/blog/home/detail/1509242157594151495
• http://www.cnblogs.com/ITGirl00/p/4141277.html