MonkeyRunner API使用说明
合集下载
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
本文只对 monkeyrunner 的使用进行说明，如有解释偏差，谢谢指正，邮箱地址： langhuang521@monkeyrunner
第 1 章 MonkeyRuner 简介
1.1 介绍
monkeyrunner 工具提供了一个 API，使用此 API 写出的程序可以在 Android 代码之外控制 Android 设备和模拟器。通过 monkeyrunner，您可以写出一个 Python 程序去安装一个 Android 应用 程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。 monkeyrunner 工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测 试套件，但也可以将其用于其它目的。
输入数值，然后观察输出结果的截屏。
回归测试：monkeyrunner 可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏
相比较，以此测试应用的稳定性。
可扩展的自动化：由于 monkeyrunner 是一个 API 工具包，您可以基于 Python 模块和程序
开发一整套系统，以此来控制 Android 设备。除了使用 monkeyrunner API 之外，您还可以 使用标准的 Python os 和 subprocess 模块来调用 Android Debug Bridge 这样的 Android 工具。
《MonkeyRunner API 使用说明》
Author：ewang Date:2016-7-28
目录
说 明..................................................................................................................................................3 第 1 章 MonkeyRuner 简介 .......................................................................................................4
Hierarchyviewer（层级观察器）是 Android 自带的非常有用而且使用简单的工具，可以 帮助我们更好地检视和设计用户界面(UI)。主要功能有：从可视化的角度直观地获得 UI 布 局设计结构和各种属性的信息，帮助我们优化布局设计； 结合 debug 帮助观察特定的 UI 对象进行 invalidate 和 requestLayout 操作的过程。
1.1 介绍................................................................................................................................4 1.2 一个简单 monkeyrunner 程序 ......................................................................................4 1.3 monkeyrunner API.........................................................................................................5 1.4 运行 monkeyrunner .......................................................................................................6 1.5 monkeyrunner 内建帮助 ...............................................................................................6 1.6 扩展 monkeyrunner 插件 ..............................................................................................6
2.2 属性变量列表....................................................................................................................10 第 3 章 MonkeyImage 类使用方法说明 ........................................................................................11
如果软件该版本被释放开发代码名称还为relwidth设备的显示宽度单位像素height设备的显示高度单位像素displaydensity设备透明度package当前运行andriod包的名称action当前活动的actioncompclass当前开始活动组件的类名comppackage当前开始活动组件的包名data当前活动目标包含的数据amcurrentcategories当前活动目标指定的类别realtime从设备重启保存睡眠时间所耗费的毫秒数uptime设备重启所耗费的毫秒数clockmillis从unix新纪元开始到现在所经历的时间以毫秒为单monkeyimage类使用方法说明31创建monkeyimage实例monkeyrunner类取保持设备或模拟器在屏幕的图像
2.1 常量和方法..........................................................................................................................8 2.1.1 常量列表...................................................................................................................8.......................................................................................8
DDMS（Dalvik 调试监视器服务）全称是 Dalvik Debug Monitor Service，是 Android 开 发环境中的 Dalvik（为 Android 平台定制的虚拟机（VM））虚拟机调试监控服务。主要功 能是：为测试设备截屏，针对特定的进程查看正在运行的线程以及堆信息、Logcat、广播 状态信息、模拟电话呼叫、接收 SMS、虚拟地理坐标等等。
monkeyrunner 工具与 monkey 工具是不相关的。Monkey 工具在 adb shell 环境下运 行直接对设备或模拟器发送的用户和系统事件的随机流。相比较而言，monkeyrunner 工 具通过 API 控制设备和仿真发送特定命令和事件。
monkeyrunner 工具提供针对 Android 测试独特的功能：
monkeyrunner 它主要可应用于功能测试，回归测试，并且可以自定义测试扩展，灵活 性较强，并且测试人员可以完全控制。monkey 主要应用在压力和可靠性测试上，运行该命 令可以随机地向目标程序发送各种模拟键盘事件流，并且可以自己定义发送的次数，以此 观察被测应用程序的稳定性和可靠性。
Traceview 是 android 平台配备一个很好的性能分析的工具。它可以通过图形化的方式 让我们了解我们要跟踪的程序的性能，并且能具体到 method。这个工具可以将你的 Android 应用程序产生的跟踪日志（trace log）转换为图形化的分析视图。
说明
本篇文章翻译链接： https:///afs/sipb/project/android/docs/tools/help/monkeyrunner_concepts.html
本人这段时间在研究 APP 的测试，在 sdk 中的 tools 中有：ddms，hierarchyviewer， monitor，monkeyrunner，traceview，uiautomatorviewer 几个主要工具。
1.6.1 插件启动类........................................................................................................7 第 2 章 MonkeyDevice 类使用..................................................................................................8
uiautomatorviewer，一个用来来扫描和分析 Android 应用程序的 UI 组件的 GUI 工具。 使用 uiautomatorviewer，可以检查一个应用的 UI 来查看应用的布局和组件以及相关的属性。
monitor 包含全部前面介绍的工具，还存在其他功能，比如 uiautomatorviewer 一次只能 查看一个屏幕布局，但使用 monitor 捕获会生成独立的文件，查看互不影响。
多设备控制：monkeyrunner API 可以跨多个设备或模拟器实施测试套件。可以在同一时间
接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运 行一个或多个测试。也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭 模拟器。
功能测试： monkeyrunner 可以为一个应用自动贯彻一次功能测试。提供按键或触摸事件的
3.1 创建 MonkeyImage 实例 ..................................................................................................11 3.2 方法说明............................................................................................................................11 第 4 章 MonkeyRunner 类使用说明 ..............................................................................................12 附录..................................................................................................................................................13 Monkey 综述 ...........................................................................................................................13
简述..................................................................................................................................13 基本使用..........................................................................................................................13 命令选项参考..................................................................................................................14
第 1 章 MonkeyRuner 简介
1.1 介绍
monkeyrunner 工具提供了一个 API，使用此 API 写出的程序可以在 Android 代码之外控制 Android 设备和模拟器。通过 monkeyrunner，您可以写出一个 Python 程序去安装一个 Android 应用 程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。 monkeyrunner 工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测 试套件，但也可以将其用于其它目的。
输入数值，然后观察输出结果的截屏。
回归测试：monkeyrunner 可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏
相比较，以此测试应用的稳定性。
可扩展的自动化：由于 monkeyrunner 是一个 API 工具包，您可以基于 Python 模块和程序
开发一整套系统，以此来控制 Android 设备。除了使用 monkeyrunner API 之外，您还可以 使用标准的 Python os 和 subprocess 模块来调用 Android Debug Bridge 这样的 Android 工具。
《MonkeyRunner API 使用说明》
Author：ewang Date:2016-7-28
目录
说 明..................................................................................................................................................3 第 1 章 MonkeyRuner 简介 .......................................................................................................4
Hierarchyviewer（层级观察器）是 Android 自带的非常有用而且使用简单的工具，可以 帮助我们更好地检视和设计用户界面(UI)。主要功能有：从可视化的角度直观地获得 UI 布 局设计结构和各种属性的信息，帮助我们优化布局设计； 结合 debug 帮助观察特定的 UI 对象进行 invalidate 和 requestLayout 操作的过程。
1.1 介绍................................................................................................................................4 1.2 一个简单 monkeyrunner 程序 ......................................................................................4 1.3 monkeyrunner API.........................................................................................................5 1.4 运行 monkeyrunner .......................................................................................................6 1.5 monkeyrunner 内建帮助 ...............................................................................................6 1.6 扩展 monkeyrunner 插件 ..............................................................................................6
2.2 属性变量列表....................................................................................................................10 第 3 章 MonkeyImage 类使用方法说明 ........................................................................................11
如果软件该版本被释放开发代码名称还为relwidth设备的显示宽度单位像素height设备的显示高度单位像素displaydensity设备透明度package当前运行andriod包的名称action当前活动的actioncompclass当前开始活动组件的类名comppackage当前开始活动组件的包名data当前活动目标包含的数据amcurrentcategories当前活动目标指定的类别realtime从设备重启保存睡眠时间所耗费的毫秒数uptime设备重启所耗费的毫秒数clockmillis从unix新纪元开始到现在所经历的时间以毫秒为单monkeyimage类使用方法说明31创建monkeyimage实例monkeyrunner类取保持设备或模拟器在屏幕的图像
2.1 常量和方法..........................................................................................................................8 2.1.1 常量列表...................................................................................................................8.......................................................................................8
DDMS（Dalvik 调试监视器服务）全称是 Dalvik Debug Monitor Service，是 Android 开 发环境中的 Dalvik（为 Android 平台定制的虚拟机（VM））虚拟机调试监控服务。主要功 能是：为测试设备截屏，针对特定的进程查看正在运行的线程以及堆信息、Logcat、广播 状态信息、模拟电话呼叫、接收 SMS、虚拟地理坐标等等。
monkeyrunner 工具与 monkey 工具是不相关的。Monkey 工具在 adb shell 环境下运 行直接对设备或模拟器发送的用户和系统事件的随机流。相比较而言，monkeyrunner 工 具通过 API 控制设备和仿真发送特定命令和事件。
monkeyrunner 工具提供针对 Android 测试独特的功能：
monkeyrunner 它主要可应用于功能测试，回归测试，并且可以自定义测试扩展，灵活 性较强，并且测试人员可以完全控制。monkey 主要应用在压力和可靠性测试上，运行该命 令可以随机地向目标程序发送各种模拟键盘事件流，并且可以自己定义发送的次数，以此 观察被测应用程序的稳定性和可靠性。
Traceview 是 android 平台配备一个很好的性能分析的工具。它可以通过图形化的方式 让我们了解我们要跟踪的程序的性能，并且能具体到 method。这个工具可以将你的 Android 应用程序产生的跟踪日志（trace log）转换为图形化的分析视图。
说明
本篇文章翻译链接： https:///afs/sipb/project/android/docs/tools/help/monkeyrunner_concepts.html
本人这段时间在研究 APP 的测试，在 sdk 中的 tools 中有：ddms，hierarchyviewer， monitor，monkeyrunner，traceview，uiautomatorviewer 几个主要工具。
1.6.1 插件启动类........................................................................................................7 第 2 章 MonkeyDevice 类使用..................................................................................................8
uiautomatorviewer，一个用来来扫描和分析 Android 应用程序的 UI 组件的 GUI 工具。 使用 uiautomatorviewer，可以检查一个应用的 UI 来查看应用的布局和组件以及相关的属性。
monitor 包含全部前面介绍的工具，还存在其他功能，比如 uiautomatorviewer 一次只能 查看一个屏幕布局，但使用 monitor 捕获会生成独立的文件，查看互不影响。
多设备控制：monkeyrunner API 可以跨多个设备或模拟器实施测试套件。可以在同一时间
接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运 行一个或多个测试。也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭 模拟器。
功能测试： monkeyrunner 可以为一个应用自动贯彻一次功能测试。提供按键或触摸事件的
3.1 创建 MonkeyImage 实例 ..................................................................................................11 3.2 方法说明............................................................................................................................11 第 4 章 MonkeyRunner 类使用说明 ..............................................................................................12 附录..................................................................................................................................................13 Monkey 综述 ...........................................................................................................................13
简述..................................................................................................................................13 基本使用..........................................................................................................................13 命令选项参考..................................................................................................................14