鸿蒙元服务开发:卡片入口、服务卡与免安装的工程边界

举报
yd_261887888 发表于 2026/11/19 00:08:54 2026/11/19
【摘要】 从元服务与 App 的差异、卡片与服务卡的工程结构,到包体积控制和卡片刷新限制,整理鸿蒙元服务的开发要点。

一、元服务和 App 的差别

元服务(Atomic Service)主打"免安装、即点即用",入口通常是卡片、扫码或搜索。和普通 App 相比,它有几个硬约束:

  • 包体积有上限,不能什么都往里塞。
  • 卡片是主要入口,首屏体验由卡片决定。
  • 部分系统能力受限,不能假设用户已经安装、已经登录。

把这些约束当成设计前提,比先按 App 做再裁剪要省事得多。

二、工程结构怎么拆

一个典型的元服务工程通常包含:

  • entry:主模块,承载页面与服务逻辑。
  • card:卡片模块,独立编译、独立刷新。
  • 服务卡与页面之间的数据通过共享的数据层或轻量存储衔接。

卡片模块最好保持独立,不要把页面的复杂逻辑塞进卡片,否则卡片编译体积和刷新成本都会上去。

三、卡片开发的几个关键点

  1. 卡片是独立渲染的:卡片 UI 运行在卡片宿主里,不能直接操作页面状态,数据要通过持久化或消息传递。
  2. 刷新有频率限制:不要按秒刷新,按业务需要设置合理的刷新周期,必要时用被动刷新(用户操作后触发)。
  3. 卡片不能直接访问网络:需要先在主模块拉取数据并落盘,卡片读取缓存。
  4. 卡片尺寸要适配:同一张卡片可能以 2×2、2×4 等尺寸展示,布局要能自适应。

四、免安装带来的状态问题

用户第一次打开元服务时,可能没有账号、没有授权。比较稳的做法是:

  • 首屏不依赖登录,先展示可用内容。
  • 需要登录的操作再引导授权,授权后回到原流程。
  • 本地状态要能区分"未登录"和"登录但无数据",避免把两种情况都当成空列表。

五、包体积控制

  • 图片优先用矢量或按需下载,不要把所有素材打进包。
  • 公共依赖抽成共享库,避免 entry 和 card 各打一份。
  • 非首屏页面用动态加载,减少初始包大小。
  • 定期看构建产物,找出体积增长快的模块。

六、常见坑

  • 卡片里写了网络请求,预览正常、真机不刷新。
  • 卡片刷新过于频繁,被系统限流后表现为"数据不动"。
  • 元服务按 App 的方式申请权限,部分权限不可用。
  • 页面和卡片各存一份状态,出现数据不一致。

小结

元服务的核心是"轻":入口轻、包体轻、状态轻。把卡片当独立模块对待、把网络和持久化放到主模块、把首屏做成不依赖登录也能用,工程会顺很多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。