Monkeyrunner（2） API帮助文档

1、com.android.monkeyrunner.MonkeyRunner.alert
  当前脚本的运行过程中显示警告对话框。对话框是模态，因此脚本停止，直到用户关闭对话框。
  

  参数：
    消息 - 消息显示在对话框。
    标题 - 对话框的标题。默认值是“提醒”。
    okTitle - 使用对话框中的按钮的文本。默认值是“OK”。
  返回：返回任何内容。

2、com.android.monkeyrunner.MonkeyDevice.broadcastIntent
  发送一个广播设备的意图。
  

  参数：
    URI - 意图的URI。
    行动 - 该行动的意图。
    数据 - 数据的URI意图
    的mimetype - mime类型的意图。
    类别 - 迭代的意图类别名称。
    演员 - 一个额外的字典添加到意图。这些额外的类型推断的值的Python类型。
    组件 - 组件的意图。
    标志 - 一个迭代的标志为Intent.All参数是可选的。每个参数的默认值是null。（见android.content.Context.sendBroadcast（意向））
  返回：返回任何内容。

3、com.android.monkeyrunner.MonkeyRunner.choice
  显示一个选择对话框，允许用户选择从一个单一的项目，一个项目清单。
  

  参数：
    消息 - 提示信息显示在对话框。
    选择 - 一个可迭代的Python类型的选择列表显示
    标题 - 对话框的标题。默认的是“输入”
  返回：所选项目的抵消了Iterable基于0的数字。

4、com.android.monkeyrunner.MonkeyImage.convertToBytes
  转换成一个特定格式的MonkeyImage作为一个字符串返回结果。使用此获得rawpixels在一个特定的格式。字符串输出是有更好的表现。
  

  参数：
    格式 - 目标格式（例如，“PNG便携式网络图形格式）。默认为PNG。
  返回：一个String生成的图像。

5、com.android.monkeyrunner.MonkeyDevice.drag
  模拟设备屏幕上拖动（触摸，持有和移动）。
  

  参数：
    开始 - 拖动起点（以像素为单位元组（X，Y））
    结束 - 阻力终点（以像素为单位元组（X，Y）
    时间 - 在几秒钟内拖时间（默认为1.0秒）
    步骤 - 插值点时要采取的步骤。 （默认是10）
  返回：返回任何内容。

6、com.android.monkeyrunner.MonkeyView.getAccessibilityIds
  返回当前视图的辅助IDS
  

  返回：视图的辅助IDS作为一个整数列表

7、com.android.monkeyrunner.MonkeyRect.getCenter
  返回一个两个项目清单，其中包含矩形的中心的x和y的值
  

  返回：该中心作为一个整数的两个项目清单坐标

8、com.android.monkeyrunner.MonkeyView.getChecked
  获取视图的选中状态
  

  返回：一个布尔值，该项目是否被选中或不

9、com.android.monkeyrunner.MonkeyView.getChildren
  返回当前视图的孩子们
  

  返回：认为儿童MonkeyView对象名单

10、com.android.monkeyrunner.MonkeyView.getEnabled
  返回启用状态的看法。
  

  返回：作为一个布尔启用状态

11、com.android.monkeyrunner.MonkeyView.getFocused
  视图返回集中状态
  

  返回：集中的状态作为一个布尔

12、com.android.monkeyrunner.MonkeyRect.getHeight
  返回矩形的高度。
  

  返回：作为一个整数的矩形的高度

13、com.android.monkeyrunner.MonkeyDevice.getHierarchyViewer
  获取设备HierarchyViewer对象。
  

  返回一个HierarchyViewer对象

14、com.android.monkeyrunner.MonkeyView.getLocation
  返回视图的位置在一个MonkeyRect形式
  

  返回：视图作为MonkeyRect对象的位置

15、com.android.monkeyrunner.MonkeyView.getParent
  返回当前视图的父
  

  返回：视图的父作为MonkeyView对象

16、com.android.monkeyrunner.MonkeyDevice.getProperty
  由于设备上的变量的名称，返回变量的值
  

  参数：
    关键 - 变量的名称。可用的名称在http://developer.android.com/guide/topics/testing/monkeyrunner.html上市。
  返回：该变量的值

17、com.android.monkeyrunner.MonkeyDevice.getPropertyList
  检索，可以查询的属性
  

  返回：返回任何内容。

18、com.android.monkeyrunner.MonkeyImage.getRawPixel
  一个单一的ARGB（alpha，红色，绿色，蓝色）像素位置的X，Y。参数X和Y是0，表示在像素尺寸。 X增加的权利，对底部的Y增加。此方法返回一个tuple。
  

  参数：
    X - x偏移的像素
    Y - 像素的y偏移量
  返回的元组（一R，G，B）的像素。 tuple中的每个项目都有0-255范围内。

