全局测试实用程序界面，用于添加 IAbilityMonitor对象并控制功能的生命周期状态。
您可以调用 addAbilityMonitor（java.lang.String）来添加IAbilityMonitor对象，以监视指定功能的生命周期状态。您还可以调用诸如 triggerClickEvent（ohos.aafwk.ability.Ability，ohos.agp.components.Component）之类的方法来控制能力的生命周期状态并调度输入事件。
| 修饰符和类型 | 领域 | 描述 |
|---|---|---|
| 静态整数 | 活性 | 指示该能力处于活动状态。 |
| 静态整数 | 背景 | 指示该能力处于后台状态。 |
| 静态整数 | 不活跃 | 指示该能力处于非活动状态。 |
| 静态整数 | 初始 | 指示该能力处于初始状态。 |
| 静态整数 | 未定义 | 表示该能力的生命周期状态未定义。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| IAbilityMonitor | addAbilityMonitor（字符串abilityName） | 基于指定的功能名称创建 IAbilityMonitor对象，以监视功能的生命周期状态变化。 |
| void | clearAllMonitors（） | 清除保存在内存中的所有IAbilityMonitor对象。 |
| 整型 | getAbilitySliceState（AbilitySlicetargetSlice） | 获取指定能力切片的生命周期状态。 |
| 整型 | getAbilityState(Abilityability) | 获得指定能力的生命周期状态。 |
| List<AbilitySlice> | getAllAbilitySlice（(Abilityability) | 获取指定能力的所有能力切片。 |
| AbilitySlice | getCurrentAbilitySlice(Abilityability) | 获得指定能力的最高能力切片。 |
| Ability | getCurrentTopAbility（） | 获得当前正在显示的功能。 |
| 整型 | getMonitorsNum（） | 获取保存在内存中的IAbilityMonitor对象的总数。 |
| void | print(Stringmsg) | 将日志信息打印到单元测试控制台。 |
| void | removeAbilityMonitor（IAbilityMonitor监视器） | 从应用程序内存中删除指定的IAbilityMonitor对象。 |
| 布尔值 | runOnUIThreadSync(Runnabletask) | 在UI线程上运行指定的任务并阻塞线程，直到任务完成。 |
| Optional<Ability> | startAbilitySync(Intentintent) | 根据给定的Intent启动一项功能，并等待2秒钟以开始运行该功能，然后再返回。 |
| Optional<Ability> | startAbilitySync(Intentintent, long timeout) | 根据给定的Intent启动一项功能，并等待指定的时间段才能开始运行该功能，然后再返回。 |
| boolean | stopAbility(Abilityability) | 消灭指定的能力。 |
| boolean | triggerClickEvent(Abilityability, Componentview) | 将click事件调度到给定功能的指定Component对象，并等待对其进行处理。 |
| boolean | triggerKeyEvent(Abilityability, KeyEventkeyEvent) | 将按键事件分配给给定的功能，然后等待其处理。 |
| boolean | triggerTouchEvent(Abilityability, TouchEventtouchEvent) | 将触摸事件分配给给定的功能，然后等待其处理。 |
| Optional<Ability> | waitAbilityMonitor(IAbilityMonitormonitor) | 等待并返回与在给定IAbilityMonitor中设置的条件匹配的Ability对象。 |
| Optional<Ability> | waitAbilityMonitor(IAbilityMonitormonitor, long timeout) | 等待并返回与指定时间段内给定IAbilityMonitor中设置的条件匹配的Ability对象。 |
static final int有效
指示该能力处于活动状态。
也可以看看：
静态最终int背景
指示该能力处于后台状态。
也可以看看：
静态最终int不活动
指示该能力处于非活动状态。
也可以看看：
静态最终 int INITIAL
指示该能力处于初始状态。
也可以看看：
static final int 未定义
表示该能力的生命周期状态未定义。
也可以看看：
可选的< Ability> waitAbilityMonitor（IAbilityMonitor监视器）
等待并返回与在给定IAbilityMonitor中设置的条件匹配的Ability对象 。
如果成功获得匹配的能力，则指定的IAbilityMonitor对象将无效。否则，您可以继续在waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor）或waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor，long）中使用它以获得技能。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 监控 | 指示用于监视功能的生命周期状态变化的IAbilityMonitor对象。 |
返回值：
如果其生命周期状态已更改并且与给定监视器匹配，则返回包含Ability对象的Optional对象；否则返回一个空的Optional对象。
Optional<Ability> waitAbilityMonitor(IAbilityMonitormonitor, long timeout)等待并返回与指定时间段内给定IAbilityMonitor中设置的条件匹配的Ability对象 。
如果成功获得匹配的能力，则指定的IAbilityMonitor对象将无效。否则，您可以继续在waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor）或waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor，long）中使用它以获得技能。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 监控 | 指示用于监视功能的生命周期状态变化的IAbilityMonitor对象。 |
| 超时 | 指示等待的最长时间（以毫秒为单位）。该值必须是一个正整数。 |
返回值：
如果其生命周期状态已更改并且与给定监视器匹配，则返回包含Ability对象的Optional对象；否则返回一个空的Optional对象。
可选的< Ability> startAbilitySync（Intentintent）
根据给定的Intent启动一项功能，并等待2秒钟以开始运行该功能，然后再返回。
如果2秒钟内没有启动任何功能，则将返回一个空的Optional对象。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 意图 | 指示启动该能力的意图。 |
返回值：
如果在2秒内成功启动了包含启动的 Ability 对象的 Optional 对象，则返回该对象；否则返回一个空的 Optional 对象。
boolean runOnUIThreadSync(Runnabletask)
在 UI 线程上运行指定的任务并阻塞线程，直到任务完成。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 任务 | 指示要运行的可运行任务。 |
返回值：
如果任务在 UI 线程上成功执行，则返回true；否则，返回 true。否则返回 false。
Optional<Ability> startAbilitySync(Intentintent, long timeout)
根据给定的Intent启动一项功能，并等待指定的时间段才能开始运行该功能，然后再返回。
如果在超时指定的时间内没有启动任何能力，则将返回一个空的Optional对象。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 意图 | 指示启动该能力的意图。 |
| 超时 | 指示等待的最长时间（以毫秒为单位）。该值必须是一个正整数。 |
返回值：
如果在指定时间内成功启动了包含启动的 Ability 对象的 Optional 对象，则返回该对象；否则返回一个空的 Optional 对象。
boolean stopAbility(Abilityability)
消灭指定的能力。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 能力 | 指示要销毁的能力对象。 |
返回值：
如果该能力被成功销毁，则返回true；否则返回true。否则返回false。
boolean triggerTouchEvent(Abilityability,TouchEventtouchEvent）
将触摸事件分配给给定的功能，然后等待其处理。
此方法是同步的，不能在UI线程上运行。否则，UI线程将被挂起。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 能力 | 指示能力对象。 |
| 触摸事件 | 指示要调度的触摸事件。 |
返回值：
如果成功调度touch事件，则返回true；否则，返回false。否则返回false。
boolean triggerClickEvent(Abilityability, Componentview)
将 click 事件调度到给定功能的指定 Component 对象，并等待对其进行处理。
此方法是同步的，不能在UI线程上运行。否则，UI线程将被挂起。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 能力 | 指示能力对象。 |
| 视图 | 指示点击功能的组成部分。 |
返回值：
如果成功调度了click事件，则返回true；否则，返回true。否则返回false。
boolean triggerKeyEvent（能力，KeyEventkeyEvent）
将按键事件分配给给定的功能，然后等待其处理。
此方法是同步的，不能在UI线程上运行。否则，UI线程将被挂起。
参数：
| 参数名称 | 参数说明 |
|---|---|
| ability | 指示能力对象。 |
| keyEvent | 指示要调度的关键事件。 |
返回值：
如果成功调度关键事件，则返回true；否则，返回true。否则返回false。
IAbilityMonitoraddAbilityMonitor（（字符串标记）
基于指定的功能名称创建 IAbilityMonitor对象，以监视功能的生命周期状态变化。
参数：
| 参数名称 | 参数说明 |
|---|---|
| ability Name | 指示监视功能的名称。 |
返回值：
返回创建的IAbilityMonitor对象。
int getMonitorsNum（）
获取保存在内存中的IAbilityMonitor对象的总数 。
返回值：
返回IAbilityMonitor对象的总数。
无效clearAllMonitors（）
清除保存在内存中的所有 IAbilityMonitor对象。
int getAbilityState(Abilityability)
获得指定能力的生命周期状态。
参数：
| 参数名称 | 参数说明 |
|---|---|
| ability | 指示要获取其状态的Ability对象。 |
返回值：
返回能力的状态，可以是UNDEFINED等等。
void removeAbilityMonitor(IAbilityMonitormonitor)
从应用程序内存中删除指定的 IAbilityMonitor对象。
参数：
| 参数名称 | 参数说明 |
|---|---|
| monitor | 指示要删除的IAbilityMonitor对象。 |
无效打印（Stringmsg）
将日志信息打印到单元测试控制台。
参数：
| 参数名称 | 参数说明 |
|---|---|
| msg | 指示要打印的信息。 |
能力getCurrentTopAbility（）
获得当前正在显示的功能。
返回值：
返回当前显示的能力。
int getAbilitySliceState（AbilitySlicetargetSlice）
获取指定能力切片的生命周期状态。
参数：
| 参数名称 | 参数说明 |
|---|---|
| targetSlice | 指示要获取其状态的AbilitySlice对象。 |
返回值：
返回能力切片的状态，该状态可以是未定义的，依此类推。
获取指定能力的所有能力切片。
参数：
| 参数名称 | 参数说明 |
|---|---|
| ability | 指示能力对象。 |
返回值：
返回指定能力的所有能力切片的列表。
AbilitySlicegetCurrentAbilitySlice(Abilityability)
获得指定能力的最高能力切片。最高能力切片是指当前显示的能力切片。
参数：
| 参数名称 | 参数说明 |
|---|---|
| ability | 指示能力对象。 |
返回值：
返回指定能力的最高能力切片。
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。