鸿蒙元服务开发:卡片入口、服务卡与免安装的工程边界
【摘要】 从元服务与 App 的差异、卡片与服务卡的工程结构,到包体积控制和卡片刷新限制,整理鸿蒙元服务的开发要点。
一、元服务和 App 的差别
元服务(Atomic Service)主打"免安装、即点即用",入口通常是卡片、扫码或搜索。和普通 App 相比,它有几个硬约束:
- 包体积有上限,不能什么都往里塞。
- 卡片是主要入口,首屏体验由卡片决定。
- 部分系统能力受限,不能假设用户已经安装、已经登录。
把这些约束当成设计前提,比先按 App 做再裁剪要省事得多。
二、工程结构怎么拆
一个典型的元服务工程通常包含:
entry:主模块,承载页面与服务逻辑。card:卡片模块,独立编译、独立刷新。- 服务卡与页面之间的数据通过共享的数据层或轻量存储衔接。
卡片模块最好保持独立,不要把页面的复杂逻辑塞进卡片,否则卡片编译体积和刷新成本都会上去。
三、卡片开发的几个关键点
- 卡片是独立渲染的:卡片 UI 运行在卡片宿主里,不能直接操作页面状态,数据要通过持久化或消息传递。
- 刷新有频率限制:不要按秒刷新,按业务需要设置合理的刷新周期,必要时用被动刷新(用户操作后触发)。
- 卡片不能直接访问网络:需要先在主模块拉取数据并落盘,卡片读取缓存。
- 卡片尺寸要适配:同一张卡片可能以 2×2、2×4 等尺寸展示,布局要能自适应。
四、免安装带来的状态问题
用户第一次打开元服务时,可能没有账号、没有授权。比较稳的做法是:
- 首屏不依赖登录,先展示可用内容。
- 需要登录的操作再引导授权,授权后回到原流程。
- 本地状态要能区分"未登录"和"登录但无数据",避免把两种情况都当成空列表。
五、包体积控制
- 图片优先用矢量或按需下载,不要把所有素材打进包。
- 公共依赖抽成共享库,避免 entry 和 card 各打一份。
- 非首屏页面用动态加载,减少初始包大小。
- 定期看构建产物,找出体积增长快的模块。
六、常见坑
- 卡片里写了网络请求,预览正常、真机不刷新。
- 卡片刷新过于频繁,被系统限流后表现为"数据不动"。
- 元服务按 App 的方式申请权限,部分权限不可用。
- 页面和卡片各存一份状态,出现数据不一致。
小结
元服务的核心是"轻":入口轻、包体轻、状态轻。把卡片当独立模块对待、把网络和持久化放到主模块、把首屏做成不依赖登录也能用,工程会顺很多。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)