鸿蒙5.0开发进阶：ArkTS API-AbilityMonitor

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

AbilityMonitor

AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方法的能力，最近匹配的ability对象将保存在AbilityMonitor对象中。

说明

本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { abilityDelegatorRegistry } from '@kit.TestKit';

使用说明

可以作为abilityDelegator中的addAbilityMonitor的入参来监听指定Ability的生命周期变化。

属性

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	类型	只读	可选	说明
abilityName	string	否	否	当前AbilityMonitor绑定的ability名称。
moduleName	string	否	是	当前AbilityMonitor绑定的模块名称。
onAbilityCreate	(ability: UIAbility) => void	否	是	ability被启动初始化时的回调函数。 不设置该属性则不能收到该生命周期回调。
onAbilityForeground	(ability: UIAbility) => void	否	是	ability状态变成前台时的回调函数。 不设置该属性则不能收到该生命周期回调。
onAbilityBackground	(ability: UIAbility) => void	否	是	ability状态变成后台时的回调函数。 不设置该属性则不能收到该生命周期回调。
onAbilityDestroy	(ability: UIAbility) => void	否	是	ability被销毁前的回调函数。 不设置该属性则不能收到该生命周期回调。
onWindowStageCreate	(ability: UIAbility) => void	否	是	window stage被创建时的回调函数。 不设置该属性则不能收到该生命周期回调。
onWindowStageRestore	(ability: UIAbility) => void	否	是	window stage被重载时的回调函数。 不设置该属性则不能收到该生命周期回调。
onWindowStageDestroy	(ability: UIAbility) => void	否	是	window stage被销毁前的回调函数。 不设置该属性则不能收到该生命周期回调。

示例：

import { abilityDelegatorRegistry } from '@kit.TestKit';
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

function onAbilityCreateCallback(data: UIAbility) {
  console.info(`onAbilityCreateCallback, data: ${JSON.stringify(data)}`);
}

let monitor: abilityDelegatorRegistry.AbilityMonitor = {
  abilityName: 'abilityname',
  moduleName: "moduleName",
  onAbilityCreate: onAbilityCreateCallback
}

let abilityDelegator: abilityDelegatorRegistry.AbilityDelegator = abilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (error: BusinessError) => {
  if (error) {
    console.error(`addAbilityMonitor fail, error: ${JSON.stringify(error)}`);
  }
});