JHHK

欢迎来到我的个人网站
行者常至 为者常成

生命周期

目录

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的闭包中,直到回调方法被执行完,这个行为阻止了自定义组件的垃圾回收


行者常至,为者常成!





R
Valine - A simple comment system based on Leancloud.