一、说明 AbilityLifecycleCallback模块提供应用上下文ApplicationContext的生命周期发生变化时触发相应回调的能力,包括onAbilityCreate、onWindowStageCreate、onWindowStageActive、onWindowStageInactive、onWindowStageDestroy、onAbilityDestroy、onAbilityForeground、onAbilityBackground、onAbilityContinue方法。本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。本模块接口仅可在Stage模型下使用。 二、导入模块 import AbilityLifecycleCallback from ‘@ohos.app.ability.AbilityLifecycleCallback’; 1.AbilityLifecycleCallback.onAbilityCreate onAbilityCreate(ability: UIAbility): void; 注册监听应用上下文的生命周期后,在ability创建时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/0e2421cbfd0c7991d3ca2aa5cca230ab.jpeg) 示例: let abilityLifecycleCallback = { onAbilityCreate(ability){ console.log(‘AbilityLifecycleCallback onAbilityCreate.’); } }; 2.AbilityLifecycleCallback.onWindowStageCreate onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage创建时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/76f326f43b48c37c30779abd7a45a153.jpeg) 示例: let abilityLifecycleCallback = { onAbilityCreate(ability){ console.log(‘AbilityLifecycleCallback onAbilityCreate.’); } }; 3.AbilityLifecycleCallback.onWindowStageCreate onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage创建时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/f7671b824100fd54031957994a2706d0.jpeg) 示例: let abilityLifecycleCallback = { onWindowStageActive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageActive.’); } }; 4.AbilityLifecycleCallback.onWindowStageInactive onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage失焦时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/76e03f598d5742f31a85820b91106719.jpeg) 示例: let abilityLifecycleCallback = { onWindowStageInactive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageInactive.’); } }; 5.AbilityLifecycleCallback.onWindowStageDestroy onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage销毁时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/4505d6b7a66e40b788a93ee4f2b1e9bc.jpeg) 示例: let abilityLifecycleCallback = { onWindowStageInactive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageInactive.’); } }; 6.AbilityLifecycleCallback.onWindowStageDestroy onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage销毁时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/b14aa7bd0a3726ed1fca864d53dca531.jpeg) 示例: let abilityLifecycleCallback = { onWindowStageInactive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageInactive.’); } }; 7.AbilityLifecycleCallback.onWindowStageDestroy onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage销毁时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/ba526a36595622ee5bef200b14af70dc.jpeg) 示例: let abilityLifecycleCallback = { onWindowStageInactive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageInactive.’); } }; 8.AbilityLifecycleCallback.onWindowStageDestroy onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; 注册监听应用上下文的生命周期后,在windowStage销毁时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/e102c168d7acd04048dbe7521d105786.jpeg) 示例: let abilityLifecycleCallback = { onAbilityBackground(ability){ console.log(‘AbilityLifecycleCallback onAbilityBackground.’); } }; 9.AbilityLifecycleCallback.onAbilityContinue onAbilityContinue(ability: UIAbility): void; 注册监听应用上下文的生命周期后,在ability迁移时触发回调。 系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore 参数: ![鸿蒙原生应用/元服务开发-Stage模型能力接口(三)-鸿蒙开发者社区](https://img-blog.csdnimg.cn/img_convert/89351f36383d02fd443e7740327d4f15.jpeg) 示例: let abilityLifecycleCallback = { onAbilityContinue(ability){ console.log(‘AbilityLifecycleCallback onAbilityContinue.’); } }; AbilityLifecycleCallback使用 示例: MyFirstAbility.ts import AbilityLifecycleCallback from ‘@ohos.app.ability.AbilityLifecycleCallback’; import AbilityStage from ‘@ohos.app.ability.AbilityStage’; import UIAbility from ‘@ohos.app.ability.UIAbility’; // 声明ability生命周期回调,需配置所有回调后才可以在applicationContext注册 let abilityLifecycleCallback = { onAbilityCreate(ability){ console.log(‘AbilityLifecycleCallback onAbilityCreate.’); }, onWindowStageCreate(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageCreate.’); }, onWindowStageActive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageActive.’); }, onWindowStageInactive(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageInactive.’); }, onWindowStageDestroy(ability, windowStage){ console.log(‘AbilityLifecycleCallback onWindowStageDestroy.’); }, onAbilityDestroy(ability){ console.log(‘AbilityLifecycleCallback onAbilityDestroy.’); }, onAbilityForeground(ability){ console.log(‘AbilityLifecycleCallback onAbilityForeground.’); }, onAbilityBackground(ability){ console.log(‘AbilityLifecycleCallback onAbilityBackground.’); }, onAbilityContinue(ability){ console.log(‘AbilityLifecycleCallback onAbilityContinue.’); } }; export default class MyFirstAbility extends UIAbility { onCreate() { console.log(‘MyAbilityStage onCreate’); // 1.通过context属性获取applicationContext let applicationContext = this.context.getApplicationContext(); // 2.通过applicationContext注册监听应用内生命周期 try { globalThis.lifecycleId = applicationContext.on(‘abilityLifecycle’, abilityLifecycleCallback); console.log(‘registerAbilityLifecycleCallback lifecycleId: ${globalThis.lifecycleId}’); } catch (paramError) { console.log(‘error: ’ + paramError.code + ’ ,’ + paramError.message); } } } MySecondAbility.ts import UIAbility from ‘@ohos.app.ability.UIAbility’; export default class MySecondAbility extends UIAbility { onDestroy() { let applicationContext = this.context.getApplicationContext(); // 3.通过applicationContext注销监听应用内生命周期 applicationContext.off(‘abilityLifecycle’, globalThis.lifecycleId, (error) => { if (error.code != 0) { console.log('unregisterAbilityLifecycleCallback failed, error: ’ + JSON.stringify(error)); } else { console.log(‘unregisterAbilityLifecycleCallback success.’); } }); } } 本文根据HarmonyOS官方开发文档整理 |