目录
UIAbility组件生命周期
当用户打开、切换和返回到应用时,应用中的UIAbility实例会在其生命周期的不同状态之间转换。
UIAbility的生命周期包括Create、Foreground、Background、Destroy四个状态。
export default class EntryAbility extends UIAbility {
// UIAbility实例创建完成时触发
// 在该回调中进行页面初始化操作,例如变量定义,资源加载等,用于后续的UI展示。
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
// Want是对象间信息传递的载体,可以用于应用组件间的信息传递。
this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
}
// UIAbility切换至前台时,UIAbility的UI可见之前触发
// 回调中申请系统需要的资源,或者重新申请在onBackground()中释放的资源。
onForeground(): void {
// Ability has brought to foreground
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
}
// UIAbility切换至后台时,UIAbility的UI完全不可见之后触发
// 回调中释放UI不可见时无用的资源,或者在此回调中执行较为耗时的操作,例如状态保存等。
onBackground(): void {
// Ability has back to background
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
}
// 在UIAbility实例销毁时触发
// 在该回调中进行系统资源的释放、数据的保存等操作
onDestroy(): void {
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
}
}
WindowStage生命周期
窗口管理器。管理各个基本窗口单元,即Window实例。
一、生命周期回调函数
export default class EntryAbility extends UIAbility {
windowStage: window.WindowStage | undefined = undefined;
// WindowStage创建完成后调用
onWindowStageCreate(windowStage: window.WindowStage): void{
this.windowStage = windowStage;
}
// 在WindowStage销毁前调用,此时WindowStage可以使用
onWindowStageWillDestroy(windowStage: window.WindowStage) {
// 释放通过windowStage对象获取的资源
// 在onWindowStageWillDestroy()中注销WindowStage事件订阅(获焦/失焦、切到前台/切到后台、前台可交互/前台不可交互)
try {
if (this.windowStage) {
this.windowStage.off('windowStageEvent');
}
} catch (err) {
let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
hilog.error(DOMAIN_NUMBER, TAG, `Failed to disable the listener for windowStageEvent. Code is ${code}, message is ${message}`);
}
}
// 在UIAbility实例销毁之前(所以可以释放UI资源) WindowStage销毁后执行
onWindowStageDestroy() {
// 释放UI资源
}
}
二、WindowStage的事件
订阅 WindowStage 的事件,可以知道window当前的状态
前后台切换时,window的状态回调和UIAbility的生命周期回调都会执行,但有先后顺序
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';
const TAG: string = '[EntryAbility]';
const DOMAIN_NUMBER: number = 0xFF00;
export default class EntryAbility extends UIAbility {
// ...
onWindowStageCreate(windowStage: window.WindowStage): void {
// 设置WindowStage的事件订阅(获焦/失焦、切到前台/切到后台、前台可交互/前台不可交互)
try {
windowStage.on('windowStageEvent', (data) => {
let stageEventType: window.WindowStageEventType = data;
switch (stageEventType) {
case window.WindowStageEventType.SHOWN: // 切到前台
hilog.info(DOMAIN_NUMBER, TAG, `windowStage foreground.`);
break;
case window.WindowStageEventType.ACTIVE: // 获焦状态
hilog.info(DOMAIN_NUMBER, TAG, `windowStage active.`);
break;
case window.WindowStageEventType.INACTIVE: // 失焦状态
hilog.info(DOMAIN_NUMBER, TAG, `windowStage inactive.`);
break;
case window.WindowStageEventType.HIDDEN: // 切到后台
hilog.info(DOMAIN_NUMBER, TAG, `windowStage background.`);
break;
case window.WindowStageEventType.RESUMED: // 前台可交互状态
hilog.info(DOMAIN_NUMBER, TAG, `windowStage resumed.`);
break;
case window.WindowStageEventType.PAUSED: // 前台不可交互状态
hilog.info(DOMAIN_NUMBER, TAG, `windowStage paused.`);
break;
default:
break;
}
});
} catch (exception) {
hilog.error(DOMAIN_NUMBER, TAG,
`Failed to enable the listener for window stage event changes. Cause: ${JSON.stringify(exception)}`);
}
hilog.info(DOMAIN_NUMBER, TAG, `%{public}s`, `Ability onWindowStageCreate`);
// 设置UI加载
windowStage.loadContent('pages/Index', (err, data) => {
// ...
});
}
}
三、UIAbility 和 WindowStage 生命周期 时序
页面和组件生命周期函数
一、页面生命周期
页面生命周期(被@Entry装饰的组件生命周期),提供以下生命周期接口:
onPageShow:
页面每次显示时触发一次,包括路由过程、应用进入前台等场景。
onPageHide:
页面每次隐藏时触发一次,包括路由过程、应用进入后台等场景。
onBackPress:
当用户点击返回按钮时触发。
二、组件生命周期
组件生命周期,即一般用@Component装饰的自定义组件的生命周期,提供以下生命周期接口:
aboutToAppear:
组件即将出现时回调该接口,具体时机为在创建自定义组件的新实例后,在执行其build()函数之前执行。
onDidBuild:
组件build()函数执行完成之后回调该接口,开发者可以在这个阶段进行埋点数据上报等不影响实际UI的功能。不建议在onDidBuild函数中更改状态变量、使用animateTo等功能,这可能会导致不稳定的UI表现。
aboutToDisappear:
aboutToDisappear函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用程序行为不稳定。
三、顺序图
四、自定义组件的创建和渲染
在首次渲染的过程中,框架会记录状态变量和组件的映射关系,当状态变量改变时,驱动其相关的组件刷新。实现最小化更新。
如果if组件的分支改变,或者ForEach循环渲染中数组的个数改变,组件将被删除:
a.在删除组件之前,将调用其aboutToDisappear生命周期函数,标记着该节点将要被销毁。ArkUI的节点删除机制是:后端节点直接从组件树上摘下,后端节点被销毁,对前端节点解引用,前端节点已经没有引用时,将被JS虚拟机垃圾回收。
b.自定义组件和它的变量将被删除,如果其有同步的变量,比如@Link、@Prop、@StorageLink,将从同步源上取消注册
没理解
不建议在生命周期aboutToDisappear内使用async await,如果在生命周期的aboutToDisappear使用异步操作(Promise或者回调方法),自定义组件将被保留在Promise的闭包中,直到回调方法被执行完,这个行为阻止了自定义组件的垃圾回收
行者常至,为者常成!