ToB企服应用市场:ToB评测及商务社交产业平台

标题: HarmonyOS NEXT开辟进阶（九）：UIAbility 组件生命周期及启动模式讲解 [打印本页]

作者: 饭宝 时间: 2025-1-18 19:27
标题: HarmonyOS NEXT开辟进阶（九）：UIAbility 组件生命周期及启动模式讲解
一、媒介

UIAbility组件是一种包含UI界面的应用组件，紧张用于和用户交互。
UIAbility组件是系统调度的基本单元，为应用提供绘制界面的窗口；一个UIAbility组件中可以通过多个页面来实现一个功能模块。每一个UIAbility组件实例，都对应于一个近来任务列表中的任务。
UIAbility组件就像手机上的一个应用，它负责展示应用的用户界面，用户可以通过它来和应用举行互动。每个UIAbility组件可以包含多个不同的界面，就像应用中的不同页面。用户每次在手机上打开一个应用，实际上是启动了一个UIAbility组件的实例，这个应用会在近来任务列表中表现。这个机制让用户能够轻松切换和管理不同应用和它们的界面。
为使应用能够正常使用UIAbility，需要在module.json5配置文件的abilities标签中声明UIAbility的名称、入口、标签等相关信息。

以下为设置的UIAbility参数：

{
"module": {
// ...
"abilities": [
{
"name": "EntryAbility", // UIAbility组件的名称
"srcEntrance": "./ets/entryability/EntryAbility.ts", // UIAbility组件的代码路径
"description": "$string:EntryAbility_desc", // UIAbility组件的描述信息
"icon": "$media:icon", // UIAbility组件的图标
"label": "$string:EntryAbility_label", // UIAbility组件的标签
"startWindowIcon": "$media:icon", // UIAbility组件启动页面图标资源文件的索引
"startWindowBackground": "$color:start_window_background", // UIAbility组件启动页面背景颜色资源文件的索引
// ...
}
]
}
}

复制代码

二、UIAbility 组件生命周期

UIAbility就像是应用中的一个窗口或界面，拥有本身的生命周期，就像一个角色有不同的状态。这个生命周期包罗创建/烧毁/前台/后台四个状态：

Create（创建）：当用户打开应用或者切换到应用时，UIAbility被创建。例如用户打开一个应用，应用的界面被出现在屏幕上。
Foreground（前台）：当应用界面处于活跃状态时，它处于前台状态。例如用户正在使用一个应用，它是当前的核心。
Background（后台）：如果你切换到了其他应用，原来的应用就进入了后台状态。UIAbility也会相应地从前台变成后台状态。
Destroy（烧毁）：当用户关闭应用或者应用被系统烧毁时，UIAbility也会被烧毁。例如用户关闭一个应用，它的界面消散了。

这些状态变化可以帮助应用了解UIAbility在不同时候的状态，从而实行不同的操纵或者保持应用的一致性。
四种声明周期间的转换方式可以用以下流程图表现。

实际项目中，在EntryAbility.ts文件内容定义如下：

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
}
onDestroy(): void {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
}
onWindowStageCreate(windowStage: window.WindowStage): void {
// Main window is created, set main page for this ability
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
windowStage.loadContent('pages/Index', (err) => {
if (err.code) {
hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
});
}
onWindowStageDestroy(): void {
// Main window is destroyed, release UI related resources
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
}
onForeground(): void {
// Ability has brought to foreground
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
}
onBackground(): void {
// Ability has back to background
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
}
}

复制代码

其中，Create状态为在应用加载过程中，UIAbility实例创建完成时触发，系统会调用onCreate()回调。可以在该回调中举行应用初始化操纵，例如变量定义资源加载等，用于后续的UI界面展示。
每个UIAbility类实例都会与一个WindowStage类实例绑定，WindowStage类起到了应用进程内窗口管理器的作用，它包含一个主窗口。也就是说，UIAbility通过WindowStage持有了一个窗口，该窗口为ArkUI提供了绘制地区。
可以明白为当应用程序启动时，系统会自动为每个UIAbility实例创建一个WindowStage（窗口舞台）。这个WindowStage就像是应用界面的舞台，上面可以加应用需要的各种UI元素。
根据鸿蒙开辟应用的stage开辟模型工作原理，UIAbility组件生命周期回调函数及WindowStage回调函数间的流转方式如下图所示：

