到顶部
Android API
公众的

仪表

延伸对象
java.lang.Object(java.lang.对象)
   ↳ android应用程序。仪表
已知的直接子类

课程概述

用于实现应用程序检测代码的基类。运行时打开检测后,将为您实例化该类在任何应用程序代码之前,允许您监视系统与应用程序的交互。仪器通过AndroidManifest.xml的<instrumentation>标记。

总结

内部类
仪表。活动监视器 关于被监控的特定类型意图的信息。 
仪表。活动结果 要返回原始的“活动”执行结果的描述活动。 
常量
字符串 报告_关键字_标识符 如果包含在发送给IInstrumentationWatcher的状态或最终包中,则此键标识正在编写报告的类。
字符串 报告关键结果 如果包含在发送给IInstrumentationWatcher的状态或最终包中,则此键标识可以简单地打印到输出流的字符串。
公共建筑商
仪表()
公共方法
仪表。活动监视器 添加监视器(意向筛选器过滤器,仪表。活动结果结果,布尔块)
方便的包装addMonitor(活动监视器)那个创建意向过滤器匹配仪表。活动监视器为您和返回它。
无效 添加监视器(仪表。活动监视器监视器)
添加新的仪表。活动监视器每当活动已启动。
仪表。活动监视器 添加监视器(字符串cls(cls)、,仪表。活动结果结果,布尔块)
方便的包装addMonitor(活动监视器)那个创建一个类匹配仪表。活动监视器并将其返回。
无效 创建时调用活动(活动活动性,捆绑冰柱)
执行活动的调用onCreate(捆绑包)方法。
无效 销毁时调用活动(活动活动)
无效 新意向上的呼叫活动(活动活动,意图意图)
执行活动的调用onNewIntent(意向)方法。
无效 暂停时调用活动(活动活动)
执行活动的调用onPause()方法。
无效 创建后调用活动(活动活动,捆绑冰柱)
执行活动的调用onPostCreate(捆绑包)方法。
无效 重启时调用活动(活动活动)
执行活动的调用重新启动()方法。
无效 恢复实例状态时调用活动(活动活动,捆绑savedInstanceState)
执行活动的调用onRestoreInstanceState(捆绑包)方法。
无效 继续时调用活动(活动活动)
执行活动的调用onResume()方法。
无效 调用保存实例状态的活动(活动活动,捆绑outState)
执行活动的调用onPause()方法。
无效 开始时调用活动(活动活动)
执行活动的调用启动()方法。
无效 停止时调用活动(活动活动)
执行活动的调用on停止()方法。
无效 用户离开时调用活动(活动活动)
执行活动的调用onUserLeaveHint()方法。
无效 创建时调用应用程序(应用程序应用程序)
执行应用程序的调用创建时()方法。
布尔值 检查监视器命中(仪表。活动监视器监视器,int minHits)
测试现有仪表。活动监视器已被击中。
无效 结束性能快照()
无效 完成(int结果代码,捆绑结果)
终止应用程序的检测。
捆绑 获取分配计数()
返回一个捆绑包,其中包含分配计数的当前结果。
捆绑 获取活页夹计数()
返回一个捆绑包,其中包含此进程的各种活页夹计数。
组件名称 获取组件名称()
返回此检测的完整组件名称。
上下文 获取上下文()
返回此检测程序包的上下文。
上下文 获取目标上下文()
返回要检测的目标应用程序的上下文。
Ui自动化 getUi自动化()
获取Ui自动化例如。
布尔值 invokeContextMenuAction(调用上下文菜单操作)(活动targetActivity,int id,int标志)
显示当前焦点视图的上下文菜单并执行特定上下文菜单项。
布尔值 调用菜单操作同步(活动targetActivity,int id,int标志)
执行特定菜单项。
布尔值 is分析()
检查此检测是否在启用分析的情况下启动。
活动 新建活动(类装载器氯,字符串类名称,意图意图)
执行进程的实例化活动对象。
活动 新建活动(等级<?> 咔哒声,上下文上下文,I指示器令牌,应用程序应用程序,意图意图,活动信息信息,字符序列标题,活动起源,字符串身份证件,对象最后一个非配置实例)
执行实例化活动对象。
应用程序 新建应用程序(类装载器氯,字符串类名称,上下文上下文)
执行流程的实例化应用程序对象。
静止的应用程序 新建应用程序(等级<?> 咔哒声,上下文上下文)
执行进程的实例化应用程序对象。
无效 创建时的回调函数(捆绑参数)
在启动检测时,在任何应用程序代码之前调用已加载。
无效 销毁()
在所有发生了正常的应用程序清理。
布尔值 on异常(对象对象,可抛出e)
只要系统捕获未处理的异常被应用程序引发。
无效 启动时()
检测线程进入执行的方法。
无效 删除监视器(仪表。活动监视器监视器)
无效 运行于主同步(可运行转轮)
在应用程序的主线程上执行调用,一直阻塞到完成。
无效 发送字符同步(int keyCode)
用于发送的向下和向上键事件的高级方法特定字符键代码。
无效 sendKeyDownUpSync(int键)
向当前关注的窗口发送上下键事件同步。
无效 发送密钥同步(键盘事件事件)
将关键事件发送到当前关注的窗口/视图并等待被处理。
无效 发送指针同步(动议事件事件)
调度指针事件。
无效 发送状态(int结果代码,捆绑结果)
提供有关应用程序的状态报告。
无效 sendStringSync(发送字符串同步)(字符串文本)
将与文本对应的关键事件发送到应用程序已检测。
无效 sendTrackball事件同步(动议事件事件)
发送轨迹球事件。
无效 设置自动性能快照()
无效 设置InTouchMode(布尔inTouch)
强制全球系统进入或脱离接触模式。
无效 开始()
创建并启动要在其中运行检测的新线程。
活动 启动活动同步(意图意图)
开始一个新活动,等待它开始运行后再返回。
无效 启动分配计数()
无效 启动性能快照()
无效 启动配置文件()
如果isProfiling()返回true,则此方法将开始分析。
无效 停止分配计数()
无效 停止分析()
如果isProfiling()返回true,则停止分析。
无效 等待空闲(可运行收件人)
为应用程序的主线程空闲时调度回调(没有更多要处理的事件)。
无效 等待IdleSync()
同步等待应用程序空闲。
活动 等待监视器(仪表。活动监视器监视器)
等待现有仪表。活动监视器被击中。
活动 等待监视器超时(仪表。活动监视器监视器,长时间输出)
等待现有仪表。活动监视器直到超时到期。
[展开]
继承的方法
来自班级java.lang.Object对象

