前言HarmonyOS 的应用生命周期是一个多层嵌套的体系——从进程级生命周期到 Ability 级生命周期再到窗口级生命周期最后到 UI 组件的生命周期。理解这些生命周期的层级关系、触发时机和回调顺序是构建稳定应用的基础。本文以小事记xiaoshiji_ohos_app的EntryAbility.ets为分析对象结合官方文档深入解析应用生命周期从进程创建到UI 组件销毁的完整状态流转。核心特点简单易用API 设计直观上手成本低性能优异底层优化充分运行效率高扩展性强支持自定义配置和扩展本文参考 HarmonyOS 官方文档application-lifecycle.md 和 UIAbility 生命周期。一、应用生命周期的三层体系1.1 层级结构HarmonyOS 的应用生命周期分为三个层次每一层覆盖不同的粒度层级生命周期范围管理对象核心回调进程层应用进程的创建与销毁进程本身onAppStarted、onAppStoppedAbility 层UIAbility 实例的创建与销毁EntryAbilityonCreate→onForeground→onBackground→onDestroy窗口层窗口的创建与销毁WindowStage/WindowonWindowStageCreate→onWindowStageDestroyUI 层页面组件的创建与销毁ComponentaboutToAppear→build→aboutToDisappear1.2 三层生命周期的联动关系[进程创建] ↓ UIAbility.onCreate() ← Ability 层 ↓ UIAbility.onWindowStageCreate() ← 窗口层 ↓ windowStage.loadContent() ↓ Component.aboutToAppear() ← UI 层 ↓ Component.build() ↓ UIAbility.onForeground() ← Ability 层前台 ↓ [应用运行中] ↓ UIAbility.onBackground() ← Ability 层后台 ↓ UIAbility.onForeground() ← Ability 层前台可重复 ↓ [用户退出] ↓ UIAbility.onBackground() ← Ability 层 ↓ UIAbility.onWindowStageDestroy() ← 窗口层 ↓ UIAbility.onDestroy() ← Ability 层 ↓ [进程销毁]二、进程层生命周期2.1 进程创建与销毁应用进程的创建和销毁由系统管理开发者可以通过ApplicationStateObserver监听进程状态// 监听应用启动和退出 import { appManager } from kit.AbilityKit; import { BusinessError } from kit.BasicServicesKit; class MyAppStateObserver { onAppStarted(appStateData: appManager.AppStateData): void { console.log(应用启动: ${appStateData.bundleName}); } onAppStopped(appStateData: appManager.AppStateData): void { console.log(应用退出: ${appStateData.bundleName}); } } // 注册观察者 try { appManager.on(applicationState, new MyAppStateObserver()); } catch (err) { console.error(注册失败: ${(err as BusinessError).message}); }2.2 进程与 Ability 的生命周期关系进程状态UIAbility 状态说明进程创建首个 UIAbility 创建冷启动场景进程前台任一 UIAbility 处于前台用户可见进程后台所有 UIAbility 处于后台用户不可见进程销毁所有 UIAbility 已销毁进程终止提示进程状态与 UIAbility 状态并非一一对应。一个进程可能包含多个 UIAbility其中某个 UIAbility 进入前台不一定意味着进程状态发生变化进程可能已处于前台。三、UIAbility 层生命周期3.1 六个核心回调小事记的EntryAbility.ets实现了全部六个生命周期回调// EntryAbility.ets — 完整的生命周期回调 import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from kit.AbilityKit; import { hilog } from kit.PerformanceAnalysisKit; import { window } from kit.ArkUI; const DOMAIN 0x0000; export default class EntryAbility extends UIAbility { // 第1步Ability 创建 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { try { this.context.getApplicationContext().setColorMode( ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET ); } catch (err) { hilog.error(DOMAIN, testTag, Failed to set colorMode. Cause: %{public}s, JSON.stringify(err)); } hilog.info(DOMAIN, testTag, %{public}s, Ability onCreate); } // 第2步窗口创建 onWindowStageCreate(windowStage: window.WindowStage): void { hilog.info(DOMAIN, testTag, %{public}s, Ability onWindowStageCreate); windowStage.loadContent(pages/Index, (err) { if (err.code) { hilog.error(DOMAIN, testTag, Failed to load the content. Cause: %{public}s, JSON.stringify(err)); return; } hilog.info(DOMAIN, testTag, Succeeded in loading the content.); }); } // 第3步进入前台 onForeground(): void { hilog.info(DOMAIN, testTag, %{public}s, Ability onForeground); } // 第4步进入后台 onBackground(): void { hilog.info(DOMAIN, testTag, %{public}s, Ability onBackground); } // 第5步窗口销毁 onWindowStageDestroy(): void { hilog.info(DOMAIN, testTag, %{public}s, Ability onWindowStageDestroy); } // 第6步Ability 销毁 onDestroy(): void { hilog.info(DOMAIN, testTag, %{public}s, Ability onDestroy); } }3.2 各回调的最佳实践回调适宜的操作不适宜的操作onCreate初始化全局配置、读取启动参数网络请求、数据库操作耗时onWindowStageCreate加载页面、设置窗口属性复杂的业务逻辑onForeground恢复动画、注册广播、刷新 UI执行耗时计算onBackground暂停动画、释放资源、保存草稿执行 UI 操作onWindowStageDestroy释放窗口资源访问已销毁的窗口对象onDestroy持久化最终状态、释放全局资源异步操作可能无法完成3.3 三种启动场景启动场景回调顺序说明冷启动onCreate→onWindowStageCreate→onForeground进程首次创建完整生命周期热启动onForeground进程已在后台直接回到前台后台启动onCreate→onForeground不创建窗口用于启动后台任务// 在 onCreate 中判断启动场景 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { switch (launchParam.launchReason) { case AbilityConstant.LaunchReason.START_ABILITY: // 正常启动冷启动或热启动 break; case AbilityConstant.LaunchReason.CALL: // 后台启动不创建窗口 this.handleBackgroundLaunch(); break; case AbilityConstant.LaunchReason.CONTINUATION: // 跨设备流转 this.handleContinuationLaunch(want); break; case AbilityConstant.LaunchReason.APP_RECOVERY: // 应用恢复崩溃后重启 this.handleAppRecovery(); break; } }四、窗口层生命周期4.1 WindowStage 的生命周期WindowStage是 UIAbility 与 Window 之间的桥梁管理着窗口的创建和销毁// onWindowStageCreate 中的窗口操作 onWindowStageCreate(windowStage: window.WindowStage): void { // 1. 获取主窗口对象 windowStage.getMainWindow().then((mainWindow) { // 2. 设置窗口属性 mainWindow.setWindowLayoutFullScreen(false); mainWindow.setWindowSystemBarEnable([status, navigation]); // 3. 设置窗口背景色 mainWindow.setWindowBackgroundColor(#F8F9FA); }); // 4. 加载页面 windowStage.loadContent(pages/Index); }4.2 窗口属性配置窗口属性方法说明全屏模式setWindowLayoutFullScreen是否启用全屏布局系统栏setWindowSystemBarEnable状态栏/导航栏显隐背景色setWindowBackgroundColor窗口背景颜色横竖屏setWindowPreferredOrientationPORTRAIT/LANDSCAPE亮度setWindowBrightness窗口亮度 0.0 ~ 1.04.3 窗口事件的监听// 监听窗口大小变化 onWindowStageCreate(windowStage: window.WindowStage): void { windowStage.on(windowSizeChange, (data) { console.log(窗口大小变化: ${data.width}x${data.height}); // 横竖屏切换时调整布局 if (data.width data.height) { console.log(切换到横屏模式); } else { console.log(切换到竖屏模式); } }); }五、UI 组件层生命周期5.1 Component 的生命周期HarmonyOS 的 UI 组件使用Component装饰器其生命周期包括Entry Component struct HomePage { // 第1步状态变量初始化 State events: LifeEvent[] getMockEvents(); // 第2步组件即将出现 aboutToAppear(): void { console.log(HomePage aboutToAppear); // 在此处初始化数据、注册事件 } // 第3步组件构建 build() { Column() { // UI 布局 } } // 第4步组件即将消失 aboutToDisappear(): void { console.log(HomePage aboutToDisappear); // 在此处释放资源、取消订阅 } }5.2 生命周期与页面路由的联动当使用router.pushUrl跳转页面时组件的生命周期变化// 场景从 HomePage 跳转到 EventDetailPage // HomePage 仍然可见被盖在下面不会触发 aboutToDisappear router.pushUrl({ url: pages/EventDetailPage }); // 场景使用 router.replaceUrl 替换页面 // HomePage 会触发 aboutToDisappear router.replaceUrl({ url: pages/EventDetailPage }); // 场景使用 router.back() 返回 // 被覆盖的页面不会重新创建而是直接 rebuild router.back();5.3 页面路由时的生命周期时序[从 HomePage 跳转到 EventDetailPage] ↓ HomePage.onClick() ← 用户点击事件 ↓ router.pushUrl({ url: pages/EventDetailPage }) ↓ EventDetailPage.aboutToAppear() ← 新页面创建 ↓ EventDetailPage.build() ← 新页面渲染 ↓ [用户看到 EventDetailPage] ↓ [用户点击返回] ↓ router.back() ↓ HomePage.aboutToDisappear 不会触发使用 pushUrl 时 HomePage 仍在栈中 ↓ HomePage 的 build 重新执行如果状态变量有变化六、应用前后台切换6.1 前后台切换的触发时机场景回调说明用户按 Home 键onBackground应用进入后台窗口保留用户从多任务界面返回onForeground应用回到前台用户切换到其他应用onBackground应用进入后台锁屏onBackground屏幕锁定应用进入后台解锁回到应用onForeground解锁后应用回到前台6.2 前后台切换的监听方法一在 UIAbility 中监听// EntryAbility.ets — 监听前后台切换 onForeground(): void { hilog.info(DOMAIN, testTag, Ability onForeground); // 恢复动画播放 // 重新订阅数据变化 // 刷新 UI 数据 } onBackground(): void { hilog.info(DOMAIN, testTag, Ability onBackground); // 暂停动画播放 // 保存编辑草稿 // 取消不必要的订阅 }方法二使用 ApplicationContext 全局监听// 在 ApplicationContext 上注册前后台监听 import { ApplicationStateChangeCallback } from kit.AbilityKit; let appContext this.context.getApplicationContext(); let callback: ApplicationStateChangeCallback (state: number) { if (state 0) { console.log(应用进入后台); } else if (state 1) { console.log(应用进入前台); } }; appContext.on(applicationStateChange, callback); // 不再需要时取消监听 // appContext.off(applicationStateChange, callback);七、应用退出与恢复7.1 应用退出的流程[用户退出应用手势或系统清理] ↓ UIAbility.onBackground() ↓ UIAbility.onWindowStageDestroy() ↓ UIAbility.onDestroy() ↓ [进程被系统回收]7.2 应用恢复机制HarmonyOS 提供了应用恢复能力在应用异常崩溃后可以自动恢复// 在 module.json5 中配置应用恢复 { abilities: [ { name: EntryAbility, recoverable: true // 开启应用恢复能力 } ] }// 在 UIAbility 中处理恢复 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { if (launchParam.launchReason AbilityConstant.LaunchReason.APP_RECOVERY) { // 应用恢复启动 this.restoreApplicationState(); } } private restoreApplicationState(): void { // 从持久化存储中恢复应用状态 // 恢复用户上次浏览的页面 // 恢复编辑中的草稿 }八、生命周期的调试技巧8.1 使用 hilog 追踪生命周期小事记使用hilog记录每个生命周期回调的执行const DOMAIN 0x0000; // 在关键节点打印日志 onCreate(): void { hilog.info(DOMAIN, testTag, onCreate); } onWindowStageCreate(): void { hilog.info(DOMAIN, testTag, onWindowStageCreate); } onForeground(): void { hilog.info(DOMAIN, testTag, onForeground); } onBackground(): void { hilog.info(DOMAIN, testTag, onBackground); } onWindowStageDestroy(): void { hilog.info(DOMAIN, testTag, onWindowStageDestroy); } onDestroy(): void { hilog.info(DOMAIN, testTag, onDestroy); }8.2 使用 DevEco Studio Profiler在 DevEco Studio 中通过Profiler工具分析生命周期耗时打开 DevEco Studio →View→Tool Windows→Profiler选择Launch Profiling模式点击应用启动按钮在 Timeline 面板中查看每个回调的执行时间Timeline 示例 [0ms] onCreate 开始 [2ms] onCreate 完成 [3ms] onWindowStageCreate 开始 [15ms] windowStage.loadContent 开始 [85ms] loadContent 完成 [86ms] onWindowStageCreate 完成 [87ms] onForeground 开始 [88ms] onForeground 完成 [120ms] 首页渲染完成8.3 常见生命周期问题排查问题可能原因排查方法onCreate执行超时在onCreate中执行了耗时操作检查onCreate中的代码loadContent加载失败页面路径未注册检查main_pages.json页面数据不刷新前后台切换时未刷新数据在onForeground中调用数据刷新内存泄漏在onBackground中未释放资源检查aboutToDisappear中的清理代码九、与 Android 生命周期的对比9.1 对照表HarmonyOSAndroid说明onCreateonCreateAbility/Activity 创建onWindowStageCreateonCreate中的setContentView窗口创建与 UI 加载onForegroundonResume进入前台可见且可交互onBackgroundonPause进入后台不可见onWindowStageDestroyonDestroy窗口销毁onDestroyonDestroyAbility/Activity 销毁aboutToAppearonStartUI 组件即将显示aboutToDisappearonStopUI 组件即将隐藏9.2 关键差异窗口层独立— HarmonyOS 将窗口管理从 Ability 生命周期中分离通过WindowStage独立管理UI 组件生命周期—Component的aboutToAppear/aboutToDisappear是 HarmonyOS 特有的组件级生命周期应用恢复机制— HarmonyOS 通过LaunchReason.APP_RECOVERY支持应用崩溃后的自动恢复十、最佳实践总结10.1 资源管理策略// 在合适的生命周期中管理资源 onForeground(): void { this.startAnimation(); this.registerBroadcast(); this.refreshData(); } onBackground(): void { this.pauseAnimation(); this.unregisterBroadcast(); this.saveDraft(); } aboutToDisappear(): void { this.releaseResources(); this.cancelSubscriptions(); }10.2 数据持久化策略// 在 onBackground 中保存关键数据 onBackground(): void { // 保存编辑中的记录 if (this.hasUnsavedChanges) { this.saveDraftToLocal(); } // 记录最后访问时间 this.saveLastAccessTime(); }10.3 启动优化策略// 冷启动优化 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { // 只执行必要的初始化 this.initEssentialConfig(); // 将耗时操作推迟到 UI 组件中异步执行 // 不要在此处加载数据库或发起网络请求 } // 在 UI 组件中异步加载数据 aboutToAppear(): void { // 异步加载数据不阻塞 UI 渲染 setTimeout(() { this.loadDataAsync(); }, 0); }总结本文从xiaoshiji_ohos_app的EntryAbility.ets源码出发完整解析了 HarmonyOS 应用生命周期的三层体系——进程层、Ability 层、窗口层和 UI 组件层。核心要点如下三层生命周期联动进程创建 → UIAbility 创建 → WindowStage 创建 → UI 组件创建形成完整的生命周期链条六个核心回调onCreate→onWindowStageCreate→onForeground→onBackground→onWindowStageDestroy→onDestroy每个回调有明确的职责边界前后台切换通过onForeground/onBackground管理资源在onBackground中保存数据在onForeground中恢复应用恢复通过LaunchReason.APP_RECOVERY支持崩溃后的自动恢复需要在onCreate中判断恢复场景调试技巧使用hilog记录生命周期、Profiler 分析耗时、main_pages.json排查路由错误下一篇文章将深入解析应用颜色模式管理setColorMode 与深色主题适配。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源小事记项目源码xiaoshiji_ohos_app官方文档 - 应用生命周期application-lifecycle.md官方文档 - UIAbility 生命周期uiability-lifecycle官方文档 - 应用退出app-stop官方文档 - 启动选项application-startup-options.md官方文档 - Contextapplication-context-stage.md官方文档 - 应用模型application-models.md开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.net