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 处理卡片专属逻辑

生命周期最佳实践

1. 冷热分离onCreate 仅初始化必要全局单例onNewWant 处理场景化跳转逻辑
2. 窗口资源绑定private windowResources = new Map<window.WindowStage, Resource>(); onWindowStageCreate(stage) { this.windowResources.set(stage, initResource()); } onWindowStageDestroy(stage) { this.windowResources.get(stage)?.release(); }
3. 状态切换优化前台恢复：优先核心功能（如网络重连）后台释放：按内存占用排序清理