鸿蒙生态元服务开发白皮书V1.0

版权所有©华为终端有限公司2024。保留一切权利。 本材料所载内容受著作权法的保护，著作权由华为公司或其许可人拥有，但注明引用其他方的内容除外。未经华为公司或其许可人事先书面许可，任何人不得将本材料中的任何内容以任何方式进行复制、经销、翻印、播放、以超级链路连接或传送、存储于信息检索系统或者其他任何商业目的的使用。 商标声明 以上为华为公司的商标（非详尽清单），未经华为公司书面事先明示许可，任何第三方不得以任何形式使用。 注意 华为会不定期对本文档的内容进行更新。 本文档仅作为使用指导，文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。 华为终端有限公司 地址：广东省东莞市松山湖园区新城路2号网址：https://consumer.huawei.com CONTENT O1 元服务定位及核心理念 1）元服务定位····························3 2）元服务核心理念······················4 3）元服务应用形态······················6 4）元服务生态经营······················8 O2 元服务一站式开发平台 1）研发支持平台························13 赋能套件·····························13 开发测试套件························14 开发者支持平台······················17 2）元服务API集························17 元服务API集分类简介················17 3）元服务分发能力······················20 4）三方生态能力·······················20 5）运营运维平台·······················20 O3 元服务开发测试及上架 1）开发准备·····························23 a）创建元服务·····················24 b）申请证书和profile···············24 2）开发调试·····························25 a）工程管理······················26 b）代码编辑······················26 c）界面预览······················27 d）编译构建·······················28 e）代码调试·······················28 3）测试·······························28 4）上架·······························30 a）元服务上架··············30 b）上架审核················31 O4元服务的运营与运维 1）元服务运营全景···············35 a）公域流量设计················37 b）用户触达方式················38 c）营销工具························38 2）元服务运维····························39 O5 典型场景示例 典型场景一：茶饮行业示例············42 典型场景二：生活缴费行业示例··········46 典型场景三：停车行业示例·············48 附录：技术术语51 2 Chapter1 元服务定位及 核心理念 -1）元服务定位 -2）元服务核心理念 -3）元服务应用形态 -4）元服务生态经营 01元服务定位及核心理念 1)元服务定位 元服务是鸿蒙系统的一种轻量化应用形态，由鸿蒙系统应用程序框架管理，具有免安装、即点即用、用完即走、轻量高效等特点。元服务是生态伙伴实现高效服务转化、低成本获客的有效方式，也是原生智能的优质载体。通过元服务可以实现与鸿蒙生态共同生长、利益共享。 鸿蒙系统为元服务开发提供了账号、定位、支付、地图、广告等平台能力，使得元服务能够为用户提供高效服务履约、数据跟随账号以及原生页面流畅的使用体验。元服务与应用互为补充、有序联动，共同为消费者提供差异化服务。 开发者基于经营目标、效率、成本、收益自主决定是开发元服务或者APP。元服务和 APP是鸿蒙系统生态的“一体两面”，是生态伙伴面向用户的两种服务形态。 图1-1：鸿蒙生态的一体两面 2)元服务核心理念 元服务的目标是为用户提供用完即走、轻量高效的优质服务使用体验，生态伙伴在开发元服务时，应参照元服务核心理念指导，为用户提供符合核心理念，具有持续价值的高品质服务。 秒开直达，纯净清爽 元服务是鸿蒙系统轻量服务形态，提倡无门槛，即开即用，秒开启动，丝滑流畅；隐匿登录直达使用，纯净体验无弹框。 服务相伴，恰合时宜 元服务右上角常驻胶囊入口，点击拉起服务面板，提供服务履约过程官方保障功能；订单成交重要状态，在锁屏、实况窗恰合时宜的提醒，提供更便捷、高效的服务闭环。 用完即走，账号相随 元服务以用户数字资产安全为核心，关联华为账号，为用户提供安全可靠的服务使用记录、订阅通知和订单状态提醒等伴随服务，确保用户的服务使用、交易过程安全、可信。用户可以用完即走，不强制挽留，轻量高效。 原生智能，搜完即用 元服务是基于鸿蒙系统底座实现的原生智能优质载体，通过小艺建议、负一屏、全局搜索、应用市场、信息流等实现精准服务触达和原生自然体验；搜索任何的服务或服务子项都能搜完即用。 3）元服务应用形态 元服务基于HarmonyOSSDK（只能使用“元服务API集”）开发，支持运行在1+8+N 区别 应用 元服务 特征 手动下载安装 免安装 设备上，供用户在合适的场景、合适的设备上便捷使用。元服务与传统应用的对比请见下表。 包大小无限制应用内或应用市场更新功能全，开发成本高，周期长 包大小有限制自动更新轻量化完整功能，开发成本低 载体 跟随设备 跟随华为账号 API范围 全量API 只能使用“元服务API集” 经营 自主运营人找应用成本高 支付、地图、广告等经营履约能力辅助经营系统分发入口帮助人找服务、服务找人 表1-1：元服务与传统应用对比 从应用程序入口看，元服务与应用一样，服务卡片可选，图标必选。卡片作为服务的轻量承载，需要做到易用可见、智能可选和多端可变。 图1-2：易用易见，多端可变元服务卡片 元服务在开发态和运行态的基本视图如下图所示。 图1-3：元服务运行时视图 应用/元服务可复用设计原则: UI最大化复用原则：元服务对ArkUI的可访问API集合与应用比较接近，因此优先考虑 UI代码与业务解耦，以实现最大化复用。 优先使用元服务API集原则：在满足业务诉求前提下，尽量仅使用元服务API集限定的 API。将应用代码移植成元服务代码时，可减少移植工作量。 4）元服务生态经营 元服务基于鸿蒙系统开放能力，关联华为账号，为开发者提供全生命周期的服务履约能力，从手机号注册登录、位置定位、收货地址、交易能力、地图导航、广告变现、订阅消息等平台能力，为开发者提供经营赋能能力。 图1-4：元服务生态经营全流程元服务生态经营能力如下表： 能力 说明 手机号码授权 经过用户授权，开发者可获取用户在HuaweiID上绑定的手机号码，快速完成用户在元服务的注册和登录。 位置定位 经过用户授权，开发者可获取用户当前所处的地理位置，快速完成商品服务和用户的资源匹配。 收货地址授权 经过用户授权，开发者可获取用户在HuaweiID上绑定的收货地址，快速完成用户收货地址的填写，降低用户下单购买决策门槛。 支付能力 基于开发者灵活的商业业态，为开发者提供完整的支付解决方案，包括支付、签约以及合单支付能力，快速完成支付的商业闭环。 地图能力 为开发者提供标准、合规、全球化的地图能力，支持开发者在地图中标记商店位置、查找精确地点、获取门店列表、展示到店路线、导航引导等功能。 广告变现 开发者通过接入广告变现服务，归属的元服务内可实现向用户展示精准，高品质的广告内容，使开发者获得广告收益。 发票能力 为开发者提供发票相关能力，统一发票抬头体验，统一发票管理。开发者可管理用户发票。 客服能力 为开发者提供客服能力，帮助开发者做好用户服务。开发者可与用户通过客服平台沟通解决问题。 订阅消息 为开发者提供订阅消息能力，帮助开发者做好用户服务履约信息的触达，以及基本的用户运营。 表1-2：元服务生态经营能力 Chapter2 元1服务一站式开发平台 -1）研发支持平台 -2）元服务API集 -3）元服务分发能力 -4）三方生态能力 -5）运营运维平台 11 - 02元服务一站式开发平台 鸿蒙系统为开发者提供了端到端的研发平台、开放能力、运维与运营平台及三方生态能力支持，帮助开发者快速高效搭建自己的元服务。如下图所示，鸿蒙系统为开发者提供了研发支持平台、元服务开放能力、元服务分发能力、三方生态能力及运维运营平台。 图2-1：元服务开放能力全景 研发支持平台 鸿蒙系统为开发者提供丰富的赋能套件、开发测试套件等资源，帮助开发者获取鸿蒙生态应用开发所需支持及相应的工具。 开发者支持平台包括华为开发者社区、华为开发者学堂、开发者计划及开发者问题反馈平台。通过该平台开发者可以及时获取鸿蒙系统最新资讯、详细的鸿蒙系统API及开发指南，还可以反馈鸿蒙生态应用开发过程遇到的问题并与广大的鸿蒙开发者交流共享知识。 开放能力 开放能力是鸿蒙系统呈现给元服务及应用开发者的能力集合。元服务开放能力是鸿蒙系统开放能力的子集，元服务开发仅能使用元服务API集。OS以SDK和工具链的形式提供元服务API集，开发者可以通过开发者套件获取。 元服务分发 鸿蒙系统同时提供了系统级的场景化分发入口，以及智能化的分发引擎。 三方生态能力 当前元服务已构建三方库中心仓OHPM，元服务开发者也可以构建自己的独立私有三方库中心仓。 插件及模板能力是支撑元服务能够在开发者之间复用商业业务能力以及高效快速开发元服务的基础能力，后续系统还将规划支持插件及模板能力。 运维运营平台 运维及运营平台提供了元服务的高效运维和精准运营能力。 1)研发支持平台 赋能套件 赋能套件是为开发者打造的，供开发者了解和使用鸿蒙系统的各类学习与开发资源，助力开发者高效地开发用户体验更佳的应用及元服务。 赋能套件覆盖开发者全旅程，内容包含白皮书、CodeLabs、视频课程、技术文章、UX设计资源与指南、API参考、指南与FAQ。 赋能套件获取地址： 名称 获取途径 课程 https://developer.harmonyos.com/cn/documentation/teaching-video/ 名称 获取途径 Codelabs https://developer.huawei.com/consumer/cn/codelabsPortal/serviceTypes/21 技术文章 HarmonyOS微信公众号 开发、测试及上架指南 https://developer.huawei.com/consumer/cn/doc/atomic-guides-V5/atomic-service-V5 UX设计资源与指南 https://developer.harmonyos.com/cn/design/ API参考 https://developer.huawei.com/consumer/cn/doc/atomic-references-V5/atomic-apis-intro-V5 FAQ https://developer.huawei.com/consumer/cn/doc/atomi