深入理解HarmonyOS UIAbility：生命周期、WindowStage与启动模式探析

UIAbility组件概述

UIAbility组件是HarmonyOS中一种包含UI界面的应用组件，主要用于与用户进行交互。每个UIAbility组件实例对应最近任务列表中的一个任务，可以包含多个页面来实现不同功能模块。

声明配置

为了使用UIAbility，首先需要在module.json5配置文件的abilities标签中声明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、Foreground、Background、Destroy。在不同状态之间转换时，系统会调用相应的生命周期回调函数。

Create状态

Create状态表示UIAbility实例创建完成时触发，系统调用onCreate()回调。在该回调中可以进行应用初始化操作，如变量定义、资源加载等，为后续的UI界面展示做准备。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
    onCreate(want, launchParam) {
        // 应用初始化
    }
    // ...
}

WindowStageCreate和WindowStageDestroy状态

在UIAbility实例创建完成后，在进入Foreground之前，系统会创建一个WindowStage。WindowStage创建完成后会触发onWindowStageCreate()回调，可以在该回调中设置UI界面加载和订阅WindowStage的事件。

import UIAbility from '@ohos.app.ability.UIAbility';
import Window from '@ohos.window';

export default class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage: Window.WindowStage) {
        // 设置WindowStage的事件订阅（获焦/失焦、可见/不可见）

        // 设置UI界面加载
        windowStage.loadContent('pages/Index', (err, data) => {
            // ...
        });
    }
    // ...
}

// 对应onWindowStageCreate回调，在UIAbility实例销毁之前，会先进入onWindowStageDestroy回调，可以在该回调中释放UI界面资源。
export default class EntryAbility extends UIAbility {
    // ...

    onWindowStageDestroy() {
        // 释放UI界面资源
    }
}

Foreground和Background状态

Foreground和Background状态分别在UIAbility实例切换至前台和切换至后台时触发，对应于onForeground()和onBackground()回调。在onForeground()中可以申请系统需要的资源，而在onBackground()中可以释放UI界面不可见时无用的资源。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
    onForeground() {
        // 申请系统需要的资源，或者重新申请在onBackground中释放的资源
    }

    onBackground() {
        // 释放UI界面不可见时无用的资源，或者在此回调中执行较为耗时的操作，例如状态保存等
    }
}

Destroy状态

Destroy状态在UIAbility实例销毁时触发，可以在onDestroy()回调中进行系统资源的释放、数据的保存等操作。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
    onDestroy() {
        // 系统资源的释放、数据的保存等
    }
}

UIAbility组件启动模式

UIAbility的启动模式有三种：singleton（单实例模式）、standard（标准实例模式）、specified（指定实例模式）。

Singleton启动模式

Singleton启动模式为单实例模式，是默认的启动模式。每次调用startAbility()方法时，如果应用进程中该类型的UIAbility实例已经存在，则复用该实例。系统中只存在唯一一个该UIAbility实例。

{
  "module": {
    // ...
    "abilities": [
      {
        "launchType": "singleton",
        // ...
      }
    ]
  }
}

Standard启动模式

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

{
  "module": {
    // ...
    "abilities": [
      {
        "launchType": "standard",
        // ...
      }
    ]
  }
}

Specified启动模式

Specified启动模式为指定实例模式，允许为UIAbility实例创建一个唯一的Key，后续每次调用startAbility()方法时，都会询问应用使用哪个Key对应的UIAbility实例来响应请求。

{
  "module": {
    // ...
    "abilities": [
      {
        "launchType": "specified",
        // ...
      }
    ]
  }
}

在指定实例模式下，需要在启动UIAbility时传入自定义参数，如"instanceKey"，用于区分UIAbility实例。

let want = {
    deviceId: '', // deviceId为空表示本设备
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必选
    parameters: { // 自定义信息
        instanceKey: getInstance(),
    },
};

// context

为调用方UIAbility的AbilityContext
this.context.startAbility(want).then(() => {
    // ...
}).catch((err) => {
    // ...
});

在被调用方UIAbility的AbilityStage中，通过onAcceptWant()生命周期回调返回一个字符串Key标识，用于匹配已创建的UIAbility实例。

import AbilityStage from '@ohos.app.ability.AbilityStage';