在WindowStage创建完成后，系统会调用onWindowStageCreate()回调函数。在这个函数里，开辟者可以设置所需的UI界面，比如加载各种页面，设置UI元素的样式等。还可以订阅WindowStage变乱，比如获得核心（用户正在与应用交互）或失去核心（应用不再是用户的核心）、可见或不可见等。这些变乱让应用能够相应用户的操纵。
在onWindowStageCreate()回调函数中，通常会使用loadContent()方法来加载应用要表现的页面。同时，也可以根据需要订阅各种WindowStage变乱，以便在用户操纵发生时做出相应的相应。
当用户退出应用或者应用被系统烧毁时，对应的UIAbility实例会被烧毁。在这之前，系统会先调用onWindowStageDestroy()回调函数。在这个函数里，可以开释UI界面所占用的资源，做一些清理工作。比如，可以在这里注销之前订阅的获得核心或失去核心等WindowStage变乱，以确保资源被正确开释，应用退出时不会出现题目。
如许，通过在WindowStage的创建和烧毁过程中设置相应的回调函数，使得应用就能够在不同的阶段实行不同的操纵，从而保证用户体验的一致性和应用的稳固性。
Foreground和Background状态分别在UIAbility实例切换至前台和切换至后台时触发，对应于onForeground()回调和onBackground()回调。
onForeground()回调，在UIAbility的UI界面可见之前，如UIAbility切换至前台时触发。可以在onForeground()回调中申请系统需要的资源，或者重新申请在onBackground()中开释的资源。
onBackground()回调，在UIAbility的UI界面完全不可见之后，如UIAbility切换至后台时间触发。可以在onBackground()回调中开释UI界面不可见时无用的资源，或者在此回调中实行较为耗时的操纵，例如状态保存等。
例如应用在使用过程中需要使用用户定位时，假设应用已获得用户的定位权限授权。在UI界面表现之前，可以在onForeground()回调中开启定位功能，从而获取到当前的位置信息。
当应用切换到后台状态，可以在onBackground()回调中停止定位功能，以节流系统的资源斲丧。
留意⚠️：预览模式是查察不了onForeground()、onBackground()这两个回调函数实行的。
Destroy状态在UIAbility实例烧毁时触发。可以在onDestroy()回调中举行系统资源的开释、数据的保存等操纵。
例如调用terminateSelf()方法停止当前UIAbility实例，从而完成UIAbility实例的烧毁；或者用户使用近来任务列表关闭该UIAbility实例，完成UIAbility的烧毁。
三、UIAbility 组件启动模式

UIAbility的启动模式是指UIAbility实例在启动时的不同呈现状态。针对不同的业务场景，系统提供了三种启动模式：

singleton（单实例模式）
standard（标准实例模式）
specified（指定实例模式）

通过在module.json5配置文件中的"launchType"字段配置为singleton、standard、specified即可。

{
"module": {
// ...
"abilities": [
{
"launchType": "multiton", // 支持配置为singleton、standard、specified三种启动模式
// ...
}
]
}
}

复制代码

3.1 singleton 单实例启动模式

Singleton启动模式是一种应用程序的启动方式，通常是默认的启动方式。在这个模式下，当使用startAbility()方法来启动一个UIAbility时，如果已经存在相同类型的UIAbility实例，系统会复用现有的实例，而不会创建新的，此时只会进入该UIAbility的onNewWant()回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。这意味着在近来任务列表中，只会存在一个该类型的UIAbility实例。
就似乎有一个应用，当多次打开同一功能页面时，不会每次打开都创建新的页面，而是会重新使用已经存在的页面。如许可以节流系统资源，提高应用的运行服从，而且在近来任务列表中只会看到一个相同类型的页面。这个模式通常用于确保应用不会出现大量相同的界面实例，以提供更好的用户体验和系统性能。
3.2 standard 标准实例启动模式

standard启动模式为标准实例模式，每次调用startAbility()方法时，都会在应用进程中创建一个新的该类型UIAbility实例。即在近来任务列表中可以看到有多个该类型的UIAbility实例。
3.3 specified 指定实例启动模式

Specified启动模式是一种特殊的启动模式，通常用于特定场景，比如文档编辑应用。它允许开辟者在创建UIAbility实例之前为该实例指定一个唯一的标识字符串（称为Key）。当UIAbility实例与这个Key绑定之后，在后续调用startAbility()方法时，系统会询问应用要打开哪个与特定Key绑定的UIAbility实例。
这种方式可以明白为每个UIAbility实例都有一个特定的身份标识（Key）。每次开辟者启动UIAbility时，系统会根据这个Key来判断是复用已存在的特定Key绑定的UIAbility实例，照旧创建一个新的实例。例如，在文档编辑应用中，如果想新建一个文档，可以使用一个新的Key，这将创建一个新的UIAbility实例；但如果想打开一个已保存的文档，可以使用该文档对应的Key，这将打开与之绑定的已存在的UIAbility实例。
以是，这种模式允许应用在运行时根据特定的Key来决定是否创建新实例或复用已有实例，以便满足不同的业务需求，比如确保每个文档有本身独立的编辑界面或者确保打开相同文档时共享同一个界面。
若UIAbility配置为指定实例模式，再次调用startAbility()方法启动该UIAbility实例，且AbilityStage的onAcceptWant()回调匹配到一个已创建的UIAbility实例。此时，再次启动该UIAbility时，只会进入该UIAbility的onNewWant()回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。
四、拓展阅读

《UIAbility组件官网介绍》
《HarmonyOS NEXT开辟进阶（八）：Stage模型开辟概述》

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)