深圳幻海软件技术有限公司 欢迎您!

搞不懂 HarmonyOS 原子化服务?各位开发者看这里

2023-02-27

而在万物互联的时代,人均持有设备量不断攀升,设备和场景的多样性,每个设备都需要独立开发一个应用,先安装后使用、不同设备的能力不兼容等传统应用的短板逐步暴露出来。在此背景下,应用提供方和用户都迫切需要一种新的服务提供方式,使应用开发更简单、服务(如听音乐、打车等)的获取和使用更便捷。基于此,Harmo

而在万物互联的时代,人均持有设备量不断攀升,设备和场景的多样性,每个设备都需要独立开发一个应用,先安装后使用、不同设备的能力不兼容等传统应用的短板逐步暴露出来。在此背景下,应用提供方和用户都迫切需要一种新的服务提供方式,使应用开发更简单、服务(如听音乐、打车等)的获取和使用更便捷。基于此,HarmonyOS提供了原子化服务。

一、原子化服务是什么?

相信很多开发者小伙伴听说过“原子化服务”,又或者是“元服务”。其实,元服务就是原子化服务。那么原子化服务到底是什么呢?接下来就带开发者详细了解下。

原子化服务是HarmonyOS提供的一种面向未来的服务方式,是有独立入口的(用户可通过点击方式直接触发)、免安装的(无需显式安装,由系统后台安装后即可使用)、可为用户提供一个或多个便捷服务的用户应用程序形态。

例如:传统方式的购物应用,在按照原子化服务理念调整设计后,可以由多个服务直达、免安装的原子化服务实现,比如“商品浏览”、“购物车”、“支付”等。

二、如何体验原子化服务?

为了帮助开发者更好地了解原子化服务到底是什么,下面就和开发者小伙伴们一起体验一下原子化服务。

2.1多种入口

我们可以通过多种方式发现原子化服务:

  1. 一种为NFC标签,另一种为多功能码。NFC标签为物理打印标签,支持手机碰一碰使用相应服务。多功能码可以为物理打印的标签,支持手机碰一碰及扫一扫使用相应服务,也可以为屏幕上呈现的电子标签,支持扫一扫。多功能码有两种样式,分别用于跨设备体验和三方服务。
  2. 用户也可以在设备的服务中心、桌面等地方发现并管理原子化服务。
  3. 原子化服务可以基于合适场景被主动推荐给用户使用;用户也可以在服务中心和小艺建议中发现系统推荐的服务。

说明:“小艺”是语音助手在华为设备中的名字。小艺可以回答用户的问题、控制家居设备、执行用户的日常任务等;而且,小艺可以通过不同设备感知用户的使用场景,推荐用户可能需要的服务

2.2服务卡片

与传统应用不同,原子化服务在设备桌面没有应用图标,是通过服务卡片的形式将重要信息展示在服务中心或者桌面。用户点击服务卡片,即可进入原子化服务的服务界面。
服务卡片的核心理念在于提供用户容易使用且一目了然的信息内容,将智慧化能力融入到服务卡片的体验中供用户选择使用,同时满足在不同终端设备上的展示和自适应。

值得注意的是,原子化服务和HarmonyOS应用都支持服务卡片。对于原子化服务,服务卡片是必选的,每个原子化服务至少有一个服务卡片。而对于HarmonyOS应用,服务卡片是可选配置。
说明:HarmonyOS应用,即运行在HarmonyOS系统上且具备HarmonyOS特性的应用。

2.3服务流转

原子化服务支持运行在1+8+N设备上。

  • “1”代表手机
  • “8”代表平板、智慧屏、音箱、眼镜、手表、车机、耳机、PC
  • “N”代表运动健康、智能家居、智慧出行、智慧办公、影音娱乐等场景延伸的泛IoT设备。

原子化服务的流转能力打破设备界限,多设备联动,使原子化服务可分可合、可流转,实现如邮件跨设备编辑、多设备协同健身、多屏游戏等分布式业务。原子化服务的流转触发方式有两种:系统推荐流转和用户手动流转。

①系统推荐流转:用户使用原子化服务时,如果所处环境中存在使用体验更优的可选设备,则系统自动为用户推荐该设备,用户可确认是否启动流转。

②用户手动流转:用户可以手动选择合适的设备进行流转。用户点击图标后,会调起系统提供的流转面板。面板中会展示出原子化服务的信息及可流转的设备,引导用户进行后续的流转操作。

2.4服务分享