常量

公众静态最终的字符串 报告_关键字_标识符

已在中添加API级别1

如果包含在发送给IInstrumentationWatcher的状态或最终包中,则此键标识正在编写报告的类。这可以用于提供更结构化的IInstructionWatcher中的日志记录或报告功能。

常量值: “id”

公众静态最终的字符串 报告关键结果

已在中添加API级别1

如果包含在发送给IInstrumentationWatcher的状态或最终包中,则此键标识可以简单地打印到输出流的字符串。使用这些流提供状态和最终数据包的“漂亮的打印机”版本。任何捆绑包,包括该键还应该包括完整的一组原始键/值对,以便还可以通过自动化系统启动检测并收集结果。

常量值: “流”

公共建筑商

公众的 仪表 ()

已在中添加API级别1

公共方法

公众的仪表。活动监视器 添加监视器 (意向筛选器过滤器,仪表。活动结果结果,布尔块)

已在中添加API级别1

方便的包装addMonitor(活动监视器)那个创建意向过滤器匹配仪表。活动监视器为您和返回它。

参数
滤波器 这个监视器负责的一组意图。
结果 如果显示器被击中,将返回一个预设结果;可以为空。
控制监视器是否应阻止活动开始(返回预设结果)或让呼叫继续。
退换商品
  • 新创建和添加的活动监控器。

公众无效 添加监视器 (仪表。活动监视器监视器)

