HarmonyOS 备考题库应用模板解析:19 模块架构、路由聚合与错题本持久化

举报
yd_264921452 发表于 2026/11/18 06:10:56 2026/11/18
【摘要】 本文基于鸿蒙实践案例中心的备考题库应用模板,梳理 19 模块工程组织、RouterTable 聚合路由、AppStorageV2 与 PreferenceUtil 的状态分层,以及错题本持久化数据流,并给出为答题页增加题目来源说明的二开示例与 x86_64 模拟器支付依赖切换的兼容方案。

备考题库是鸿蒙实践案例中心「应用模版」分类下的进阶案例,面向教育备考场景。本文基于 HarmonyOS-APPTMPL-Exam 模板源码,梳理其多模块工程组织、路由聚合方案与错题本持久化实现,并给出一个低风险的二开示例。

一、工程总体结构:入口 HAP + 18 个 HAR

模板构建清单共注册 19 个模块:入口 HAP 1 个、HAR 18 个,没有使用 HSP。入口模块 product/entry 承担启动 Ability、开屏广告、隐私确认、登录、主 Tab、路由、快捷方式与服务卡片等通用职责;题库分类、课程、个人中心等业务分散在 features/homePage、features/topicPage、features/minePage 三个特性 HAR 中;答题、搜索、登录、会员、支付等复用能力放在 components 目录下的业务组件与能力组件 HAR 中。

这种「入口薄、能力厚」的组织方式有两个直接收益:一是业务模块可以独立编译、按需依赖;二是页面都经由统一路由表暴露,新增页面时只需要登记一处。

二、RouterTable 聚合路由:新增页面的标准动作

工程在 product/entry/src/main/ets/model/RouterTable.ets 汇总各 HAR 的页面 Builder,Index.ets 使用 Navigation 的 pageMap 渲染目标页。开屏广告关闭后先判断首次启动,再决定跳转隐私页或主 Tab,这条链路对理解模板的启动流程很有帮助。

实践建议:新增页面时先在对应 HAR 内实现组件,再到 RouterTable 注册 Builder,避免在页面内部散落 push 路由字符串。

三、状态与数据:AppStorageV2 共享 + PreferenceUtil 持久化

模板的状态设计分两层:AppStorageV2 承担模块间共享状态(如登录态、会员状态),进程内生效;练习记录、错题、收藏和笔记则通过 PreferenceUtil 写入本地偏好,跨启动保留。需要注意:进程内共享状态不等于重启后保存,答题页重新进入时会重新初始化题目与当前索引,模板并不承诺断点续答。

错题本的数据流可以概括为:答题页判定错误 → 错题保存回调 → PreferenceUtil 写入 → 错题练习入口读取;当没有错题记录时,错题练习显示「无错题数据」空态,不需要导入真实题库即可验证完整链路。

四、四种练习模式的交互差异

首页 PracticeMode 模型声明了每日一练、模拟考试、全真试卷和错题练习四种入口。每日一练覆盖选项、切题、答题卡、成绩与解析的完整交互;模拟考试侧重限时与整体提交;全真试卷入口额外检查会员状态,未配置会员服务时可能无法进入;错题练习依赖错题记录。体验时建议先用每日一练走通链路,再按需验证其他模式。

五、登录与 mock 边界

QuickLogin 登录组件的 mock 分支只在部分登录失败或无有效 token 的回调中触发,显示「mock登录」并建立端侧登录态;并非所有错误都会进入 mock。这意味着体验真机华为账号登录需要自己配置 Client ID 与签名,而模拟器调试时优先依赖 mock 分支。理解这一边界能避免把「登录页不退出」误判为组件缺陷。

六、x86_64 模拟器的支付依赖切换

支付组件默认使用官方支付宝 SDK 15.8.39,其 ARM64 原生库不能直接用于 x86_64 模拟器。需要模拟器体验时,在 components/aggregated_payment/oh-package.json5 中注释官方依赖,启用仓内自带的兼容依赖 ./libs/swallow_alipay_sdk(支付接口为空实现,仅作界面体验),再重新同步依赖并构建;真机接入时切回官方 SDK。这是模板中很典型的一处「ABI 兼容开关」设计,值得在类似工程中复用。

七、二开示例:为答题页增加题目来源说明

案例推荐的二开任务是给答题页增加题目来源说明,入口为 components/answer_questions/src/main/ets/components/AnswerQuestionsPage.ets。约束是沿用现有题目模型与答案判定,不捏造考试机构,空题列表可返回;验收要点是打开说明不影响答题状态,关闭后题号、选项与计时保持。这个任务规模小、边界清晰,适合作为熟悉共享组件改造的练手项。

结语

整体来看,备考题库模板的价值在于把一个完整教育类应用的模块划分、路由聚合、状态分层与本地持久化都铺好了底座,开发者可以把精力集中在业务定制上。建议阅读顺序:先跑通云端体验流程,再对照本文梳理模块依赖,最后选择一个二开方向动手。

相关仓库:gitcode.com/harmony-practice-center/HarmonyOS-APPTMPL-Exam(Apache-2.0)

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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