原子化服务所提供的便捷服务,可以通过接入华为分享实现近距离快速分享,使便捷服务可以精准快速的推送至接收方,降低用户触达服务的成本,提升用户体验。相比于传统的社交软件分享,分享双方无需建立好友关系,接收方无需提前安装承载服务的安装包,即可享受原生的服务体验。

用户可在原子化服务内选择分享,打开“华为分享”开关后,将原子化服务分享给附近同样打开了“华为分享”开关的好友,好友点击确认后直接启动服务。下图是通过“华为分享”分享购物类原子化服务的典型场景。

三、原子化服务的优势在哪里?

3.1 一次开发,多端部署

对于开发者而言,原子化服务只需开发一次,便可以部署在各种HarmonyOS终端上,大大降低了开发成本。

对于传统的APP软件开发者来说,一个绕不开的烦恼就是同一个APP需要分别针对不同的设备进行适配。比如程序员在手机上开发了一款应用,针对手表需要重新适配、发布到手表的应用市场;针对大屏适配后,再发布到大屏的应用市场,严重影响了应用的开发效率和变现能力。

HarmonyOS在架构设计之初,就提出了一次构建支持多端部署的架构设计原则。HarmonyOS通过提供用户程序框架、Ability框架以及UI框架,能够保证开发的应用在多终端运行时保证一致性。多终端软件平台API具备一致性,确保用户程序的运行兼容性。

如此一来,开发者仅需为不同形态的设备配置不同参数,IDE就能够自动生成支持多设备分发的APP包。APP包上架应用市场后,应用市场会自动按照设备类型进行HAP包的拆分、组装和分发,进而端到端实现了一次开发,支持多端部署的设计。

具体流程如下:

  • 开发阶段,IDE基于包格式编译打包支持多设备的应用包。
  • 上架到应用市场。
  • 在云侧对App进行拆包,部署到CDN(Content Delivery Network,内容分发网络),包信息同步到服务分发中心。
  • 端侧运行过程中,根据自身设备类型获取相应的HAP及整体摘要信息。

3.2 免安装,秒级打开

消费者不感知安装过程和卸载过程,体验全新升级。

HarmonyOS 原子化服务是轻量化服务的新物种,它提供了全新的服务和交互方式。用户在使用原子化服务时,如果服务未部署,系统将通过云端自动部署服务,部署成功后即可使用对应服务。例如,在服务中心点击服务卡片,原子化服务通过免安装能力完成部署和运行,实现服务直达的业务体验。无须用户跳转到传统的应用分发市场,搜索下载目标应用,使得在设备上部署应用更加快速。

随着分布式场景生态的丰富,原子化服务要始终以人为中心,在不同设备间流转。当用户走到大屏设备前,手机上的视频电话可以流转到大屏沟通,当用户走到电脑前,手机和电脑可以协同办公,原子化服务能够在不干扰用户的情况下完成了自动部署,同时,系统会智能地清理已部署的低频服务。

这就是原子化服务的免安装能力,一方面提升开发者上架应用的分发效率和转化率,一方面提升消费者的服务体验,减少安装过程对用户的干扰。

3.3以人为中心,分布式流转

分布式流转是实现原子化服务以人为中心的核心技术。

随着5G和IoT设备的发展,个人拥有了多个智能设备也逐步成为主流场景。手机、笔记本、平板、电视、运动手表、耳机、冰箱、抽油烟机、智能门锁等这类智能设备在搭载HarmonyOS系统后,通过分布式软总线连接起来,就可以形成一个超级的终端。不同的设备之间,通过重新业务组合,可以形成新的用户体验。

例如:用户坐在书桌前用手机观看视频,又希望转移到客厅,坐在沙发上用大屏继续视频的观看。业界大多采用投屏的方案实现,如DLNA、Cast+等。而原子化服务采用的分布式组件流转的技术,简单来讲,就是HarmonyOS系统管理着原子化服务进程实体的上下文环境(打开的文件句柄,硬件,运行状态),并对上下文数据进行跨设备的备份、传输和恢复。如下图示意:

对于用户来说,流转操作应当是便捷的,高效的,无副作用的。用户可以进行反复流转,应用实体能够始终维持其状态。为了保证用户交互的一致性,流转的入口由系统统一提供。对于应用程序的一致性,由开发者维护。例如:当应用从手机迁移到大屏之后,其控件、样式、布局等方面应当尽可能保持一致。但“一致”不意味着“一样”:针对手机,平板电脑或者大屏各自屏幕的特征,其用户界面应当做好相应的适配。

3.4对比App Clips和小程序,有什么优势?