已在中添加API级别1

添加新的仪表。活动监视器每当活动已启动。添加监视器在任何现有的之后;只有当没有现有监控器可以自己处理Intent。

参数
班长 要查看的新ActivityMonitor。

公众的仪表。活动监视器 添加监视器 (字符串cls中,仪表。活动结果结果,布尔块)

已在中添加API级别1

方便的包装addMonitor(活动监视器)那个创建一个类匹配仪表。活动监视器并将其返回。

参数
cls公司 此监视器负责的活动类。
结果 如果显示器被击中,将返回一个预设结果;可以为空。
控制监视器是否应阻止活动开始(返回预设结果)或让呼叫继续。
退换商品
  • 新创建和添加的活动监控器。

公众无效 创建时调用活动 (活动活动,捆绑冰柱)

已在中添加API级别1

执行活动的调用onCreate(捆绑包)方法。默认实现只调用该方法。

参数
活动 正在创建的活动。
冰柱 要传递到的先前冻结状态(或null)创建时()。

公众无效 销毁时调用活动 (活动活动)

已在中添加API级别1

公众无效 新意向上的呼叫活动 (活动活动,意图意图)

已在中添加API级别1

执行活动的调用onNewIntent(意向)方法。默认实现只是直接调用该方法。

参数
活动 收到新意向的活动。
意图 收到的新意图。

公众无效 暂停时调用活动 (活动活动)

已在中添加API级别1

执行活动的调用onPause()方法。这个默认实现只调用该方法。

参数
活动 正在暂停的活动。

公众无效 创建后调用活动 (活动活动,捆绑冰柱)

已在中添加API级别1

执行活动的调用onPostCreate(捆绑包)方法。默认实现只调用该方法。

参数
活动 正在创建的活动。
冰柱 要传递到的先前冻结状态(或null)在PostCreate()上。

公众无效 重启时调用活动 (活动活动)

已在中添加API级别1

执行活动的调用重新启动()方法。默认实现只调用该方法。

参数
活动 正在重新启动的活动。

公众无效 恢复实例状态时调用活动 (活动活动,捆绑savedInstanceState)

已在中添加API级别1

执行活动的调用onRestoreInstanceState(捆绑包)方法。默认实现只调用该方法。

参数
活动 正在恢复的活动。
倚仗 正在还原以前保存的状态。

公众无效 继续时调用活动 (活动活动)

已在中添加API级别1

执行活动的调用onResume()方法。这个默认实现只调用该方法。

参数
活动 正在恢复的活动。

公众无效 调用保存实例状态的活动 (活动活动,捆绑outState)

已在中添加API级别1

执行活动的调用onPause()方法。这个默认实现只调用该方法。

参数
活动 正在保存的活动。
out州 要传递给调用的包。

公众无效 启动时调用活动 (活动活动)

已在中添加API级别1

执行活动的调用启动()方法。默认实现只调用该方法。

参数
活动 正在启动的活动。

公众无效 停止时调用活动 (活动活动)

已在中添加API级别1

执行活动的调用on停止()方法。默认实现只调用该方法。

参数
活动 正在停止的活动。

公众无效 用户离开时调用活动 (活动活动)

执行活动的调用onUserLeaveHint()方法。默认实现只调用该方法。

参数
活动 通知用户已离开的活动

公众无效 创建时调用应用程序 (应用程序应用程序)

已在中添加API级别1

执行应用程序的调用创建时()方法。默认实现只调用该方法。

注意:此方法将在onCreate(捆绑包).通常,指令插入测试在onCreate()中启动其测试线程;需要小心这两者之间的竞争。(介于两者之间其他的,但让我们从这里开始。)

参数
应用程序 正在创建的应用程序。

公众布尔值 检查监视器命中 (仪表。活动监视器监视器,int minHits)

已在中添加API级别1

测试现有仪表。活动监视器已被击中。如果监视器至少被击中最小点击数时间,那么它就会从活动监视器列表中删除并返回true。否则,它保留为-is,返回false。

