鸿蒙绘画应用模板架构解析:多模块分工下的画板状态管理与画本数据组织
一、案例定位:一个"开箱即练"的本地绘画工程
绘画应用模板是鸿蒙开发实践中心「应用模版」筛选下的进阶案例之一,面向已具备 ArkTS/ArkUI 基础、希望基于现有工程做业务定制的开发者,预计学习时间约 60 分钟。与从零搭建的教程类案例不同,它提供的是一个完整的 HarmonyOS 工程骨架:案例公仓托管在 GitCode(harmony-practice-center/HarmonyOS-APPTMPL-Painting),兼容 API 21、目标 API 24,构建清单共声明 10 个模块,开箱即可在云端工作区完成编译、打包与云手机验证。
案例给出的具体定制任务是「增加一组绘画快捷配色」:在 features/home 的选色组件 ColorContent.ets 中,沿现有字符串色值与 chooseColor 事件链路新增一组颜色入口,要求空配色提供明确默认值、不改变已有作品的数据格式。这个任务看似很小,却完整覆盖了"读工程—定方案—做改动—做回归"的二开全流程,是理解模板工程组织方式的理想切入点。
二、工程结构:products/entry 入口 + 四大依赖模块
工程入口位于 products/entry,其构建清单声明了 10 个模块。从依赖组织上看,entry 直接依赖 common、person、oh_router、home 四个模块,形成典型的「壳工程 + 能力模块」分层:
- products/entry:应用壳层,负责 Ability 入口与页面路由装配,连接画板与个人中心两大业务域;
- home:绘画核心域,承载画板工具、配色组件(ColorContent.ets / ColorGrid)与绘画首页;
- person:个人中心域,承载"我的画本"作品列表;
- common:公共能力沉淀,供各业务模块复用;
- oh_router:路由模块,负责跨模块页面跳转的组织。
这种按业务域拆分模块的组织方式,让"加一组快捷配色"这样的改动被天然限制在 home 模块内,不需要触碰壳工程与个人中心,回归边界非常清晰——这正是模板工程给二开者上的第一课:改动的物理边界由模块划分决定。
三、核心机制一:DrawingBoardVM 与绘制路径管理
画板交互的核心是 DrawingBoardVM 视图模型,它负责管理绘制路径、撤销(undo)与重做(redo)。从定制任务的验收标准可以反推出它的职责边界:新增颜色后,"选择新颜色绘制的线条使用相应色值",同时"原颜色入口、撤销与清空保持原有行为"——也就是说,DrawingBoardVM 只关心路径的记录与回放,颜色只是路径数据的一个属性字段,选色逻辑与绘制逻辑通过 chooseColor 事件解耦。
值得注意的是,撤销与重做以"路径"为最小单位,而不是以像素为单位。这让撤销栈的数据量与用户操作次数线性相关,与画布尺寸无关,是画板类应用常见的内存友好设计。定制快捷配色时不改变这个数据结构,正是为了不破坏撤销/重做对历史路径的回放能力。
四、核心机制二:PersistenceV2 与画本数据组织
画作数据的持久化采用了状态管理 V2 的 PersistenceV2:画本列表(用户保存的作品集合)由 PersistenceV2 维护,应用重启后自动恢复;画作图像本身保存在应用临时目录,再次编辑时载入图像,但不恢复逐笔历史。
这是一个经过权衡的设计:图像 + 列表元数据保证了用户重启后能看到自己的作品并继续编辑;而不保存逐笔历史则大幅降低了持久化体积与恢复复杂度——撤销历史只在单次会话内有意义,会话结束后丢弃。对二开者而言,这意味着新增功能不能依赖"跨会话恢复路径历史"的假设,案例验收标准里明确写了"再次编辑图像不要求恢复逐笔历史",就是给这条边界画了线。
五、定制任务拆解:如何安全地加一组快捷配色
按案例指引,定制路径可以分为四步:
- 读工程:阅读 features/home/src/main/ets/comp/ColorContent.ets、颜色常量(COLOR_ARR)、ColorGrid 组件与 DrawingBoardVM 的状态定义,理清现有选色路径;
- 定方案:提出快捷配色的数据结构、选色回调与空组默认值方案,先确认再动手;
- 做实现:沿用字符串色值与 chooseColor 事件,新增一组颜色入口,保证新色绘制、原色入口、撤销、清空四项行为均不回归;
- 做验证:构建运行后用新色绘制测试线条,检查原颜色、撤销与清空行为,保存并重新打开验证图像存储机制,依据日志修复问题。
这套"方案先行、验收驱动"的实践方式,比单纯跑通编译更有价值:它训练的是在现有工程上做最小侵入式改动的能力——这也正是企业级鸿蒙应用开发中最常见的工作场景。
六、小结
绘画应用模板展示了鸿蒙模板类工程的三个关键组织方式:以 products/entry 为壳、按业务域拆分模块的依赖结构;以 DrawingBoardVM 为核心、以路径为单位、以事件解耦选色的画板状态管理;以 PersistenceV2 维护画本列表、图像存临时目录、不恢复逐笔历史的持久化权衡。对想入门鸿蒙二开的开发者来说,从这个模板入手,用一个"快捷配色"任务就能走完读、改、验的完整闭环,性价比很高。
- 点赞
- 收藏
- 关注作者
评论(0)