鸿蒙学习课程应用模板架构解析:课程目录、播放器与收藏状态的模块化组织

举报
yd_264921452 发表于 2026/11/14 06:30:00 2026/11/14
【摘要】 学习课程应用模板是鸿蒙实践中心面向进阶开发者的教育场景案例,覆盖课程目录浏览、录播课程播放与个人中心三大主线。本文基于 entry 之外的 14 个 HAR 模块,从工程结构、mock 数据流与状态边界三个角度拆解模板架构,并给出「新增一节演示课程目录」的最小改动方案。

学习课程应用模板是鸿蒙实践中心面向进阶开发者的教育场景案例,覆盖课程目录浏览、录播课程播放与个人中心三大主线。它基于已有的 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,约束与步骤如下:

  1. 核对 COURSE_CATALOG 的章节 id 在同一目录内唯一;多个课程可能共用目录,ChapterDetail 按 catalogIndex 和章节 videoUrl 构造播放列表;
  2. 标题、视频和目录须对应,视频使用有授权的资源,媒体失败状态要明确;
  3. 新增章节后重新构建,在选定的设备上验证新目录可选中、播放器对应新条目,同时回归收藏、订单演示和返回逻辑不串状态。

这个任务量小但覆盖完整链路:改一处 mock 数据,动一条播放列表映射,回归三个状态边界,非常适合作为理解模板数据流的第一课。

六、小结

学习课程应用模板用本地 mock 数据 + 多模块分层把「课程目录—播放器—收藏状态」串成完整闭环,工程结构清晰、边界说明完备。对开发者来说,理解 RouterTable 路由注册、AxiosMock 数据拦截、AppStorageV2 状态共享这三个机制,就能顺利基于模板完成课程业务的定制。

工程地址:https://gitcode.com/harmony-practice-center/HarmonyOS-APPTMPL-Course

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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