19、com.android.monkeyrunner.MonkeyImage.getRawPixelInt
  一个单一的ARGB（alpha，红色，绿色，蓝色）像素位置的X，Y。参数X和Y是0，表示在像素尺寸。 X增加的权利，对底部的Y增加。此方法返回一个整数。
  

  参数：
    X - x偏移的像素
    Y - 像素的y偏移量
  返回：X，Y的无符号整数像素。高阶8位是A，followedby 8位为R，G和8 8为B

20、com.android.monkeyrunner.MonkeyDevice.getRootView
  获取当前根视图
  

  返回：根视图对象

21、com.android.monkeyrunner.MonkeyView.getSelected
  返回视图的选中状态
  

  返回：作为一个布尔选中状态

22、com.android.monkeyrunner.MonkeyImage.getSubImage
  复制图像的矩形区域。
  

  参数：
    矩形 - 一个元组（X，Y，W，H），说明该地区复制。 x和y指定上左边角落的区域。 w是该地区的像素宽度，h是它的高度。
  返回：MonkeyImage对象代表复制的区域。

23、com.android.monkeyrunner.MonkeyDevice.getSystemProperty
  代名词的getProperty（）
  

  参数：
    关键 - 系统变量的名称。
  返回：该变量的值。

24、com.android.monkeyrunner.MonkeyView.getText
  返回视图所载文本
  

  返回：在视图中的文本

25、com.android.monkeyrunner.MonkeyDevice.getViewByAccessibilityIds
  获得指定的无障碍标识的看法。
  

  参数：
    windowId - 视图来检索窗口的ID。
    无障碍标识 - 辅助视图来检索标识。
  返回：具有指定ID的视图对象。

26、com.android.monkeyrunner.MonkeyDevice.getViewById
  取得具有指定id的观点。
  

  参数：
    ID - ID的视图来检索。
  返回：具有指定ID的视图对象。

27、com.android.monkeyrunner.MonkeyView.getViewClass
  返回视图类的名称。
  

  返回：类名作为一个字符串的看法

28、com.android.monkeyrunner.MonkeyDevice.getViewIdList
  检索当前应用程序的视图ID
  

  返回：返回任何内容。

29、com.android.monkeyrunner.MonkeyDevice.getViewsByText
  获得一个列表包含指定文本的意见。
  

  参数：
    文本 - 文本搜索
  返回：包含指定文本的视图对象的名单。

30、com.android.monkeyrunner.MonkeyRect.getWidth
  返回矩形的宽度。
  

  返回：作为一个整数的矩形的宽度

31、com.android.monkeyrunner.MonkeyRunner.help
  格式和API参考显示为MonkeyRunner的。
  

  参数：
    格式 - 输出所需的格式，无论是“文本”为纯文本或HTML标记的HTML“。
  返回：一个字符串，其中包含所需格式的帮助文本。

32、com.android.monkeyrunner.MonkeyRunner.input
  显示一个对话框，接受输入。对话框，模态，因此脚本停止，直到用户点击两个对话框按钮之一。输入一个值，用户输入的值，并单击“确定”按钮。要退出，而无需输入一个值对话框，用户点击“取消”按钮。使用这种方法提供的参数来定制这些按钮的文本。
  

  参数：
    消息 - 提示信息显示在对话框。
    初值 - 提供给用户的初始值。默认是一个空字符串）
    标题 - 对话框的标题。默认的是“输入”
    okTitle - 文本中使用对话框的确认按钮。默认的是“OK”。文本中使用对话框的“取消”按钮。默认是“取消”。
    cancelTitle - 
  返回：测试用户，或没有输入，如果用户取消了输入;

33、com.android.monkeyrunner.MonkeyDevice.installPackage
  设备安装到指定的Andr​​oid包（。apk文件）。如果设备上已经存在的包，它会被替换。
  

  参数：
    路径 - 包的主机上的文件系统路径和文件名。
  返回：如果安装成功

34、com.android.monkeyrunner.MonkeyDevice.instrument
  与仪器仪表运行指定的包，并返回它产生的输出。使用此运行测试包使用InstrumentationTestRunner。
  

  参数：
    的className - 类运行仪表。格式是软件包名/类名。使用软件包名来指定运行，Android包和类名来指定运行该包内的类。对于测试包，这是通常35、testpackagename / InstrumentationTestRunner
    参数 - 包含参数传递给这个仪器（默认值是“无”）的对象映射到一个字符串。
  返回：一个字符串映射到从包中输出的对象。对于一个测试包，包含一个单一的键 - 值对：关键是'流'的值是一个字符串，其中包含测试输出。

