HarmonyOS元服务开发解决方案

元服务是鸿蒙系统的一种轻量化应用形态，由鸿蒙系统应用程序框架管理，是生态伙伴实现高效服务转化、低成本获客的有效方式，也是鸿蒙智能的优质载体。通过元服务可以实现与鸿蒙生态共同生长、利益共享。

鸿蒙系统为元服务开发提供了账号、定位、支付、地图、广告等平台能力，使得元服务能够为用户提供高效服务履约、数据跟随账号以及页面流畅的使用体验。元服务与应用互为补充、有序联动，共同为消费者提供差异化服务。

开发者基于经营目标、效率、成本、收益自主决定是开发元服务或APP。元服务和APP是鸿蒙系统生态的“一体两面”，是生态伙伴面向用户的两种服务形态。

元服务的目标是为用户提供即用即走、轻量高效的优质服务使用体验，生态伙伴在开发元服务时，应参照元服务核心理念指导，为用户提供符合价值理念的高品质服务。

秒开直达，纯净清爽

元服务是鸿蒙系统轻量服务形态，提倡无门槛，即开即用，秒开启动，丝滑流畅；隐匿登录直达使用，纯净体验无弹框。

服务相伴，恰合时宜

元服务右上角常驻胶囊入口，点击拉起服务面板，提供服务履约过程官方保障功能；订单成交重要状态，在锁屏、实况窗恰合时宜的提醒，提供更便捷、高效的服务闭环。

用完即走，账号相随

元服务以用户数字资产安全为核心，关联华为账号，为用户提供安全可靠的服务使用记录、订阅通知和订单状态提醒等伴随服务，确保用户的服务使用、交易过程安全、可信。用户可以用完即走，不强制挽留，轻量高效。

一体两面，嵌入式运行

元服务和应用是鸿蒙生态下的2种程序形态，元服务是免安装的更轻量的， 二者可独立部署，也可嵌入式运行，助力商户私域经营。

原生智能，全域流转

通过意图识别和AI智能实现服务精准触达和原生自然体验，语音点餐、选餐、下单、支付、取餐，订单状态全域流转。

高效开发，生而可信

提供元服务标准UX组件集、场景化模板及API集，同时构建元服务生态规则，开发者在规则之上高效开发，实现生而可信。

元服务基于HarmonyOS SDK（只能使用“元服务API集”）开发，支持运行在1+8+N设备上，供用户在合适的场景、合适的设备上便捷使用。元服务 API 集提供了元服务开发所需的开放能力，包括了 UI 组件、基础系统能力、经营履约能力以及场景化服务能力元服务与应用的2D能力对比参考下表：

元服务在开发态和运行态的基本视图如下图所示：

原生开发：与应用开发类似，利用ArkTS/ArkUI等语言构建，能复用较多系统原生能力，一定程度上能做到元服务和应用代码复用；

ASCF开发：采用小程序类web范式开发，用三方框架（uniapp/mpx/taro），或原生小程序平台（微信，支付宝，快应用）转化，开发者上手简单，代码维护成本低。

不同开发方式适应的伙伴类型存在差异，优选策略如下：

原生开发，一定程度上能复用系统能力，与应用不同的是，其接口需要通过“打标”方式形成独立的高阶API，部分接口针对元服务场景做了生态规则管控，也增加了元服务特有的menubar和服务面板等功能。

需特别关注元服务API集合限制：

• HarmonyOS SDK API：是鸿蒙系统的标准API，涵盖框架、组件、api等OS能力。
• 元服务API集：是 HarmonyOS SDK API的子集，使用ArkTS开发的元服务仅能使用元服务API集内的api，无法完全覆盖应用可用的HarmonyOS SDK API全集。

  实际开发过程中，参考元服务API集使用指导，筛选元服务可使用的高阶API：

  

  优秀实践：

  

ASCF开发，依托于当前已有的鸿蒙元服务底座，采用小程序开发技术（html,js,css）类web语言开发，底层基于ArkWeb渲染页面，通过双线程模型、同层渲染等技术优化性能。

利用ASCF框架，快速复用存量小程序资产，当前支持微信/支付宝原生，uniapp，taro，mpx等三方框架开发的小程序转换元服务，且支持SaaS服务商开发元服务，极大地提升了存量小程序迁移到鸿蒙元服务上的效率。