App Clips和小程序本质上都是针对服务线上化、交易闭环的场景在定义产品,天然追求随处可及和服务直达的特性。原子化服务与之相比,有以下优势:

原子化服务是面向未来超级终端的服务形态,覆盖更广泛的IoT设备,具备1+8+N设备兼容的API接口,这也是原子化服务相比APP Clips和小程序更具竞争力的根基。
原子化服务是基于分布式全场景体验目标而设计的,也是与App Clips和小程序在设计理念上的最大不同。HarmonyOS提供了超强的分布式能力,能够让开发者快速实现一个分布式业务。
原子化服务有服务中心、碰一碰、扫一扫、卡片分享、流转业务触发等相比App Clips和小程序更为丰富的入口, 支持服务快速直达。

四、如何开发原子化服务?

便捷的原子化服务如何开发?这应该是开发者小伙伴更关注的问题,下面就来详细介绍。

4.1总体开发要求

  1. 原子化服务的所有HAP包均需要满足免安装要求。
  2. 免安装的HAP包不能超过10MB。
  3. 原子化服务升级时,新版本也要保持免安装属性。
  4. 目前支持免安装的HAP的设备类型有:手机、平板、智慧屏、智能穿戴,版本均需要在HarmonyOS 2版本及以上。
  5. 原子化服务如果要在服务中心露出,则需要满足:
  • 该服务对应的HAP包需要包含FA,且指定唯一的一个“MainAbility”作为用户操作入口。
  • 需要配置一个小尺寸服务卡片(2*2规格),以及配置基础信息:如图标、名称、描述、快照等。

原子化服务的详细设计说明,可以参考官网:
https://developer.harmonyos.com/cn/docs/design/des-guides/service-overview-0000001139795693

4.2开发工具

HUAWEI DevEco Studio(以下简称DevEco Studio)是基于IntelliJ IDEA Community开源版本打造,面向华为终端全场景多设备的一站式集成开发环境(IDE),为开发者提供工程模板创建、开发、编译、调试、发布等E2E的HarmonyOS应用开发服务。

DevEco Studio下载链接:https://developer.harmonyos.com/cn/develop/deveco-studio#download

我们使用DevEco Studio工具来开发原子化服务。该工具的详细使用说明,可以参考官网:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/tools_overview-0000001053582387

4.3开发过程及注意点

创建工程

  1. 运行DevEco Studio工具,在菜单栏选择File > New > New Project。
  2. 根据工程创建向导,选择需要的Ability工程模板,然后点击Next。
  3. 配置工程的基本信息。

  • Project Name:工程的名称,可以自定义。
  • Project Type:工程的类型,Service表示原子化服务,Application表示传统方式的需要安装的应用。因为要创建原子化服务工程,这里选择Service。
  • Device Type:根据需要选择该工程支持的设备类型。支持多选。注:如果勾选了TV,则下面的“Show in Service Center”会消失。
  • Show in Service Center:是否在服务中心露出。开启此开关,则默认创建一张小尺寸(2x2)服务卡片和快照。

点击Finish,工具会自动生成示例代码和相关资源,等待工程创建完成。

工程配置

  1. config.json配置文件

每个HAP的根目录下都存在一个config.json配置文件,文件内容主要涵盖以下三个方面:

  • 应用的全局配置信息,包含应用的包名、生产厂商、版本号等基本信息。
  • 应用在具体设备上的配置信息,包含应用的备份恢复、网络安全等能力。
  • HAP包的配置信息,包含每个Ability必须定义的基本属性(如包名、类名、类型以及Ability提供的能力),以及应用访问系统或其他应用受保护部分所需的权限等。

工程创建完成之后,config.json文件默认包含以下配置内容。

① 免安装配置信息

"distro": { "deliveryWithInstall": true, "moduleName": "entry", "moduleType": "entry", "installationFree": true } 
  • 1.

installationFree为true表示该HAP是免安装的。

② 服务卡片配置信息
由于创建工程时开启了Show in Service Center开关,所以默认配置了此信息。