export default class MyAbilityStage extends AbilityStage {
    onAcceptWant(want): string {
        // 在被调用方的AbilityStage中，针对启动模式为specified的UIAbility返回一个UIAbility实例对应的一个Key值
        // 当前示例指的是module1 Module的FuncAbility
        if (want.abilityName === 'FuncAbility') {
            // 返回的字符串Key标识为自定义拼接的字符串内容
            return `ControlModule_EntryAbilityInstance_${want.parameters.instanceKey}`;
        }

        return '';
    }
}

例如，在文档应用中，可以将文件路径作为一个Key标识，实现每次新建文档都创建一个新的UIAbility实例，而打开已保存的文档时重用相应的UIAbility实例。

以上就是HarmonyOS UIAbility组件的概述、声明配置、生命周期、以及启动模式的详细介绍。通过了解这些知识点，开发者可以更好地利用UIAbility组件构建丰富的HarmonyOS应用。

HarmonyOS UIAbility组件进阶

WindowStage和UI界面

在HarmonyOS中，UIAbility组件的界面展示主要通过WindowStage和UI界面来实现。WindowStage代表着UIAbility的窗口舞台，而UI界面则通过加载相应的页面来完成展示。

WindowStage的创建和销毁

在UIAbility实例创建完成后，在进入Foreground状态之前，系统会创建一个WindowStage。在onWindowStageCreate()回调中，可以设置UIAbility要加载的页面，并订阅WindowStage的事件。

import UIAbility from '@ohos.app.ability.UIAbility';
import Window from '@ohos.window';

export default class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage: Window.WindowStage) {
        // 设置WindowStage的事件订阅（获焦/失焦、可见/不可见）

        // 设置UI界面加载
        windowStage.loadContent('pages/Index', (err, data) => {
            // ...
        });
    }

    // ...
}

对应的，在UIAbility实例销毁之前，会先进入onWindowStageDestroy()回调，可以在该回调中释放UI界面资源。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
    // ...

    onWindowStageDestroy() {
        // 释放UI界面资源
    }
}

UI界面的加载

在onWindowStageCreate()回调中，通过loadContent()方法设置UIAbility要加载的页面。这里的页面路径可以是相对路径，也可以是绝对路径。

import UIAbility from '@ohos.app.ability.UIAbility';
import Window from '@ohos.window';

export default class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage: Window.WindowStage) {
        // 设置WindowStage的事件订阅（获焦/失焦、可见/不可见）

        // 设置UI界面加载
        windowStage.loadContent('pages/Index', (err, data) => {
            // ...
        });
    }

    // ...
}

生命周期状态说明

UIAbility的生命周期包括Create、Foreground、Background、Destroy四个状态，如下图所示。

生命周期示例

下面以一个简单的示例说明UIAbility的生命周期状态变化：

import UIAbility from '@ohos.app.ability.UIAbility';
import Window from '@ohos.window';

export default class EntryAbility extends UIAbility {
    onCreate(want, launchParam) {
        // Create状态
        console.info('onCreate');
    }

    onWindowStageCreate(windowStage: Window.WindowStage) {
        // WindowStageCreate状态
        console.info('onWindowStageCreate');

        // 设置UI界面加载
        windowStage.loadContent('pages/Index', (err, data) => {
            // ...
        });
    }

    onForeground() {
        // Foreground状态
        console.info('onForeground');
    }

    onBackground() {
        // Background状态
        console.info('onBackground');
    }

    onDestroy() {
        // Destroy状态
        console.info('onDestroy');
    }
}

在应用加载过程中，onCreate()回调表示Create状态，之后进入Foreground状态前会触发onWindowStageCreate()回调，然后在切换至后台和销毁时分别触发onBackground()和onDestroy()回调。

UIAbility组件启动模式进阶

在前面提到的UIAbility的启动模式中，除了基本的singleton、standard、specified启动模式外，还可以根据实际场景进行灵活的配置和使用。

使用singleton启动模式

singleton启动模式为单实例模式，默认情况下的启动模式。每次调用startAbility()方法时，如果应用进程中已存在该类型的UIAbility实例，则系统会复用该实例。系统中只存在唯一一个该UIAbility实例。

在`module.json5

`配置文件中的"abilities"标签下的"launchType"字段配置为"singleton"即可。

{
    "module": {
        // ...
        "abilities": [
            {
                "launchType": "singleton",
                // ...
            }
        ]
    }
}

使用standard启动模式

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

在module.json5配置文件中的"abilities"标签下的"launchType"字段配置为"standard"即可。

