《monkeyrunnerapi使用说明》由会员分享，可在线阅读，更多相关《monkeyrunnerapi使用说明（16页珍藏版）》请在金锄头文库上搜索。
1、MonkeyRunnerMonkeyRunner APIAPI 使用说明使用说明 Author：ewangAuthor：ewang Date:2016-7-28Date:2016-7-28 目目 录录 说 明3 第 1 章MonkeyRuner 简介 .4 1.1介绍4 1.2一个简单 monkeyrunner 程序4 1.3monkeyrunner API.5 1.4运行 monkeyrunner.6 1.5monkeyrunner 内建帮助.6 1.6扩展 monkeyrunner 插件6 1.6.1插件启动类7 第 2 章MonkeyDevice 类使用8 2.1 常量和方法8 2.1.
2、1 常量列表.8 2.1.2 方法列表.8 2.2 属性变量列表10 第 3 章 MonkeyImage 类使用方法说明11 3.1 创建 MonkeyImage 实例11 3.2 方法说明11 第 4 章 MonkeyRunner 类使用说明 12 附录13 Monkey 综述.13 简述13 基本使用13 命令选项参考14 说说 明明 本篇文章翻译链接： https:/stuff.mit.edu/afs/sipb/project/android/docs/tools/help/monkeyrunner_concepts.html 本人这段时间在研究 APP 的测试，在 sdk 中的 too
3、ls 中有：ddms，hierarchyviewer， monitor，monkeyrunner，traceview，uiautomatorviewer 几个主要工具。 DDMS（Dalvik 调试监视器服务）全称是 Dalvik Debug Monitor Service，是 Android 开 发环境中的 Dalvik（为 Android 平台定制的虚拟机（VM）虚拟机调试监控服务。主要功 能是：为测试设备截屏，针对特定的进程查看正在运行的线程以及堆信息、Logcat、广播 状态信息、模拟电话呼叫、接收 SMS、虚拟地理坐标等等。 Hierarchyviewer（层级观察器）是 Andro
4、id 自带的非常有用而且使用简单的工具，可以 帮助我们更好地检视和设计用户界面(UI)。主要功能有：从可视化的角度直观地获得 UI 布 局设计结构和各种属性的信息，帮助我们优化布局设计； 结合 debug 帮助观察特定的 UI 对象进行 invalidate 和 requestLayout 操作的过程。 monkeyrunner 它主要可应用于功能测试，回归测试，并且可以自定义测试扩展，灵活 性较强，并且测试人员可以完全控制。monkey 主要应用在压力和可靠性测试上，运行该命 令可以随机地向目标程序发送各种模拟键盘事件流，并且可以自己定义发送的次数，以此 观察被测应用程序的稳定性和可靠性。
5、Traceview 是 android 平台配备一个很好的性能分析的工具。它可以通过图形化的方式 让我们了解我们要跟踪的程序的性能，并且能具体到 method。这个工具可以将你的 Android 应用程序产生的跟踪日志（trace log）转换为图形化的分析视图。 uiautomatorviewer，一个用来来扫描和分析 Android 应用程序的 UI 组件的 GUI 工具。 使用 uiautomatorviewer，可以检查一个应用的 UI 来查看应用的布局和组件以及相关的属性。 monitor 包含全部前面介绍的工具，还存在其他功能，比如 uiautomatorviewer 一次只能 查
6、看一个屏幕布局，但使用 monitor 捕获会生成独立的文件，查看互不影响。 本文只对 monkeyrunner 的使用进行说明，如有解释偏差，谢谢指正，邮箱地址： monkeyrunner 第第 1 章章MonkeyRuner 简介简介 1.1 介绍介绍 monkeyrunner 工具提供了一个 API，使用此 API 写出的程序可以在 Android 代码之外控制 Android 设备和模拟器。通过 monkeyrunner，您可以写出一个 Python 程序去安装一个 Android 应用 程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。 monke
7、yrunner 工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测 试套件，但也可以将其用于其它目的。 monkeyrunner 工具与 monkey 工具是不相关的。Monkey 工具在 adb shell 环境下运 行直接对设备或模拟器发送的用户和系统事件的随机流。相比较而言，monkeyrunner 工 具通过 API 控制设备和仿真发送特定命令和事件。 monkeyrunner 工具提供针对 Android 测试独特的功能： 多设备控制：monkeyrunner API 可以跨多个设备或模拟器实施测试套件。可以在同一时间 接上所有的设备或一次启动全部模拟器（
8、或统统一起），依据程序依次连接到每一个，然后运 行一个或多个测试。也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭 模拟器。 功能测试： monkeyrunner 可以为一个应用自动贯彻一次功能测试。提供按键或触摸事件的 输入数值，然后观察输出结果的截屏。 回归测试：monkeyrunner 可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏 相比较，以此测试应用的稳定性。 可扩展的自动化：由于 monkeyrunner 是一个 API 工具包，您可以基于 Python 模块和程序 开发一整套系统，以此来控制 Android 设备。除了使用 monkeyrunner AP
9、I 之外，您还可以 使用标准的 Python os 和 subprocess 模块来调用 Android Debug Bridge 这样的 Android 工具。 monkeyrunner 工具用 Jython 来实现控制，Jython 是使用 Java 编程语言一个 eclipse 插件，该 插件是提供 Python 开发环境。 Jython 的允许 monkeyrunner API 与 Android 框架轻松互动。使用 Jython，您可以使用 Python 语法来访问常量，类和 API 的方法。 1.2 一个简单一个简单 monkeyrunner 程序程序 这是一个简单的 monkey
10、runner 程序，改程序的功能是：连接设备、创建一个 MonkeyDevice 对 象。使用 MonkeyDevice 对象，安装一个 Android 应用程序包，运行其中一个活动，并将关键事件发送 给这个活动。改程序保存结果的截图，创建一个 MonkeyImage 对象。使用这个对象，保存结果截图文 件。 1.3 monkeyrunner API monkeyrunner API 三个模块被包含在包 com.android.monkeyrunner： MonkeyRunner:是 monkeyrunner 程序实用方法的类。这个类提供了 monkeyrunner 用于连接 至设备或模拟器的
11、方法。它还提供了用于一个 monkeyrunner 程序创建用户界面和用于显示内置帮助的 方法。 MonkeyDevice：表示一个设备或模拟器。这个类提供了安装和卸载程序包，启动一个活动以及发 送键盘或触摸事件到应用程序的方法。也可以使用这个类来运行测试包。 MonkeyImage：捕捉屏幕图像。这个类提供了用于捕获屏幕，转换位图图像，以各种格式，比较 两个 MonkeyImage 对象，写一个图像文件的方法。 在一个 Python 程序，可以访问 Python 模块中的每个类。monkeyrunner 工具不会自动导入这些 #导入 monkeyrunner 应用程序接口 MonkeyRun
12、ner, MonkeyDevice from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice #连接当前设备，并创建 MonkeyDevice 对象 device = MonkeyRunner.waitForConnection() # 安装 apk.该方法返回值类型为布尔型 # 查看应用是否安装成功 device.installPackage(myproject/bin/MyApplication.apk) # 设置一个变量用来保存 apk 的内部名称 package = com.example.android.myapp
13、lication # 设置一个变量用来保存 apk 中的关键活动名称 activity = com.example.android.myapplication.MainActivity # 设置一个变量用来保存开始活动的运行组件名称 runComponent = package + / + activity #运行 apk 中指定的关键活动 device.startActivity(component=runComponent) # 按下菜单按钮 device.press(KEYCODE_MENU, MonkeyDevice.DOWN_AND_UP) # 获取结果截屏图片 result = d
14、evice.takeSnapshot() #保存截屏图片到指定文件夹，图片格式为 png result.writeToFile(myproject/shot1.png,png) 模块。要导入模块，使用 Python 的语句： 其中是要导入的类名。可以通过用逗号分隔的模块名称，导入多个模块的声明。 1.4 运行运行 monkeyrunner 可以从一个文件运行 monkeyrunner 程序，也可以在交互式会话中输入 monkeyrunner 语句。可 以通过调用它在 SDK 目录的 tools/子目录中的 monkeyrunner 命令一起实现。如果提供一个文件名作 为参数，则 monkeyr
15、unner 命令运行作为一个 Python 程序文件的内容;否则，它会启动一个交互式会 话。 Monkeyrunner 命令的语法： 表 1 对命令航中的标记和参数进行了解释： 表 1 monkeyrunner 标记和参数 参数说明 -plugin （可选）指定包含 monkeyrunner 插件的.jar 文件中。 要了解更多关于 monkeyrunner 插件，请参阅使用插件 扩展 monkeyrunner。要指定多个文件，多个参数。 如果提供此参数，monkeyrunner 命令运行 Python 程序 的内容。如果不提供的参数，命令启动一个交互式会 话。 （可选）在程序中的标志和参数。
16、 1.5 monkeyrunner 内建帮助内建帮助 生成运行 monkeyrunner 的 API 参考： 参数： 可以是纯文本输出或 HTM 输出。 输出到指定路径下的文件 1.6 扩展扩展 monkeyrunner 插件插件 可以扩展 monkeyrunner API 的类，通过 java 编程构建一个或多个.jar 文件。可以使 用此功能，扩展 monkeyrunner API 用自己编写的类或扩展现有的类。也可以使用此功能 from com.android.monkeyrunner import monkeyrunner -plugin monkeyrunner help.py 来初始化 monkeyrunner 环境。 为了提供一个插件给 monkeyrunner，可以调用与表 1 描述的-plugin monkeyrunner 命令。 在插件代码，可以导入和扩展在 com.android.monkeyrunner 中的主要类： MonkeyDevice,、MonkeyImage
