monkeyrunner学习笔记（1）- monkeyrunner入门

monkeyrunner简介

• monkeyrunner工具提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。
• 主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件
• 在工作站上通过API定义的特定命令和事件控制设备或模拟器。
• 与monkey工具无关monkeyrunner工具使用Jython，你可以通过Python语法访问API中的常量、类和方法monkeyrunner工具使用Jython，你可以通过Python语法访问API中的常量、类和方法
  • monkey直接运行于设备或模拟器的adb shell，生成用户或系统事件的伪随机流
  • monkeyrunner则从workstation通过api发送特定命令和事件来控制设备或模拟器
• monkeyrunner工具使用Jython，你可以通过Python语法访问API中的常量、类和方法

monkeyrunner测试类型

1. 多设备控制：monkeyrunner API可以将一个或多个测试套件（test suites）应用于多台设备。功能测试： monkeyrunner可以为一个应用自执行从头到尾的自动化测试。功能测试： monkeyrunner可以为一个应用自执行从头到尾的自动化测试。
   • 设备可以是通过物理连接在一起，也可以是同时启动所有的模拟器，或者是两者的混合
   • 通过程序控制依次进行连接，然后运行一个或多个测试
2. 功能测试： monkeyrunner可以为一个应用自执行从头到尾的自动化测试。
3. 回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。
4. 可扩展的自动化：monkeyrunner 是一个api工具包，你自己可以开发一套基于python模块和程序的系统，来控制Android设备。
   • 可以使用标准的Python os和subprocess模块来调用Android Debug Bridge这样的Android工具。
   • 可以为monkeyrunner API添加自己的类

一个简单的monkeyrunner程序

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage

#returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection() 

#returns a boolean
device.installPackage(r‘C:\Users\Administrator\Desktop\mrtest\demo.apk‘)

#Runs the component
device.startActivity(component=‘com.example.android.apis/.ApiDemos‘)
#sleep 3 seconds
MonkeyRunner.sleep(3)
device.press(‘KEYCODE_HOME‘, MonkeyDevice.DOWN_AND_UP)

result = device.takeSnapshot()
result.writeToFile(r‘C:\Users\Administrator\Desktop\mrtest\shot1.png‘, ‘png‘)

MonkeyRunner.alert("Test Completed!", "alert", "ok") 

monkeyrunner运行

两种运行方式：
1. 提供一个py文件作为运行参数，则monkeyrunner将视文件内容为Python程序运行 
2. 不加py文件参数，则monkeyrunner会启动一个交互会话（interactive session）
两种方法都需要调用SDK目录tools子目录下的monkeyrunner

monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>