当前位置：首页 > news >正文

鸿蒙HarmonyOS元服务应用开发实战完全指导

news 2025/7/23 5:34:45

内容提要

元服务概述

元服务开发流程

第一个元服务开发

元服务部署与运行

一、服务概述

1、什么是元服务

在万物互联时代，人均持有设备量不断攀升，设备种类和使用场景更加多样，使得应用开发、应用入口变得更加复杂。在此背景下，应用提供方和用户迫切需要一种新的服务提供方式，使应用开发更简单、服务（如听音乐、打车等）的获取和使用更便捷。

为此，鸿蒙HarmonyOS除支持传统的需要安装的应用（以下简称传统应用）外，还支持更加方便快捷的免安装的应用，即元服务。

元服务是HarmonyOS提供的一种轻量应用程序形态，具备服务直达、跨设备等特征。

元服务可独立上架、分发、运行，独立实现业务闭环，可大幅提升信息与服务的获取效率。

元服务基于HarmonyOS SDK（只能使用“元服务API集”）开发，支持运行在1+8+N设备上，供用户在合适的场景、合适的设备上便捷使用。

元服务与传统应用的对比请见下表：

元服务与传统应用、服务卡片之间的关系：

2、元服务特征及使用场景

元服务区别于传统应用，具备如下特征。

（1）服务直达

元服务支持免安装使用。

服务卡片：支持用户无需打开元服务便可获取服务内重要信息的展示和动态变化，如天气、关键事务备忘、热点新闻列表等。

（2）跨设备

元服务支持运行在1+8+N设备上，如手机、平板、2in1、智慧屏等设备。

支持跨设备分享：用户可分享元服务给好友，好友确认后打开分享的服务。

说明：元服务及卡片只能在本应用实现跳转，不能在不同应用与不同元服务间流转。

二、元服务开发流程

元服务开发主要包括以下环节。

（1）开发前
创建元服务项目前，需要注册华为开发者帐号并创建您的元服务；然后搭建开发环境，通过DevEco Studio创建元服务工程。

说明：元服务包名命名格式需要使用com.atomicservice.[appid]，请先在华为网站创建元服务，获取AppID后再创建工程。

在AppGallery Connect上，可以通过“我的元服务”选择对应元服务，在“应用信息”可查询元服务的appid。

开发环境参考本站：华为鸿蒙HarmonyOS开发环境安装与配置完全解析_怎么安装配置鸿蒙环境,以次编译出jar包-CSDN博客

（2）开发中
元服务包含页面和卡片两个部分，请参考UI开发和服务卡片开发。

DevEco Studio提供真机调试能力，开发者可快速通过真机运行调试查看运行效果。

（3）打包
可通过DevEco Studio快速打包生成发布版本，使用此版本，可以用于开放式测试或提交上架审核。

（4）测试
在正式发布元服务前，您可以发布一个开放式测试版本，邀请部分用户提前体验新版本，并收集用户的反馈，以便提前发现问题进行改进，从而保证全网版本的质量，提升用户体验。

（5）上架
当元服务经过全面测试，确保版本没有问题，即可发布正式版本。

三、第一个元服务开发

1、若首次打开DevEco Studio，请选择Create Project开始创建一个新工程。

如果已经打开了一个工程，请在菜单栏选择File > New > Create Project来创建一个新工程。选择Atomic Service元服务开发，选择模板，单击Next进行下一步配置。

当前元服务支持的模板类型：

Empty Ability：用于Phone、Tablet设备的模板，展示基础的Hello World功能。
Embeddable Ability：用于开发支持被其他应用嵌入式运行的元服务的工程模板

说明：

元服务不支持native开发方式，无法选择native工程模板开发元服务。

2、点击Sign In登录华为开发者账号进行开发，或选择访客模式体验。访客模式无需登录华为账号。

说明：

访客模式仅用于体验元服务开发功能。如需将访客模式下开发的元服务工程或历史元服务工程在真机上运行并安装，需在AppScope > app.json5文件中补充当前开发者账号下已在AppGallery注册且真实存在的包名。

3、在弹出的网页界面中点击允许，完成访问账号授权。

4、选择已登录账号下的APP ID。如您未在AppGallery中注册元服务应用，点击Register APP ID注册新的APP ID。

说明：

仅元服务应用的APP ID将在当前界面展示。如需新建应用，“是否元服务”选项请勾选“是”，才能创建出元服务应用。

5、完成注册后，回到DevEco Studio界面，点击Refresh，刷新当前APP ID列表，选择新生成的APP ID，点击Next。

6、进入配置工程界面，填写Project name，其他参数保持默认设置即可。

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

元服务工程目录结构如下。

AppScope > app.json5：元服务的全局配置信息。
entry：HarmonyOS工程模块，编译构建生成一个HAP。

src > main > ets：用于存放ArkTS源码。
src > main > ets > entryability：元服务的入口。
src > main > ets > pages：元服务包含的页面。
src > main > resources：用于存放元服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。详见官网资源分类与访问。
src > main > module.json5：模块配置文件。主要包含HAP的配置信息、元服务在具体设备上的配置信息以及元服务的全局配置信息。具体的配置文件说明，详见module.json5。