ASCF框架提供了系统级的运行时能力，开发阶段编译调试的工具链。同时提供了转换工具将已有的小程序项目快速转换为ASCF框架的元服务，整体运行时架构图参考如下:

面向小程序开发者：

从小程序转换到ASCF元服务后，需要对转换后的工程文件进行处理：

• 在AppGallery Connect（简称AGC）上申请注册元服务，配置域名、权限申请。
• 转换原来小程序平台的特有接口，如登录、支付等接口，将其替换成元服务生态规则接口。若元服务暂无替代的接口，需要在代码上删除相关功能。
• 涉及云服务，需要接入元服务开放能力，请参考4.2.4章节 开放能力开发。
• 后续小程序平台工程与元服务ASCF框架工程需要各自独立维护演进，彼此互不影响。

面向SaaS服务商开发者：

三方平台代码导出ASCF框架源码，由三方平台自行处理。

开发者仍需要完成以下步骤适配平台的相关功能和要求：

• 在AppGallery Connect（简称AGC）上申请注册元服务，配置域名、申请权限等。
• 通过条件编译隔离元服务和其他平台代码，涉及云服务，需要接入元服务开放能力，请参考4.2.4章节 开放能力开发。

后续开发者仅需维护三方平台端侧代码，ASCF工程通过工具输出，仅对工程文件进行基础信息配置，打包验证。

优秀实践：

元服务基于鸿蒙系统开放能力，关联华为账号，为开发者提供全生命周期的服务履约能力，从手机号注册登录、位置定位、收货地址、交易能力、地图导航、广告变现、订阅消息等平台能力，为开发者提供经营赋能能力，如下表所示：

1.6.1 页面级分享

元服务页面级的分享：能支持包括畅连、华为分享等的多种通道通过HarmonyOS系统分享面板，自由分享，进一步增强私域分发的能力。

1.6.1 设备间互碰分享

设备间互碰分享：直达用户意图分享的页面，促进基于熟人短距间的服务分发。

1.6.3 扫碰直达

扫码直达：可在开发者主动授权的情况下，在用户主动扫任何线下码时，可一步打开元服务目标页面。一碰即达：碰NFC感应打开元服务，场景无处不在，场景即入口，一碰即领优惠券/会员积分，线下引流直达下单页/领券落地页/会员开通页。

1.6.4 嵌入式能力增强

嵌入式能力增强：独特优势，随处可嵌，让服务在鸿蒙生态体验更友好，更连贯流畅。

手机屏上全模态/半模态拉起元服务，以半模态拉起为例，拉起方式更灵活；

手机屏上、车屏上：结合精准位置场景及丰富车主画像，利于附近及车主类元服务更高效精准转化，嵌入运行元服务帮助伙伴打造优质的私域经营工具，沉浸式运行。

1.6.5 多设备场景免适配

元服务简化开发者适配成本，保障多设备适配体验，多端默认呈现窗口化体验，开发者可主动适配，也可采用默认方案适配，实现一次开发，多端设备部署。

1.6.6 高效元服务备案

元服务推出高效备案平台，实现档案页自动呈现备案号，对标小程序流程，提高开发者元服务备案效率，做到了把复杂交给平台，简单留给开发者，进一步提升开发者一站式旅程体验。

备案完成后，无需开发者自适配，即可在元服务档案页呈现备案号，2B和2C全局闭环。

1.6.7 服务动态跨端流转

服务通知、服务动态：支持宿主侧发通知，跨端流转，低门槛对外开放。

• 服务动态权益开通和场景申请线上化，一个模版通用，更方便于开发者调测。
• 服务动态与实况窗有效结合，服务动态成为跨端流转的关键抓手。

  

1.6.8 ASCF调测能力升级

ASCF开发调测效率优化，提升编译构建效率，降低开发门槛。

• 支持手机、折叠屏、平板等多种模拟器；
• 支持x86和Arm主机多种设备类型模拟器；
• 支持热更新，实时修改运行（首次运行预计20+秒，非首次秒级热更新）。

  

1.6.9 服务通知能力增强

服务通知优化：一次订阅长期有效，私域互通性更强，助力伙伴长效经营。