参数
班长 要检查的ActivityMonitor。
最小点击数 所需的最小点击数。
退换商品
  • 如果已达到命中次数,则为True,否则为false。

公众无效 结束性能快照 ()

已在中添加API级别1

公众无效 完成 (int结果代码,捆绑结果)

已在中添加API级别1

终止应用程序的检测。这将导致退出应用程序进程,从下一个应用程序启动的时间。

参数
结果代码 仪器的总体成功/失败。
结果 要发送回启动仪器。

公众的捆绑 获取分配计数 ()

已在中添加API级别1

返回一个包含分配计数的当前结果的捆绑包。

公众的捆绑 获取活页夹计数 ()

已在中添加API级别1

返回一个捆绑包,其中包含此进程的各种活页夹计数。目前只有两个报告的是发送的数量和接收的事务数量。

公众的组件名称 获取组件名称 ()

已在中添加API级别1

返回此检测的完整组件名称。

退换商品
  • 返回此检测的完整组件名称。

公众的上下文 获取上下文 ()

已在中添加API级别1

返回此检测程序包的上下文。请注意,这是通常与应用程序的上下文不同检测,因为检测代码通常存在于与运行它的应用程序的包不同。请参见获取目标上下文()检索目标的上下文应用程序。

退换商品
  • 检测的包上下文。

公众的上下文 获取目标上下文 ()

已在中添加API级别1

返回要检测的目标应用程序的上下文。注释这通常与检测的上下文不同代码,因为指令插入代码通常是一个不同的包而不是它所针对的应用程序。请参见获取上下文()检索检测代码的上下文。

退换商品
  • 目标应用程序中的上下文。
另请参见

公众的Ui自动化 getUi自动化 ()

已在中添加API等级18

获取Ui自动化例如。

注:通过返回的Ui自动化跨应用程序边界工作,同时检测所公开的API不要。例如,发送指针同步(MotionEvent)不允许在与检测不同的应用程序中注入事件目标,同时injectInputEvent(android.view.InputEvent,布尔值)无论当前应用程序如何,都可以运行。

典型的测试用例应该使用Ui自动化仪表API。不能同时使用这两个API这本身就是一个错误,但客户端必须了解API的限制。

退换商品
  • UI自动化实例。
另请参见

公众布尔值 invokeContextMenuAction(调用上下文菜单操作) (活动targetActivity,int id,int标志)

已在中添加API级别1

显示当前焦点视图的上下文菜单并执行特定上下文菜单项。

参数
目标活动 有问题的活动。
身份证件 与上下文菜单项关联的标识符。
旗帜 其他标志(如果有)。
退换商品
  • 调用是否成功(例如,可以是如果项被禁用,则返回false)。

公众布尔值 调用菜单操作同步 (活动targetActivity,int id,int标志)

已在中添加API级别1

执行特定菜单项。

参数
目标活动 相关活动。
身份证件 与菜单项关联的标识符。
旗帜 其他标志(如果有)。
退换商品
  • 调用是否成功(例如,可以是如果项被禁用,则返回false)。

公众布尔值 is分析 ()

已在中添加API级别1

检查此检测是否在启用分析的情况下启动。

退换商品
  • 如果启动时启用了分析,则返回true,否则返回false。

公众的活动 新建活动 (类装载器氯,字符串类名称,意图意图)

已在中添加API级别1

执行进程的实例化活动对象。这个默认实现提供正常的系统行为。

参数
用于实例化对象的ClassLoader。
类名 实现“活动”的类的名称对象。
意图 指定活动类的Intent对象实例化。
退换商品
  • 新实例化的Activity对象。

公众的活动 新建活动 (等级<?> 咔哒声,上下文上下文,I指示器令牌,应用程序应用程序,意图意图,活动信息信息,字符序列标题,活动起源,字符串身份证件,对象最后一个非配置实例)

已在中添加API级别1

执行的实例化活动对象。此方法用于单元测试,如android.test。活动单元测试用例。活动将可用但将缺少系统内使用的一些必要链接。