{
    "module": {
        // ...
        "abilities": [
            {
                "launchType": "standard",
                // ...
            }
        ]
    }
}

使用specified启动模式

specified启动模式为指定实例模式，允许在UIAbility实例创建之前为其创建一个唯一的字符串Key。每次调用startAbility()方法时，会询问应用使用哪个Key对应的UIAbility实例来响应请求。如果匹配有该UIAbility实例的Key，则直接拉起与之绑定的UIAbility实例，否则创建一个新的UIAbility实例。

在module.json5配置文件中的"abilities"标签下的"launchType"字段配置为"specified"即可。

{
    "module": {
        // ...
        "abilities": [
            {
                "launchType": "specified",
                // ...
            }
        ]
    }
}

指定实例模式的使用场景

specified启动模式适用于一些特殊场景，例如文档应用中每次新建文档希望都能新建一个文档实例，而重复打开一个已保存的文档时希望打开的都是同一个文档实例。

在使用指定实例模式时，需要在UIAbility实例创建之前为其创建一个唯一的字符串Key。在启动UIAbility时，通过自定义参数传递这个Key，用于匹配已创建的UIAbility实例。

例如，有两个UIAbility：EntryAbility和FuncAbility，其中FuncAbility配置为specified启动模式。在EntryAbility中调用startAbility()方法启动FuncAbility时，需要在want参数中增加一个自定义参数来区别UIAbility实例，例如增加一个"instanceKey"自定义参数。

// 在启动指定实例模式的UIAbility时，给每一个UIAbility实例配置一个独立的Key标识
// 例如在文档使用场景中，可以用文档路径作为Key标识
function getInstance() {
    // ...
}

let want = {
    deviceId: '', // deviceId为空表示本设备
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必选
    parameters: { // 自定义信息
        instanceKey: getInstance(),
    },
}

// context为调用方UIAbility的AbilityContext
this.context.startAbility(want).then(() => {
    // ...
}).catch((err) => {
    // ...
});
在被调用方UIAbility的AbilityStage中，通过onAcceptWant()生命周期回调返回一个字符串Key标识，用于匹配已创建的UIAbility实例。

import AbilityStage from '@ohos.app.ability.AbilityStage';

export default class MyAbilityStage extends AbilityStage {
    onAcceptWant(want): string {
        // 在被调用方的AbilityStage中，针对启动模式为specified的UIAbility返回一个UIAbility实例对应的一个Key值
        // 当前示例指的是module1 Module的FuncAbility
        if (want.abilityName === 'FuncAbility') {
            // 返回的字符串Key标识为自定义拼接的字符串内容
            return `ControlModule_EntryAbilityInstance_${want.parameters.instanceKey}`;
        }

        return '';
    }
}

例如，在文档应用中，可以对不同的文档实例内容绑定不同的Key值。每次新建文档时，可以传入不同的新Key值（如将文件的路径作为一个Key标识），此时AbilityStage中启动UIAbility时都会创建一个新的UIAbility实例。而当新建的文档保存之后，回到桌面，或者新打开一个已保存的文档，再次打开该已保存的文档时，AbilityStage中再次启动该UIAbility时，打开的仍然是之前原来已保存的文档界面。

// 在文档应用中，可以对不同的文档实例内容绑定不同的Key值
// 当每次新建文档时，传入不同的新Key值（如可以将文件的路径作为一个Key标识）
// 此时AbilityStage中启动UIAbility时都会创建一个新的UIAbility实例
// 而当新建的文档保存之后，回到桌面，或者新打开一个已保存的文档，再次打开该已保存的文档时，
// AbilityStage中再次启动该UIAbility时，打开的仍然是之前原来已保存的文档界面

这样，通过指定实例模式的配置，可以实现更加灵活和符合业务场景的UIAbility启动方式。

结语

通过本文，我们详细介绍了HarmonyOS UIAbility组件的生命周期、WindowStage的创建和销毁、UI界面的加载，以及UIAbility的启动模式。通过了解这些知识点，开发者可以更好地利用UIAbility组件构建丰富的HarmonyOS应用。同时，对于启动模式的理解和灵活运用，可以根据不同业务场景选择合适的模式，提升应用的用户体验。希望本文对于HarmonyOS开发者能够提供有益的参考和帮助。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/347142.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

Python环境的安装和Pycharm的安装

Python环境的安装和Pycharm的安装

