【ArkUI】简述 UIAbility 组件的生命周期、启动模式和基本用法

一、UIAbility 组件概述UIAbility 组件是一种包含 UI 的应用组件，主要用于和用户交互。例如，图库类应用可以在 UIAbility 组件中展示图片瀑布流。UIAbility 的设计理念是：支持应用组件级的跨端迁移和多端协同。支持多设备和多窗口形态。UIAbility 组件是系统调度的基本单元，为应用提供绘制界面的窗口。一个应用可以包含一个或多个 UIAbility 组件。例如，在支付应用中，可以将入口功能和收付款功能分别配置为独立的UIAbility。每一个 UIAbility 组件实例都会在最近任务列表中显示一个对应的任务。任务视图用于快速查看和管理当前设备上运行的所有任务或应用。1、划分原则可以根据具体场景选择单个还是多个 UIAbility。如果开发者希望在任务视图中看到一个任务，建议使用“一个 UIAbility + 多个页面”的方式，可以避免不必要的资源加载。如果开发者希望在任务视图中看到多个任务，或者需要同时开启多个窗口，建议使用多个 UIAbility 实现不同的功能。例如，即时通讯类应用中的消息列表与音视频通话采用不同的 UIAbility 进行开发，既可以方便地切换任务窗口，又可以实现应用的两个任务窗口在一个屏幕上分屏显示。2、声明配置为使应用能够正常使用 UIAbility，需要在模块级的 module.json5 配置文件的 abilities 标签中声明 UIAbility 的名称、入口、标签等相关信息。{"module":{// ···"abilities":[{"name":"EntryAbility",// UIAbility组件的名称"srcEntry":"./ets/entryability/EntryAbility.ets",// UIAbility组件的代码路径"description":"$string:EntryAbility_desc",// UIAbility组件的描述信息"icon":"$media:layered_image",// UIAbility组件的图标"label":"$string:EntryAbility_label",// UIAbility组件对用户显示的名称"startWindowIcon":"$media:startIcon",// UIAbility组件启动页面图标资源文件的索引"startWindowBackground":"$color:start_window_background",// UIAbility组件启动页面背景颜色资源文件的索引// ···}]// ···}}二、UIAbility 组件生命周期当用户在执行应用启动、应用前后台切换、应用退出等操作时，系统会触发相关应用组件的生命周期回调。UIAbility 组件的核心生命周期回调包括onCreate、onForeground、onBackground、onDestroy。作为一种包含 UI 的应用组件，UIAbility 的生命周期不可避免地与WindowStage 的生命周期存在关联关系。1、UIAbility 启动到前台场景当用户启动一个 UIAbility 时，系统会依次触发onCreate()、onWindowStageCreate()、onForeground()生命周期回调。当用户跳转到其他应用（当前 UIAbility 切换到后台）时，系统会触发onBackground()生命周期回调。当用户再次将 UIAbility 切换到前台时，系统会依次触发onNewWant()、onForeground()生命周期回调。2、UIAbility 启动到后台场景当用户通过 UIAbilityContext.startAbilityByCall() 接口启动一个 UIAbility 到后台时，系统会依次触发onCreate()、onBackground()（不会执行 onWindowStageCreate() 生命周期回调）生命周期回调。当用户将 UIAbility 拉到前台，系统会依次触发onNewWant()、onWindowStageCreate()、onForeground()生命周期回调。3、生命周期回调生命周期回调是在应用主线程执行，为了确保应用性能，建议在生命周期回调中，仅执行必要的轻量级操作。对于耗时任务，推荐采用异步处理或交由子线程执行，避免阻塞主线程。如果需要感知 UIAbility 生命周期变化，开发者可以使用 ApplicationContext 注册接口监听 UIAbility 生命周期变化。（1）onCreate()在首次创建UIAbility 实例时，系统触发 onCreate() 回调。开发者可以在该回调中执行 UIAbility整个生命周期中仅发生一次的启动逻辑。（2）onWindowStageCreate()UIAbility 实例创建完成之后，在进入前台之前，系统会创建一个 WindowStage。WindowStage 创建完成后会进入 onWindowStageCreate() 回调，开发者可以在该回调中进行 UI 加载、WindowStage 的事件订阅。在 onWindowStageCreate() 回调中通过loadContent() 方法设置应用要加载的页面。根据需要调用on(‘windowStageEvent’) 方法订阅 WindowStage 的事件（获焦/失焦、切到前台/切到后台、前台可交互/前台不可交互）。（3）onForeground()在 UIAbility 切换至前台时且 UIAbility 的 UI 可见之前，系统触发 onForeground 回调。开发者可以在该回调中申请系统需要的资源，或者重新申请在 onBackground() 中释放的资源。系统回调该方法后，UIAbility 实例进入前台状态，即 UIAbility 实例可以与用户交互的状态。UIAbility 实例会一直处于这个状态，直到被某些动作打断（例如屏幕关闭、用户跳转到其他 UIAbility）。例如，应用已获得地理位置权限。在UI显示之前，开发者可以在onForeground()回调中开启定位功能，从而获取到当前的位置信息。（4）onBackground()在 UIAbility 的 UI 完全不可见之后，系统触发 onBackground 回调，将 UIAbility 实例切换至后台状态。开发者可以在该回调中释放UI不可见时的无用资源，例如停止定位功能，以节省系统的资源消耗。onBackground() 执行时间较短，无法提供足够的时间做一些耗时动作。请勿在该方法中执行保存用户数据或执行数据库事务等耗时操作。（5）onWindowStageWillDestroy()在 UIAbility 实例销毁之前，系统触发 onWindowStageWillDestroy() 回调。该回调在 WindowStage 销毁前执行，此时 WindowStage 可以使用。开发者可以在该回调中释放通过 WindowStage 获取的资源、注销 WindowStage 事件订阅等。（6）onWindowStageDestroy()在 UIAbility 实例销毁之前，系统触发 onWindowStageDestroy() 回调，开发者可以在该回调中释放 UI 资源。该回调在 WindowStage 销毁后执行，此时 WindowStage 不可以使用。（7）onDestroy()在 UIAbility 实例销毁之前，系统触发 onDestroy 回调。该回调是 UIAbility 接收到的最后一个生命周期回调，开发者可以在 onDestroy() 回调中进行系统资源的释放、数据的保存等操作。例如，开发者调用 terminateSelf() 方法通知系统停止当前 UIAbility 实例时，系统会触发 onDestroy() 回调。从 API version 13 开始，用户在最近任务列表中使用一键清理来关闭应用，对于无实况窗的应用将不会触发 onDestroy() 回调，而是会直接终止进程；对于有实况窗的应用会继续触发 onDestroy() 回调。当在开发者模式下调试某个应用时，如果用户从最近任务列表中移除了该调试应用的一个任务，则该调试应用的进程会被强制销毁，不会触发 onDestroy() 回调。（8）onNewWant()当应用的UIAbility实例已创建，再次调用方法启动该UIAbility实例时，系统触发该UIAbility的onNewWant()回调。开发者可以在该回调中更新要加载的资源和数据等，用于后续的UI展示。（9）示例代码import{AbilityConstant,ConfigurationConstant,UIAbility,Want}from'@kit.AbilityKit';import{hilog}from'@kit.PerformanceAnalysisKit';import{window}from'@kit.ArkUI';constDOMAIN=0x0000;exportdefaultclassEntryAbilityextendsUIAbility{onCreate(want:Want,launchParam:AbilityConstant.LaunchParam):void{// 执行UIAbility整个生命周期中仅发生一次的业务逻辑try{this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);}catch(