"abilities": [ 

"skills": [ 
... 
], 
"name": "com.example.atomicservicedemo.MainAbility", 
"icon": "$media:icon", 
"description": "$string:mainability_description", 
"formsEnabled": true, 
"label": "$string:app_name", 
"type": "page", 
"forms": [ 

"jsComponentName": "widget", 
"isDefault": true, 
"scheduledUpdateTime": "10:30", 
"defaultDimension": "2*2", 
"name": "widget", 
"description": "$string:widget_description", 
"colorMode": "auto", 
"type": "JS", 
"supportDimensions": [ 
"2*2" 
], 
"updateEnabled": true, 
"updateDuration": 1 

], 
"launchType": "standard" 


  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.

config.json文件的详细说明,可以参考官网:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/basic-config-file-elements-0000000000034463

  1. 快照

创建工程时,如果开启了Show in Service Center开关,工程创建完成后会在工程目录下自动生成快照(EntryCard)文件夹。如下图所示:

此文件夹下默认生成了一张2x2(小尺寸)的快照(一张png格式的图片)。开发者可以将其替换为事先设计好的2x2快照,样式上应与对应的服务卡片保持一致:将新的快照拷贝到上图目录下,删除默认图片,新图片命名遵循格式“服务卡片名-2x2.png”。

说明:“服务卡片名”可以查看config.json文件的forms数组中的“name”字段。

开发原子化服务

我们重点介绍一下如何将原子化服务接入到华为分享。

以JAVA工程为例,开发步骤如下:

① 新建两个idl文件,用于和华为分享进行跨进程通信。

IHwShareCallback.idl文件:

interface com.huawei.hwshare.third.IHwShareCallback { 
[oneway] void notifyState([in] int state); 

  • 1.
  • 2.
  • 3.


IHwShareService.idl文件:

sequenceable ohos.interwork.utils.PacMapEx; 
interface com.huawei.hwshare.third.IHwShareCallback; 
 
interface com.huawei.hwshare.third.IHwShareService { 
int startAuth([in] String appId, [in] IHwShareCallback callback); 
int shareFaInfo([in] PacMapEx pacMapEx); 

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

开发者只需将.idl文件保存至DevEco Studio项目的src/目录内,工具则会在构建应用时,在项目的generated/目录中生成IRemoteObject接口文件、Stub文件、Proxy文件。IHwShareCallback.idl文件和IHwShareService.idl文件会生成对应的IHwShareCallback.java和IHwShareService.java。


② 新建一个管理类“ShareAtomicServiceManager.java”,用于管理与华为分享的跨进程通信。这里对外暴露一个接口:

public void shareFaInfo(String appId, PacMapEx pacMap) { 
if (mContext == null) { 
return; 

mAppId = appId
mSharePacMap = pacMap
mHandler.removeTask(mTask); 
shareFaInfo(); 
bindShareService(); 

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • appId是应用在应用市场的唯一标识,在创建项目时生成。
  • pacMap是需要传递给华为分享的信息。
  • shareFaInfo()用于分享FA信息到华为分享应用中,代码如下:
private void shareFaInfo() { 
if (mShareService == null) { 
return; 

if (mHasPermission) { 
HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "start shareFaInfo."); 
try { 
mShareService.shareFaInfo(mSharePacMap); 
mSharePacMap = null
} catch (RemoteException e) { 
HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "shareFaInfo error."); 


// 不使用时断开 
mHandler.postTask(mTask, UNBIND_TIME); 

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.

其中,mTask用于执行断连的操作:

private final Runnable mTask = () -> { 
if (mContext != null && mShareService != null) { 
mContext.disconnectAbility(mConnection); 
mHasPermission = false
mShareService = null

}; 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.


另外,绑定华为分享服务的代码如下:

private void bindShareService() { 
if (mShareService != null) { 
// 保证仅连一次。 
return; 

HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "start bindShareService."); 
Operation operation = new Intent.OperationBuilder().withBundleName(SHARE_PKG_NAME) 
.withAction(SHARE_ACTION).withFlags(Intent.FLAG_NOT_OHOS_COMPONENT).build(); 
Intent intent = new Intent(); 
intent.setOperation(operation); 
mContext.connectAbility(intent, mConnection); 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.

其中,mConnection的定义如下:
 

// 管理与华为分享的连接 
private final IAbilityConnection mConnection = new IAbilityConnection() { @Override public void onAbilityConnectDone(ElementName elementName, IRemoteObject iRemoteObject, int i) { HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "onAbilityConnectDone success."); mHandler.postTask(()->mShareService = new HwShareServiceProxy(iRemoteObject); try { mShareService.startAuth(mAppId, mFaCallback); } catch (RemoteException e) { HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "startAuth error."); } }); } @Override public void onAbilityDisconnectDone(ElementName elementName, int i) { HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "onAbilityDisconnectDone."); mHandler.postTask(()->mShareService = nullmHasPermission = false; }); } }; 
  • 1.
  • 2.

mShareService.startAuth(mAppId, mFaCallback)是对appId进行验证,验证成功之后会通过mFaCallback回调。mFaCallback的代码如下:

private final HwShareCallbackStub mFaCallback = new HwShareCallbackStub("HwShareCallbackStub") { 
@Override 
public void notifyState(int state) throws RemoteException { 
mHandler.postTask(()->
HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "notifyState: " + state); 
if (state == 0) { 
mHasPermission = true
if (mSharePacMap != null) { 
shareFaInfo(); 


}); 

}; 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.

state为0时表示认证通过,可以进行分享。

③ 在MainAbilitySlice.java中,调用连接华为分享的接口:

ShareAtomicServiceManager.getInstance(this).shareFaInfo("629005930163350400", getPacMap()); 
  • 1.

"629005930163350400"是appId,每个应用不一样,需要替换成应用自己的appId。getPacMap是获取需要分享的内容封装方法。

private PacMapEx getPacMap() { 
PacMapEx pacMap = new PacMapEx(); 
pacMap.putObjectValue(ShareAtomicServiceManager.SHARING_FA_TYPE, 0); 
pacMap.putObjectValue(ShareAtomicServiceManager.HM_BUNDLE_NAME, getBundleName()); 
pacMap.putObjectValue(ShareAtomicServiceManager.SHARING_EXTRA_INFO, "原子化服务分享额外内容"); 
pacMap.putObjectValue(ShareAtomicServiceManager.HM_ABILITY_NAME, MainAbility.class.getName()); 
pacMap.putObjectValue(ShareAtomicServiceManager.SHARING_CONTENT_INFO, "原子化服务通过华为分享的内容"); 
byte[] sharedContentImg = getResourceBytes(ResourceTable.Media_share_conteng_img); 
pacMap.putObjectValue(ShareAtomicServiceManager.SHARING_THUMB_DATA, sharedContentImg); 
byte[] iconImg = getResourceBytes(ResourceTable.Media_icon); 
pacMap.putObjectValue(ShareAtomicServiceManager.HM_FA_ICON, iconImg); 
pacMap.putObjectValue(ShareAtomicServiceManager.HM_FA_NAME, getString(ResourceTable.String_app_name)); 
return pacMap; 

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.


其中,常量的定义如下:

public static final String HM_FA_ICON = "ohos_fa_icon"
public static final String HM_FA_NAME = "ohos_fa_name"
public static final String HM_ABILITY_NAME = "ohos_ability_name"
public static final String HM_BUNDLE_NAME = "ohos_bundle_name"
public static final String SHARING_FA_TYPE = "sharing_fa_type"
public static final String SHARING_THUMB_DATA = "sharing_fa_thumb_data"
public static final String SHARING_CONTENT_INFO = "sharing_fa_content_info"
public static final String SHARING_EXTRA_INFO = "sharing_fa_extra_info"
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.

常量含义说明如下:

 

对于图片资源的解析可以参考如下:

private byte[] getResourceBytes(int resId) { 
InputStream resource = null
ByteArrayOutputStream outStream = null
try { 
resource = getResourceManager().getResource(resId); 
outStream = new ByteArrayOutputStream(); 
byte[] buffer = new byte[1024]; 
int len; 
while ((len = resource.read(buffer)) != -1) { 
outStream.write(buffer, 0, len); 

outStream.close(); 
resource.close(); 
return outStream.toByteArray(); 
} catch (IOException e) { 
HiLog.error(TAG, "get resource occurs io exception!"); 
} catch (NotExistException e) { 
HiLog.error(TAG, "it dose not exist!"); 
} finally { 
if (resource != null) { 
try { 
resource.close(); 
} catch (IOException e) { 
HiLog.error(TAG, "close input stream occurs io exception!"); 


if (outStream != null) { 
try { 
resource.close(); 
} catch (IOException e) { 
HiLog.error(TAG, "close output stream occurs io exception!"); 



return null; 

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.


大家也可以参考官网上接入华为分享的开发指导:
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/huawei-share-service-sharing-guidelines-0000001141302387

运行工程

在虚拟机或者真机运行创建的工程之后,会显示原子化服务的主界面(即服务界面)。但是在桌面找不到原子化服务图标,因为原子化服务在桌面是没有icon的。可以在服务中心通过搜索原子化服务的名称找到该原子化服务,将其服务卡片添加到桌面。

原子化服务接入华为分享的运行结果,需要准备两台HarmonyOS手机,且其系统软件版本不低于HarmonyOS 2。

以上就是关于 HarmonyOS 原子化服务的介绍了,你学会了吗?期待更多开发者小伙伴加入原子化服务开发之旅哦~