HarmonyOS鸿蒙NEXT UIAbility生命周期详解

UIAbility 生命周期核心机制

1. 冷启动：onCreate

触发时机

首次启动应用

关键操作

• 初始化全局资源（数据库、配置等）
• 处理卡片跳转参数

onCreate(want: Want) {
  // 从卡片获取商品ID
  if (want.parameters?.cardId) {
    const goodsId = want.parameters.cardId;
    router.pushUrl(`pages/GoodsDetail?id=${goodsId}`);
  }
}

避坑重点

必须使用 this.context 获取应用上下文（getContext() 此时无效）

2. 热启动：onNewWant

触发时机

应用已运行时接收新意图

典型场景

• 从通知栏跳转指定页面
• 通过深链接打开特定模块

onNewWant(want: Want) {
  // 跳转商品分类页
  if (want.parameters?.category) {
    router.replaceUrl(`pages/Category/${want.parameters.category}`);
  }
}

3. 窗口创建：onWindowStageCreate

核心任务

onWindowStageCreate(windowStage: window.WindowStage) {
  // 1. 获取设备尺寸（响应式布局）
  const { width, height } = windowStage.getMainWindowSync().getWindowProperties();
  GlobalLayoutConfig.init(width); 

  // 2. 加载UI内容（必须调用！）
  windowStage.loadContent('pages/HomePage');
}

扩展能力

• 动态适配折叠屏/平板多窗口模式
• 注册窗口事件监听器

4. 窗口销毁：onWindowStageDestroy

资源释放

onWindowStageDestroy() {
  this.videoPlayer.release(); // 释放视频资源
  this.tempCache.clear();    // 清理临时缓存
}

5. 前后台切换

示例场景：

// 回到前台时刷新数据
onForeground() {
  this.refreshGoodsStock(); 
  this.startBannerAnimation();
}

// 退到后台时释放资源
onBackground() {
  this.stopBannerAnimation();
  this.saveScrollPosition(); 
}

关键陷阱与解决方案

1. 上下文获取时机问题

错误示例（崩溃风险）

onCreate() {
  const ctx = getContext(); // UI未初始化，返回null
  fileIO.write(ctx, 'data.txt'); 
}

正确方案（所有阶段通用）

onCreate() {
  // 直接使用Ability内置上下文
  fileIO.write(this.context, 'data.txt'); 
}

2. 多窗口资源冲突

问题

平板分屏时多个窗口共享同一Ability

方案

窗口级资源隔离

onWindowStageCreate(windowStage) {
  // 为每个窗口创建独立资源
  this.windowResourceMap.set(windowStage, new WindowResource());
}

卡片能力生命周期关联

FormExtensionAbility 核心阶段

• onAddForm：卡片创建时初始化（使用 this.context 写入文件）
• onFormVisible：卡片显示时刷新数据
• onFormInvisible：卡片隐藏时暂停更新
• onRemoveForm：卡片移除时销毁资源

设计原则：

• UIAbility 管理全局状态
• FormExtensionAbility 处理卡片专属逻辑

生命周期最佳实践

冷热分离

• onCreate 仅初始化必要全局单例
• onNewWant 处理场景化跳转逻辑

窗口资源绑定

private windowResources = new Map<window.WindowStage, Resource>();

onWindowStageCreate(stage) {
  this.windowResources.set(stage, initResource());
}

onWindowStageDestroy(stage) {
  this.windowResources.get(stage)?.release();
}

状态切换优化

• 前台恢复：优先核心功能（如网络重连）
• 后台释放：按内存占用排序清理