参数
发出咔哒声 所需活动的类别
上下文 要使用的活动的基本上下文
代币 用于与此活动通信的令牌
应用 应用程序对象(如果有)
意图 启动此活动的意图
信息 清单中的ActivityInfo
标题 标题,通常从ActivityInfo记录中检索
起源 父活动(如果有)
身份证件 嵌入的Id(如果有)
最后一个非配置实例 将成为通过提供Activity.getLastNonConfigurationInstance().
退换商品
  • 返回实例化的活动
投掷
实例化异常
非法访问例外
实例化异常

公众的应用程序 新建应用程序 (类装载器氯,字符串类名称,上下文上下文)

已在中添加API级别1

执行进程的实例化应用程序对象。这个默认实现提供了正常的系统行为。

参数
用于实例化对象的ClassLoader。
类名 实现应用程序的类的名称对象。
上下文 用于初始化应用程序的上下文
退换商品
  • 新实例化的Application对象。

公众静止的应用程序 新建应用程序 (等级<?> 拍手,上下文上下文)

已在中添加API级别1

执行进程的实例化应用程序对象。这个默认实现提供正常的系统行为。

参数
发出咔哒声 用于从中创建Application对象的类。
上下文 用于初始化应用程序的上下文
退换商品
  • 新实例化的Application对象。

公众无效 创建时的回调函数 (捆绑参数)

已在中添加API级别1

在启动检测时,在任何应用程序代码之前调用已加载。通常,这将实现为只调用启动()开始检测线程,然后在中继续执行启动().

如果你不需要自己的线程,那就是你正在写检测完全异步(返回事件循环,以便应用程序可以运行),只需开始此处插入指令,例如调用启动活动(意向)开始应用程序的适当第一个活动。

参数
论据 检测已启动。

公众无效 销毁 ()

已在中添加API级别1

在所有发生了正常的应用程序清理。

公众布尔值 on异常 (对象对象,可抛出e)

已在中添加API级别1

只要系统捕获未处理的异常被应用程序引发。默认实现只是返回false,允许对异常进行正常的系统处理地点。

参数
对象 生成异常的客户端对象。可能是一个应用程序、活动、BroadcastReceiver、服务或null。
e(电子) 引发的异常。
退换商品
  • 要允许正常的系统异常过程发生,请返回false。如果返回true,系统将像异常一样继续没有发生。

公众无效 启动时 ()

已在中添加API级别1

检测线程进入执行的方法。这允许您可以在一个单独的线程中运行检测代码,而不是应用程序,以便它可以执行阻塞操作,例如sendKeySync(KeyEvent)startActivitySync(意向).

当这个函数完成时,通常需要调用finish(),结束你的仪器。

公众无效 删除监视器 (仪表。活动监视器监视器)

已在中添加API级别1

公众无效 运行于主同步 (可运行转轮)

已在中添加API级别1

在应用程序的主线程上执行调用,一直阻塞到完成。对于做一些不安全的事情很有用,例如查看或修改视图层次结构。

参数
跑步者 要在主线程上运行的代码。

公众无效 发送字符同步 (int keyCode)

已在中添加API级别1

用于发送的向下和向上键事件的高级方法特定字符键代码。相当于创建两个KeyEvent手动和调用对象sendKeySync(KeyEvent)。事件出现就像它来自于键盘0,内置的一个。

参数
keyCode(密钥代码) 要发送的字符的键代码。

公众无效 sendKeyDownUpSync (int键)

已在中添加API级别1

向当前关注的窗口发送上下键事件同步。

参数
钥匙 事件的整数键码。

公众无效 发送密钥同步 (键盘事件事件)

已在中添加API级别1

将关键事件发送到当前关注的窗口/视图并等待被处理。收件人返回后某个时间完成尽管它可能完全拥有已完成对事件的响应--例如,如果需要更新因此,它可能仍在进行显示。

参数
事件 要发送到当前焦点的事件。

公众无效 发送指针同步 (动议事件事件)

已在中添加API级别1