35、com.android.monkeyrunner.MonkeyRunner.loadImageFromFile
  加载文件MonkeyImage。
  

  参数：
    路径 - 要加载的文件的路径。该文件的路径是在计算机上运行MonkeyRunner，而不是在Android设备上的路径。
  返回值：一个的新MonkeyImage代表指定的文件

36、com.android.monkeyrunner.MonkeyDevice.press
  发送到指定键的一个关键事件
  

  参数：
    名称 - 键的键码按（见android.view.KeyEvent）
    如由TouchPressType（）返回的类型 - 触摸事件类型。为了模拟输入键，发送DOWN_AND_UP
  返回：返回任何内容。

37、com.android.monkeyrunner.MonkeyDevice.reboot
  重新引导到指定的引导程序指定的设备。
  

  参数：
    - 重启进入引导程序：引导程序，恢复，或没有
  返回：返回任何内容。

38、com.android.monkeyrunner.MonkeyDevice.removePackage
  从设备中删除指定的软件包，包括其相关的数据和高速缓存。
  

  参数：
    包 - 包的名字删除。
  返回：True如果删除成功

39、com.android.monkeyrunner.MonkeyImage.sameAs
  比较这MonkeyImage的对象aother MonkeyImage对象。
  

  参数：
    其他 - 其他MonkeyImage的对象。
    ％ - 一个在0.0到1.0的范围内浮动，说明需要是相同的方法，返回“真”的像素的百分比。默认为1.0。
  返回：布尔'真'，如果两个对象包含相同的图​​像。

40、com.android.monkeyrunner.MonkeyView.setFocused
  设置视图的集中状态
  

  参数：
    重点 - 布尔值设置集中到
  返回：返回任何内容。

41、com.android.monkeyrunner.MonkeyView.setSelected
  设置视图的选定状态
  

  参数：
    选择 - 布尔值设置选择
  返回：返回任何内容。

42、com.android.monkeyrunner.MonkeyDevice.shell
  执行一个adb shell命令，并返回结果，如果有的话。
  

  参数：
    CMD - adb shell命令来执行。
  返回：从命令的输出。

43、com.android.monkeyrunner.MonkeyRunner.sleep
  暂停目前正在运行的程序指定的秒数。
  

  参数：
    秒 - 暂停的秒数。
  返回：返回任何内容。

44、com.android.monkeyrunner.MonkeyDevice.startActivity
  开始从指定的参数构造一个Intent发送设备上的活动。
  

  参数：
    URI - 意图的URI。
    行动 - 该行动的意图。
    数据 - 数据的URI意图
    的mimetype - mime类型的意图。
    类别 - 一个Python迭代包含的意图类别名称。
    演员 - 一个额外的字典添加到意图。这些额外的类型推断的值的Python类型。
    组件 - 组件的意图。
    标志 - 一个迭代的标志为Intent.All参数是可选的。为每个参数的默认值是null。（见android.content.Intent）
  返回：返回任何内容。

45、com.android.monkeyrunner.MonkeyDevice.takeSnapshot
  获取设备的屏幕缓冲区，产生了整个显示器的屏幕捕获。
  

  返回：一个MonkeyImage对象（点阵图包装）

46、com.android.monkeyrunner.MonkeyDevice.touch
  在指定位置发送触摸事件
  
  参数：
    X - X坐标，以像素为单位
    Y - Y坐标，以像素为单位
    类型 - 触摸事件类型TouchPressType（返回）
  返回：返回任何内容。

47、com.android.monkeyrunner.MonkeyDevice.type
  键盘上的类型指定的字符串。这相当于要求每个字符串中的字符按（键码，DOWN_AND_UP）。
  
  参数：
    消息 - 字符串发送到键盘。
  返回：返回任何内容。

48、com.android.monkeyrunner.MonkeyRunner.waitForConnection
  等待工作站连接到设备。
  
  参数：
    超时 - 在几秒钟等待超时。默认是无限期地等待。
    的deviceid - 一个正则表达式指定的设备名称。看到开发指南，了解有关设备名称为“亚行”的文件。
  返回：一个ChimpDevice对象代表连接的设备。

49、com.android.monkeyrunner.MonkeyDevice.wake
  在设备屏幕上唤醒
  返回：返回任何内容。

50、com.android.monkeyrunner.MonkeyImage.writeToFile
  写文件MonkeyImage。如果没有指定格式，这种方法猜测输出格式的基础上提供的文件扩展名的扩展。如果是无法猜测的格式，它使用的PNG。
  

  参数：
    路径 - 输出文件名，也可以包括其路径
    格式 - 目标格式（例如，“PNG便携式网络图形格式。
  返回：Boolean如果写成功。

51、com.android.monkeyrunner.MonkeyDevice.type

   文本输入