使用FeatureAbility模块启动其他Ability

系统 OpenHarmony
本节以API8为主,关于Stage模型的详细介绍将在今后的章节中介绍。此处的FA是一种模型,其中的Ability分为PageAbility、ServiceAbility、DataAbility、FormAbility,与FA(FeatureAbility不能混淆)。

​想了解更多关于开源的内容,请访问:​

​51CTO 开源基础软件社区​

​https://ost.51cto.com​

1、前言

在HarmonyOS/OpenHarmony应用程序中一切皆Ability(能力),即是每个界面都可以是Ability,每个功能都可以是Ability,又将Ability分为FA(FeatureAbility)和PA(ParticleAbility)两种类型。其中FA唯一支持的模板Page Ability,其用于提供与用户交互能力,在设备主界面上有可见的桌面图标,能够通过图标启动应用程序进行交互操作;而PA又分为Service Ability和Data Ability,前者用于提供后台运行任务的能力,后者用于应用管理自身和其他应用存储数据的访问能力,因此PA是无界面的,用户无法对其直接操作,可以和FA配合使用。

在JS/eTS语言中,Ability框架又被分为FA模型和Stage模型(该模型目前仅支持OpenHarmony API9)。在DevEco Studio 3.0 Beta4中HarmonyOS使用了OpenHarmony API8,因此可以大胆猜测一下后续API版本会不会以OpenHarmony API版本为主。 本节以API8为主,关于Stage模型的详细介绍将在今后的章节中介绍。此处的FA是一种模型,其中的Ability分为PageAbility、ServiceAbility、DataAbility、FormAbility,与FA(FeatureAbility不能混淆)。

  • PageAbility 是用户可见并可交互的Ability实例,可开发在设备主界面上具有入口图标的应用程序。
  • ServiceAbility 运行在后台的、无界面的,用户不可直接操作的,可以通过Page Ability调起。
  • DataAbility 为其他Ability提供数据访问的支撑,也是运行在后台的、无界面的。
  • FormAbility 是卡片Ability,是一种新型的Ability,用于呈现特定信息的入口界面。

JS/eTS语言是方舟开发框架(ArkUI)为开发者开发应用程序提供的两种开发范式,前者是基于JS扩展的类Web开发范式,若开发者具备小程序开发经验则可直接上手,更倾向于Web前端开发人员;而后者则是基于TS扩展的声明式开发范式,与Flutter开发应用程序类似,更倾向于移动系统应用和系统应用开发人员。

2、准备工作

  • 开发工具:DevEco Studio 3.0 Beta4。
  • 运行设备:P50(HarmonyOS3.0) / DAYU200(OpenHarmony 3.0 Beta2)。
  • 桌面工具:Scrcpy(用于在PC桌面上共享P50界面,OpenHarmony暂无)。
  • 使用DevEco Studio创建开发语言为eTS语言,编译版本为8,项目名称为FaeTSSample的HarmonyOS应用程序(由于DevEco Studio 3.0 Beta4特性,HarmonyOS和OpenHarmony互通,当前HarmonyOS的应用程序可以直接运行在OpenHarmony操作系统的设备上)。

3、有界面的PageAbility

通过DevEco Studio创建Application(应用程序)会默认创建PageAbility模板代码,在ArkUI框架中,PageAbility相关能力是通过单独的featureAbility模块实现的,其由于为用户提供了可交互的界面,因此生命周期较于其他Ability复杂度较高,PageAbility生命周期回调通过app.js/app.ets中的函数实现,当前app.js仅支持onCreate和onDestroy回调,而app.ets支持全量生命周期回调,本节以eTS语言为主,主要介绍eTS语言开发中PageAbility生命周期回调,如下图所示:

使用FeatureAbility模块启动其他Ability-开源基础软件社区

可以在app.ets中将所有的声明周期函数重写,并运行应用程序查看声明周期回调信息,代码如下所示:

export default {
onCreate() {
console.info('FaeTSSample Application onCreate')
},
onActive() {
console.info('FaeTSSample Application onActive')
},
onInactive() {
console.info('FaeTSSample Application onInactive')
},
onHide() {
console.info('FaeTSSample Application onHide')
},
onShow() {
console.info('FaeTSSample Application onShow')
},
onDestroy() {
console.info('FaeTSSample Application onDestroy')
},
}