调度指针事件。在收件人完成从其事件处理中返回,尽管它可能完全完成对事件的反应——例如,如果需要因此,要更新其显示,它可能仍在这样做。

参数
事件 描述指针动作的运动事件。(如中所述获取(long、long、int、float、float,int),请务必使用正常运行时间Millis()作为时间基准。

公众无效 发送状态 (int结果代码,捆绑结果)

已在中添加API级别1

提供有关应用程序的状态报告。

参数
结果代码 当前检测成功/失败。
结果 要发送回启动检测的代码的任何结果。

公众无效 sendStringSync(发送字符串同步) (字符串文本)

已在中添加API级别1

将与文本对应的关键事件发送到应用程序已检测。

参数
文本 要发送的文本。

公众无效 sendTrackball事件同步 (动议事件事件)

已在中添加API级别1

发送轨迹球事件。在收件人完成从其事件处理中返回,尽管它可能完全完成对事件的反应——例如,如果需要因此,要更新其显示,它可能仍在这样做。

参数
事件 描述轨迹球动作的运动事件。(如中所述获取(long、long、int、float、float,int),请务必使用正常运行时间Millis()作为时间基准。

公众无效 设置自动性能快照 ()

已在中添加API级别1

公众无效 设置InTouchMode (布尔inTouch)

已在中添加API级别1

强制全球系统进入或脱离接触模式。这可以用于以下情况您的指令插入依赖于一个或另一个中的UI当它开始的时候。

参数
inTouch(inTouch) 设置为true为接触模式,设置为false为接触模式焦点模式。

公众无效 开始 ()

已在中添加API级别1

创建并启动要在其中运行检测的新线程。这个新的线程将调用启动()您可以在其中实现仪器。

公众的活动 启动活动同步 (意图意图)

已在中添加API级别1

开始一个新活动,等待它开始运行后再返回。除了同步之外,此方法还具有一些语义与标准的差异启动活动(意向)呼叫:在与活动管理器对话之前解决活动组件(其类名在该方法最终的意图中指定启动),并且它不允许您启动在不同的过程。此外,如果给定意图决定多个活动,而不是为用户显示一个对话框选择一个活动,将引发异常。

一旦活动空闲,函数就会返回调用其onCreate(捆绑包)一般来说,这意味着它已经消失了通过完整的初始化,包括onResume()绘制并显示其初始窗口。

参数
意图 要开始的活动的描述。

公众无效 启动分配计数 ()

已在中添加API级别1

公众无效 启动性能快照 ()

已在中添加API级别1

公众无效 启动配置文件 ()

已在中添加API级别1

如果isProfile()返回true,则此方法将开始分析。你应该只有在将此检测的清单文件设置为true。

公众无效 停止分配计数 ()

已在中添加API级别1

公众无效 停止分析 ()

已在中添加API级别1

如果isProfiling()返回true,则停止分析。

公众无效 等待空闲 (可运行收件人)

已在中添加API级别1

为应用程序的主线程空闲时调度回调(没有更多的事件要处理)。

参数
收件人 下次线程的消息队列空闲。

公众无效 等待IdleSync ()

已在中添加API级别1

同步等待应用程序空闲。无法调用从主应用程序线程--使用启动()执行在自己的线程中插入指令。

公众的活动 等待监视器 (仪表。活动监视器监视器)

已在中添加API级别1

等待现有仪表。活动监视器被击中。一旦监视器被击中,它将从活动监视器列表中删除,并且返回与之匹配的第一个创建的Activity对象。

参数
班长 要等待的ActivityMonitor。
退换商品
  • 与监视器匹配的Activity对象。

公众的活动 等待监视器超时 (仪表。活动监视器监视器,长时间输出)

已在中添加API级别1

等待现有仪表。活动监视器直到超时到期。一旦监视器被击中,它就会从活动中删除监视器列表和与之匹配的第一个创建的Activity对象是返回。如果超时过期,则返回空对象。

参数
班长 要等待的ActivityMonitor。
超时 超时值(秒)。
退换商品
  • 与监视器匹配的“活动”对象。