鸿蒙开发之UIAbility生命周期

一、UIAbility组件概述

UIAbility组件是HarmonyOS中一种包含UI界面的应用组件,主要用于与用户进行交互。每个UIAbility组件实例对应最近任务列表中的一个任务,可以包含多个页面来实现不同功能模块。简单明了的说,UIAbility类似于Android的Activity,类似于iOS的ViewCcontroller。

声明配置

为了使用UIAbility,首先需要在module.json5配置文件的abilities标签中声明UIAbility的相关信息,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组件启动页面背景颜色资源文件的索引
    "exported": true,  "skills": [    {      "entities": [        "entity.system.home"      ],      "actions": [        "action.system.home"      ]

    // ...

  }

]

}

}

其中,skills 是一个字符串数组,定义了这个能力所具备的技能。actions 是一个字符串数组,定义了这个能力对应的动作。exported 标签在 abilities 下的 service 标签内部使用,用来指示当前服务是否允许其他应用导入。

二、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 '';

}

}

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容