Python环境的安装 英文版官网：Welcome to Python.org， 因为是外网，加载可能会很慢 首先呢，我们先去官网查找：Python中文网 官网，这个官网是中文版的，点进去之后是这个页面 然后点击下载&#…
阅读更多...
【LeetCode每日一题】2859. 计算 K 置位下标对应元素的和

【LeetCode每日一题】2859. 计算 K 置位下标对应元素的和

2024-1-25 文章目录 [2859. 计算 K 置位下标对应元素的和](https://leetcode.cn/problems/sum-of-values-at-indices-with-k-set-bits/)思路： 2859. 计算 K 置位下标对应元素的和 思路： 遍历输入列表，对于满足特定条件的元素做一些操作并将结…
阅读更多...
Django从入门到精通（二）

Django从入门到精通（二）

目录 三、视图 3.1、文件or文件夹 3.2、相对和绝对导入urls 3.3、视图参数requests 3.4、返回值 3.5、响应头 3.6、FBV和CBV FBV 四、静态资源 4.1、静态文件 4.2、媒体文件 五、模板 5.1、寻找html模板 5.2、模板处理的本质 5.3、常见模板语法 5.4、内置模板函…
阅读更多...
Sketch怎么增加组件?

Sketch怎么增加组件?

Sketch怎么增加组件？Sketch组件库经常使用，想要添加一些新的组件，该怎么添加呢？下面我们就来看看Sketch组件库添加新组建的技巧，详细请看下文介绍 打开电脑，找到sketch软件的图标，点击进入 新建…
阅读更多...
鸿蒙开发-UI-布局-轮播

鸿蒙开发-UI-布局-轮播

鸿蒙开发-UI-布局 鸿蒙开发-UI-布局-线性布局 鸿蒙开发-UI-布局-层叠布局 鸿蒙开发-UI-布局-弹性布局 鸿蒙开发-UI-布局-相对布局 鸿蒙开发-UI-布局-格栅布局 鸿蒙开发-UI-布局-列表 鸿蒙开发-UI-布局-网格 文章目录 前言 一、基本概念 二、开发布局 三、应用特性 1.循环播放 2…
阅读更多...
docker(上)

docker(上)

笔记资料参考与尚硅谷 前提知识课程介绍课程定位学习建议 1前提知识 boot cloud git push pull redis nginx mysql... Linux centos ubuntu 2课程介绍 2.1 2018 vs 2022 2.2 k8s（雷峰崖） 2.3 大纲 3课程定位（因材施教量体裁衣…
阅读更多...
电商API接口|爬虫实战-js逆向,以淘宝sign为例

电商API接口|爬虫实战-js逆向,以淘宝sign为例

如果我们想要获取某宝的商品信息或者商品的评论信息的话。可能其中的一条途径就是爬虫了【淘宝商品详情API】。放在以前的话，爬虫还是挺简单的。但是放到现在呢，其实并不容易了。因为现在各个平台的反爬机制都加强了。有的会加强监控的，有的则…
阅读更多...
使用IntelliJ IDEA快速搭建springboot 基础模板项目

使用IntelliJ IDEA快速搭建springboot 基础模板项目

使用IntelliJ IDEA快速搭建springboot 基础模板项目！今天和大家分享一下，如何使用IntelliJ IDEA里面的maven插件，来快速搭建一个简单的Springboot基础项目。 第一步，菜单里面找到，文件-》新建-项目。如图。我们勾选了是…
阅读更多...
Zookeeper3.5.7基础学习

Zookeeper3.5.7基础学习

文章目录 一、Zookeeper入门1、概述2、特点3、数据结构4、应用场景 二、Zookeeper 安装部署1、本地模式安装1.1 基础操作1.2 配置参数解读 2、集群部署2.1 集群安装2.2 选举机制(面试重点)2.3 ZK 集群启动停止脚本 三、ZK客户端相关操作1、客户端命令行操作1.1 命令行语法1.2 z…
阅读更多...
车载显示，“激斗”与“换代”

车载显示，“激斗”与“换代”

编者按：车载显示，正在进入新一轮变革周期。 车载显示作为汽车智能化的重要交互终端，在过去几年，持续受益车企的大屏化、多屏化配置趋势，部分头部厂商赚得盆满钵满。 比如，作为京东方旗下唯一的车载显示模组…
阅读更多...
携程基于Jira Cloud的敏捷项目管理实践

携程基于Jira Cloud的敏捷项目管理实践

好的工具可以满足团队在各个成长阶段的管理诉求 实践一：对齐目标/团队OKR/多团队协作战略项目 实践二：以产品为中心的协作框架 实践三：交付团队管理 实践四：和海外子公司对齐，协作
阅读更多...
guitarpro8有免费版本吗? Guitar Pro需要多少钱

guitarpro8有免费版本吗? Guitar Pro需要多少钱

Guitar Pro8官方并没有提供一个完全免费的版本。然而，根据搜索结果，存在一个声称是Guitar Pro免费版的V8.0.1.28版本，这个版本被描述为一款可以自动谱曲的简单实用的谱曲软件。此外，还有信息称Guitar Pro免费版能够在不需要支付费…
阅读更多...
在linux、window环境搭建kafka环境

在linux、window环境搭建kafka环境

一、搭建环境前置准备 下载kafka的官网 http://kafka.apache.org/downloads根据自己的需求选择版本，安装包不区分linux和windows环境，这一个安装包均可部署。 源代码包含kafka的代码文件，使用scala编写的。 二、linux环境 1. 上传安装包 我下载的版本是kafka_2.12-3.6.1…
阅读更多...
php中laravel框架中接口开发实战经验总结

php中laravel框架中接口开发实战经验总结

一.项目接口实战错误经验总结 1. 逻辑层静态类调用非静态方法报错，如下 Non-static method App\\Services\\Common\\StatisticBusinessService::getLevelUserCarCount() should not be called statically 问题原因:方法定义时没加static 解决方案： …
阅读更多...
Threejs 问题——模型引入后并未加载出来

Threejs 问题——模型引入后并未加载出来

文章目录 问题分析 问题 Threejs 模型引入后并未加载出来 分析 该问题是由于引入OBJ模型路径报错 目前测试 在 public/static/ 引入时不会发生此错误并渲染成功 如果没有此报错且模型没渲染出来, 可以尝试刷新标签页或者异步请求模型方法 我的路径如下 引用如下 createM…
阅读更多...
【2024】新建mysql数据库，如何选择字符集和排序规则

【2024】新建mysql数据库，如何选择字符集和排序规则

如何使用 Navicat 新建 MySQL 数据库，并选择字符集与排序规则 如何使用 Navicat 新建 MySQL 数据库并选择字符集与排序规则1. 开始之前2. 新建数据库步骤 1: 打开 Navicat步骤 2: 创建新数据库步骤 3: 填写数据库名称 常见的字符集和排序规则及其选择场景1. 字符集&…
阅读更多...
MCU常用外设总线

MCU常用外设总线

目录 前言一、时钟与中断二、GPIO三、ADC四、定时器4.1 基本定时器4.2 通用定时器4.2.1 输入捕获4.2.2 输出比较 五、UART5.1 通讯的基本概念5.1.1 串行通讯与并行通讯5.1.2 全双工、半双工及单工通讯5.1.3 同步通讯与异步通讯5.1.4 通信速率 5.2 异步串口UART5.2.1 物理层5.2.…
阅读更多...
谷达冠楠：现在开网店到底靠谱吗

谷达冠楠：现在开网店到底靠谱吗

在互联网高速发展的当下，开网店已成为众多创业者的选择。然而，面对激烈的市场竞争和不断变化的网络环境，人们不禁要问：现在开网店到底靠谱吗? 我们必须认识到，任何商业行为都存在风险，开网店也不例外。但是…
阅读更多...
Python + Selenium —— 网页元素定位之标签名和链接文本定位

Python + Selenium —— 网页元素定位之标签名和链接文本定位

tag name tag name 为标签名定位，使用网页元素的标签名如a, div, input, span 等。 但是有一个问题，常见的标签名比如 在同一个页面上有非常多。会不会觉得 tag name 没什么用呢？ 当然普通的模拟操作是不大有用，这个重复性实在…
阅读更多...
Spring如何使用自定义注解来实现自动管理事务？

Spring如何使用自定义注解来实现自动管理事务？

人可以做他(她)想做的，但不能要他(她)想要的 一个目录 前言业务代码展示手动挡自动挡事务失效的问题代码地址 前言 在两年半以前，我写了一篇博客：框架的灵魂之注解基础篇： 在那篇博客的结尾，我埋了一个坑&#xff1a…
阅读更多...
最新文章

Copyright @ 2022~2023