鸿蒙汽车美容应用模板架构解析:多模块分工下的服务目录、预约流程与门店数据组织

举报
yd_264921452 发表于 2026/11/15 06:21:58 2026/11/15
【摘要】 解析 HarmonyOS 汽车美容保养应用模板的工程架构:products/entry 入口承载首页、服务与我的三大板块,scenes 层划分产品、门店、预约三个业务模块,commons 层沉淀账号、定位与网络封装。文章梳理服务数据模型、预约表单组件与本地演示响应机制,并给出在 ProductData.ets 中新增美容服务的二次开发要点。

一、模板定位与工程全景

汽车美容保养应用模板是鸿蒙实践中心提供的完整应用工程,bundleType 为应用类型,构建清单共包含 14 个模块(HAR 13 个、HSP 0 个),SDK 兼容 API 12(5.0.0),目标版本 API 24(6.1.1)。整体采用「产品入口 + 业务场景 + 公共能力」的三层组织方式:products/entry 作为唯一入口承载应用启动与主页面,scenes 目录按业务域拆分为 product、shop、makeAppointment 等模块,commons 目录沉淀 commonLib 与 network 两个公共层。

这种分层的价值在于:业务模块彼此独立编译为 HAR,页面只依赖自己需要的模块;公共能力(账号、定位、网络请求)集中维护,避免重复实现。对二次开发者而言,新增一个业务板块只需要新建一个 HAR 模块并在入口注册路由,不需要改动既有模块。

二、入口与三大板块

products/entry/src/main/ets/pages 是应用页面入口。主界面按底部页签划分为三大板块:

  • 首页:以宫格形式呈现保养、美容、电瓶、除积碳、洗车、轮胎、变速箱油七大功能入口,配合顶部滚动广告、附近好店推荐与推荐套餐楼层,构成服务导购的第一屏;
  • 汽车服务:按分类列出全部服务项目,支持进入详情查看服务内容与适用门店;
  • 我的:聚合订单、预约记录、优惠券、车辆信息与联系人管理,是用户资产的统一出口。

三、数据层设计:ProductData.ets

scenes/product/src/main/ets/model/ProductData.ets 是整个服务目录的数据中枢,定义了服务条目(产品 id、名称、价格、所属门店 shopId)与分类模型。值得注意的是 shopId 采用「多条服务共用一个门店」的引用关系——门店数据独立维护,服务通过 id 关联,这为按门店聚合展示(如首页的附近好店楼层)提供了基础。

同时需要留意:当前列表页并未按 shopId 自动筛选服务,服务与门店的关联主要体现在详情与预约环节。二次开发时若需要「按门店浏览服务」的能力,需要自行补充过滤逻辑。

四、预约流程组件化:AppointmentView.ets

scenes/makeAppointment/src/main/ets/components/AppointmentView.ets 将预约表单封装为独立组件,供服务详情页复用。表单涵盖预约时间、车辆信息、联系方式等字段,提交后生成预约记录并写入「我的」板块的预约列表。组件化设计让预约能力可以在不同服务详情间共享,也便于后续接入真实下单接口。

五、门店与公共层

scenes/shop/src/main/ets 承载门店相关页面与数据。公共层方面,commons/commonLib 封装了账号登录、定位获取与通用工具;commons/network 则提供统一的请求封装与本地演示响应——模板在无后端的环境下通过本地响应模拟接口返回,保证页面流程完整可跑通。接入真实服务时,只需替换 network 层的实现,页面层无需改动。

六、系统能力集成

模板声明了 INTERNET、APPROXIMATELY_LOCATION、LOCATION 三项权限,并集成了华为账号登录与地图服务:工程中配置了 AGC Client ID 与公钥指纹,地图能力用于门店位置展示与「附近好店」的距离计算。集成要点是先在 AGC 控制台创建应用并录入指纹,再回填工程配置,否则登录与地图会因证书校验失败而不可用。

七、二次开发要点

模板自带的二开任务是在 ProductData.ets 中新增一种演示汽车美容服务。实操要点有三:

  • 产品 id 必须唯一,避免与既有服务冲突;
  • shopId 引用已有门店,一个门店可被多项服务共用;
  • 价格字段需为非负数值。

完成数据新增后,服务会自动出现在对应分类的列表中;若希望它在首页楼层曝光,还需要检查楼层的数据源是否按固定 id 列表筛选。

结语

整体来看,这个模板把「服务目录—门店—预约」的主链路拆分得比较清晰,公共层边界明确,是学习鸿蒙多模块应用组织方式的一个不错样本。对于想快速搭建本地生活服务类应用的开发者,可以直接复用其数据模型与预约组件,再逐步替换 network 层接入真实后端。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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