鸿蒙学习课程应用模板架构解析:课程目录、播放器与收藏状态的模块化组织
学习课程应用模板是鸿蒙实践中心面向进阶开发者的教育场景案例,覆盖课程目录浏览、录播课程播放与个人中心三大主线。它基于已有的 ArkTS/ArkUI 多模块工程,让开发者在真实业务结构上理解「入口 + 特性 + 公共能力 + 组件」的分层组织,再进行课程业务的定制开发。本文从工程结构、数据流与状态边界三个角度拆解这个模板,并给出「新增一节演示课程目录」的最小改动方案。
一、工程结构:15 个模块的分层组织
工程入口为 product/entry,构建清单声明 15 个模块(HAR 14 个),按职责分为四层:
| 层级 | 模块 | 作用 |
|---|---|---|
| 入口 | entry | 启动 Ability、隐私弹层、开屏广告、主 Tab、登录页和全局路由 |
| 特性 | home、course、mine | 承载首页/学习、课程视图与个人中心业务页面 |
| 公共 | commonlib、http | 提供路由、组件、模型、偏好存储、Axios 请求与本地 mock |
| 能力组件 | recorded_player、live_streaming、search、classification、open_ads | 视频/直播、搜索、分类、广告与开播能力 |
| 账号与交易 | login_info、aggregated_payment、aggregated_share、feed_back | 登录、收银台、分享与反馈 |
entry 通过入口 oh-package.json5 的 file 依赖引用本地模块,各 HAR 的页面 Builder 统一注册到 RouterTable.ets,Index.ets 中的 Navigation.pageMap 根据路由名渲染目标页。新增页面时先实现页面 Builder,再注册路由,这是模板定制时最常用的扩展路径。
二、数据流:本地 mock 驱动的课程数据
这个案例没有 AGC 云函数和云数据库,课程、直播、学习记录等主要数据全部来自端侧本地 mock,这也是它「开箱即跑」的关键:
- commons/http/src/main/ets/apis/Apis.ets 暴露课程、首页、目录、观看记录等查询函数;
- RequestMock.ets 使用 AxiosMock 拦截 /course/data、/home/hotCourseData 等本地请求,返回 COURSE_DATA / COURSE_CATALOG 演示数据;
- 页面拿到数据后只做视图渲染与路由跳转,不做二次加工。
这种设计的价值在于把「数据接口」与「数据来源」解耦:替换真实后端时,保留 Apis.ets 的函数签名,把 mock 拦截改为真实服务响应即可,页面层完全不用动。对于想快速体验的学生开发者,也不需要先部署任何云侧资源。
三、状态组织:收藏、观看记录与登录态
用户登录态、课程收藏、下载记录和观看记录通过 commonlib 的模型与 PreferenceUtil / AppStorageV2 在页面间共享。收藏状态在课程详情与个人中心之间保持一致,观看记录按课程维度组织,登录态则决定「学习」页是否展示内容——未登录时学习列表为空属正常边界,不算缺陷。
四、边界说明:哪些能力是演示、哪些需要配置
模板的边界需要提前清楚,避免把演示链路误当生产链路:
- 华为账号登录依赖应用签名与 client_id,源码中为占位值,未配置时登录链路不可用;
- 支付宝 SDK 默认依赖包含仅适配 ARM64 的原生库,x86_64 模拟器需按支付组件说明切换到仓内「支付接口空实现」的兼容依赖,再重新同步、构建;
- 支付、微信/QQ/微博分享、广告服务需要按对应平台申请账号、AppID 或广告位;
- installationFree 为 false,应用会安装为普通桌面应用,可正常从桌面图标拉起。
五、二次开发:新增一节演示课程目录
模板给出的官方拓展任务是「新增一节演示课程目录」,入口文件为 commons/http/src/main/ets/mocks/Data/CourseData.ets,约束与步骤如下:
- 核对 COURSE_CATALOG 的章节 id 在同一目录内唯一;多个课程可能共用目录,ChapterDetail 按 catalogIndex 和章节 videoUrl 构造播放列表;
- 标题、视频和目录须对应,视频使用有授权的资源,媒体失败状态要明确;
- 新增章节后重新构建,在选定的设备上验证新目录可选中、播放器对应新条目,同时回归收藏、订单演示和返回逻辑不串状态。
这个任务量小但覆盖完整链路:改一处 mock 数据,动一条播放列表映射,回归三个状态边界,非常适合作为理解模板数据流的第一课。
六、小结
学习课程应用模板用本地 mock 数据 + 多模块分层把「课程目录—播放器—收藏状态」串成完整闭环,工程结构清晰、边界说明完备。对开发者来说,理解 RouterTable 路由注册、AxiosMock 数据拦截、AppStorageV2 状态共享这三个机制,就能顺利基于模板完成课程业务的定制。
工程地址:https://gitcode.com/harmony-practice-center/HarmonyOS-APPTMPL-Course
- 点赞
- 收藏
- 关注作者
评论(0)