UIAbility 生命周期方法

生命周期流程图

UIAbility的生命周期官方文档地址https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V13/uiability-lifecycle-V13
1. onCreate(want: Want, launchParam: LaunchParam)
  • 触发时机:Ability首次创建时

  • 作用:初始化核心资源和全局数据

  • 参数说明:

    参数 类型 说明
    want Want 包含启动Ability的源信息(如bundleName、abilityName、parameters等)
    launchParam AbilityConstant.LaunchParam 系统保留参数(当前版本未开放使用)
2. onWindowStageCreate(windowStage: WindowStage)
  • 触发时机:UI窗口创建阶段

  • 作用:加载UI布局和初始化界面元素

  • 参数说明:

    参数 类型 说明
    windowStage window.WindowStage 窗口管理器对象,通过loadContent()方法加载页面
3. onWindowStageWillDestroy(windowStage: WindowStage)
  • 触发时机:窗口即将销毁前

  • 作用:释放窗口关联资源

  • 参数说明:

    参数 类型 说明
    windowStage window.WindowStage 即将销毁的窗口对象
4. onWindowStageDestroy()
  • 触发时机:窗口完全销毁后

  • 作用:执行窗口销毁后的清理操作

5. onWindowStageRestore(windowStage: WindowStage)
  • 触发时机:窗口需要恢复时(如从后台返回)

  • 参数说明:

    参数 类型 说明
    windowStage window.WindowStage 重新创建的窗口对象
6. onDestroy()
  • 触发时机:Ability销毁前

  • 作用:释放所有全局资源

7. onForeground()
  • 触发时机:Ability进入前台

  • 作用:恢复UI动画/定时器等可见操作

8. onBackground()
  • 触发时机:Ability进入后台

  • 作用:暂停非必要操作以节省资源

9. onNewWant(want: Want, launchParam: LaunchParam)
  • 触发时机:已存在的Ability被重新启动

  • 参数说明:

    参数 类型 说明
    want Want 新的启动意图参数
    launchParam LaunchParam 系统保留参数
10. onShare(wantParam: Record<string, Object>)
  • 参数说明:

    参数 类型 说明
    wantParam Object 包含分享数据的键值对(如uri、type等)
11. onContinue(wantParam: Record<string, Object>)
TypeScript 复制代码
onContinue(wantParam: Record<string, Object>): AbilityConstant.OnContinueResult
  • 参数说明:

    参数 类型 说明
    wantParam Object 跨设备迁移时的数据载体
  • 返回值:

    值 说明
    AGREE(0) 同意迁移
    CANCEL(1) 取消迁移
12. onDump(params: Array<String>)
TypeScript 复制代码
onDump(params: string[]): string[]
  • 参数说明:

    参数 类型 说明
    params string\[\] 诊断命令参数(通过hdc shell传入)
13. onSaveState(reason: StateType, wantParam: Record<string, Object>)
TypeScript 复制代码
onSaveState(reason: AbilityConstant.StateType, wantParam: Record<string, Object>): AbilityConstant.OnSaveResult
  • 参数说明:

    参数 类型 说明
    reason StateType 触发原因(MIGRATION=0, PAGE_RECOVER=1)
    wantParam Object 状态数据存储容器
14. onPrepareToTerminate()
TypeScript 复制代码
onPrepareToTerminate(): boolean
  • 返回值:

    值 说明
    true 允许系统终止
    false 拒绝终止请求
15. onBackPressed()
TypeScript 复制代码
onBackPressed(): boolean
  • 返回值:

    值 说明
    true 已处理返回事件
    false 由系统默认处理

关键数据类型说明

Want 对象结构示例:
TypeScript 复制代码
{
  deviceId: "",      // 目标设备ID,空时表示本设备
  bundleName: "",    // 目标应用包名
  abilityName: "",   // 目标Ability名称
  parameters: {      // 自定义参数
    key1: "value1",
    key2: 123
  }
}
WindowStage 核心方法:
方法 说明
loadContent(path: string) 加载UI页面(如pages/Index)
getMainWindow() 获取窗口对象用于设置属性
相关推荐
码间留白1 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
jianqiang.xue2 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
todoitbo7 天前
把 K-Lite「什么都能播」搬上鸿蒙 PC:影匣播放器的 FFmpeg + libass 原生移植实录
华为·ffmpeg·harmonyos·鸿蒙
c2892480843s7 天前
【鸿蒙心迹】深色模式适配实战:资源限定词、动态取色与一张图两个主题
移动开发·harmonyos·鸿蒙·arkui·深色模式
码间留白8 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
c2892480843s10 天前
【鸿蒙心迹】网络请求封装实战:RCP 选型、拦截器与弱网预算
移动开发·网络请求·harmonyos·鸿蒙·rcp
码间留白14 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件
码间留白15 天前
鸿蒙端对接 BLE 血压计:从一次握手到读数入库(二)设备篇
物联网·uni-app·鸿蒙·蓝牙ble·血压计
行者-全栈开发16 天前
【共创稿事节】HarmonyOS 应用上架全流程中的隐私合规:权限最小化、数据本地化与 AppAnalyzer 体检
harmonyos·鸿蒙·隐私合规·应用上架·agc·appanalyzer
熊猫钓鱼>_>16 天前
三方库 NDK 原生模块跨平台适配与调试【鸿蒙心迹】
开发语言·华为·ai编程·harmonyos·鸿蒙·openharmony·鸿蒙心迹