使用FeatureAbility模块启动其他Ability-开源基础软件社区

(1)使用featureAbility模块启动本地PageAbility

HarmonyOS/OpenHarmony为用户提供了路由跳转方式,而路由跳转方式是页面间跳转,可以利用featureAbility模块进行Ability之间的跳转,并且featureAbility仅能在PageAbility类型的Ability中调用。

使用featureAbility模块需要先在具体的业务逻辑界面使用以下代码引入模块:

import featureAbility from '@ohos.ability.featureAbility';

featureAbility模块提供了多个方法用于启动新的Ability、获取dataAbilityHelper、设置此PageAbility、获取当前Ability对应的窗口、连接服务等能力。featureAbility提供的启动新Ability能力如下表所示:

名称

描述

startAbility

启动新的Ability

startAbilityForResult

启动新的Ability,并在该Ability被销毁时返回执行结果

接下来聊聊在应用程序中如何启动新的Ability,首先在项目entry目录右键New–>Ability --> Page Ability,填写Ability相关信息如下图所示。

使用FeatureAbility模块启动其他Ability-开源基础软件社区

目录结构如下图所示:

使用FeatureAbility模块启动其他Ability-开源基础软件社区

startAbility方法有两种调用形式,一种是callback,另一种是Promise,都需要传递StartAbilityParameter参数设定目标Ability。

startAbility(StartAbilityParameter, AsyncCallback<number>): void
startAbility(StartAbilityParameter): Promise<number>

其中StartAbilityParameter参数由Want(包含有关目标Ability信息)和abilityStartSetting(可以通过该属性携带参数,不是必须条件)。其中国Want参数提供系统的基本通信能力,比如在打开时指定新启动的Ability信息,或者销毁启动的Ability后返回的额外信息。点击MainAbility中的按钮启动SecondAbility,修改代码如下所示:

// MainAbility/page/index.ets
featureAbility.startAbility({
want: {
bundleName: "com.tetcl.fts", // 包描述,对应config.json中的app.bundleName,当然也可以是本机其他应用的包名
abilityName: "com.example.entry.SecondAbility" // 目标Ability名称,对应config.json中的module.package.类名
}
})

使用真机设备运行应用程序,点击按钮,查看是否跳转到Second Ability界面。

使用FeatureAbility模块启动其他Ability-开源基础软件社区

(2)使用featureAbility模块启动远程PageAbility

在Want模块中,有一个deviceId属性,该属性表示运行指定Ability的设备ID,也就是若我们知道了其他设备的标识码和包名称以及具体的Ability名称,我们就可以启动其他设备的应用程序。该属性的值需要使用DeviceManager模块的接口获取,当前仅对系统应用开放,也就是自定义的应用程序是无法调起它的Ability。由于设备有限,无法提供测试,因此具体的操作详见官方文档。

​想了解更多关于开源的内容,请访问:​

​51CTO 开源基础软件社区​

​https://ost.51cto.com​​。

责任编辑:jianghua 来源: ​​51CTO开源基础软件社区
相关推荐

2021-01-06 10:59:14

鸿蒙HarmonyOSPage Abilit

2023-03-24 14:52:27

AbilityPage应用

2022-05-24 15:06:57

AbilityeTS FA鸿蒙

2022-09-08 15:18:51

Ability鸿蒙

2015-05-12 10:47:49

openstack k开源分析

2022-02-17 21:05:26

AbilityJS FAJava PA

2014-01-15 11:25:30

2024-11-01 10:30:05

2018-03-28 08:09:54

ABB Ability工业云边缘计算

2010-03-22 15:38:46

Python常用模块

2022-12-30 08:17:28

Gradle多模块项目

2010-07-20 13:02:03

SQL Server索

2011-03-31 13:40:48

2021-07-29 14:03:35

鸿蒙HarmonyOS应用

2022-03-04 09:59:16

logging模块函数程序

2023-03-09 15:55:17

JavaScriptURLCSS

2022-11-22 13:00:38

2010-08-18 13:58:46

路由器启动顺序

2021-06-18 14:55:57

鸿蒙HarmonyOS应用

2022-02-09 19:37:00

Ability鸿蒙开发
点赞
收藏

51CTO技术栈公众号