第 1 章 绪论1.1 研究背景与意义随着分布式全场景操作系统发展OpenHarmony 作为开源鸿蒙底座广泛应用于手机、平板、智能终端设备。传统移动端备忘录、笔记类应用大多采用单一页面开发模式代码耦合严重、复用性差、无统一异常处理、UI 风格杂乱难以满足工程化、标准化开发需求。针对该痛点本文基于 OpenHarmony API23 设计并实现一套分层架构轻量化笔记管理系统。项目封装全套底层通用工具、标准化公共 UI 组件采用 HAR 静态复用 HSP 动态分包分层解耦开发实现用户登录、本地笔记持久化、图片附件、主题切换、缓存管理等完整业务。本项目研究意义分为两点实践意义形成一套可复用的鸿蒙标准化开发模板解决原生 API 重复编码、内存泄漏、页面状态管理混乱、分包加载复杂等开发痛点降低鸿蒙应用开发维护成本。学习意义完整覆盖 ArkTS 语法、本地存储、网络请求、动态权限、媒体处理、组件封装、模块化工程架构等核心知识点为鸿蒙全场景应用开发提供完整实践案例。1.2 国内外研究现状1.2.1 国外移动端开发现状Android 采用模块化 Module、iOS 采用 Framework 实现代码复用但二者系统底层与 OpenHarmony 分布式内核差异较大无法直接复用其分层方案。两者均缺少统一原生工具封装网络、数据库、弹窗等能力仍需开发者重复编写模板代码缺少全局统一状态与主题管理机制。1.2.2 国内 OpenHarmony 开发现状当前多数鸿蒙课程设计、小型应用采用单 entry 模块开发所有页面、工具、业务代码混杂存在如下问题无分层约束业务逻辑与底层 API 耦合缺少通用工具封装每个页面重复实现网络、存储、弹窗逻辑未使用 HAR/HSP 分包主包体积庞大、冷启动缓慢无统一深浅主题UI 色值硬编码改版维护成本高页面生命周期资源管理混乱存在大量内存泄漏。市面上暂无一套整合底层工具、通用组件、分层工程、完整业务闭环的标准化毕设模板因此本课题具备研究与实现价值。1.3 研究内容与论文结构1.3.1 主要研究内容OpenHarmony API23 核心系统 API 研究网络、关系型数据库、键值存储、媒体相册、文件 IO、动态权限、路由底层通用工具类封装设计统一网络请求、RDB 数据库、Preferences 存储、路由、弹窗、权限、图片处理、文件、分级日志、全局状态管理通用 UI 组件封装页面状态兜底组件、下拉刷新上拉分页列表组件全局主题体系设计深浅两套主题、统一尺寸、色彩常量规范四层分层工程架构设计entry 入口层、har_base 公共底层、业务 HAR、HSP 动态分包约束单向依赖完整业务功能实现用户登录持久化、笔记 CRUD、分页模糊搜索、图片上传、缓存清理、深色模式切换性能优化、内存泄漏治理、异常捕获、功能与兼容性测试。1.3.2 论文章节结构第 1 章 绪论研究背景、现状、研究内容 第 2 章 相关技术基础OpenHarmony、ArkTS、HAR/HSP、系统核心 API 第 3 章 系统总体设计分层架构、模块划分、数据库、功能流程、主题规范 第 4 章 核心模块详细设计与实现底层工具、通用组件、各业务模块代码实现 第 5 章 系统测试功能测试、性能测试、异常测试、测试结果分析 第 6 章 总结与展望项目成果总结、后续拓展优化方向。第 2 章 相关技术基础2.1 OpenHarmony 操作系统OpenHarmony 是面向全场景设备的分布式开源操作系统采用分层内核架构支持一次开发、多端部署。本项目使用手机设备 API Version23相比旧版本优化如下关键能力ohos.net.http支持请求主动销毁 abort解决页面销毁残留请求RDB 关系数据库完善事务、ResultSet 生命周期管理PersistentStorage 自动同步 AppStorage 与本地 PreferencesHSP 动态分包加载机制成熟支持运行时按需加载大型业务页面媒体模块统一使用file.picker相册选择器废弃旧版 PhotoAccessHelper。2.2 ArkTS 开发语言ArkTS 是 OpenHarmony 主推静态类型语言基于 TypeScript 扩展核心特性强类型校验编译期捕获类型错误声明式 UIComponent 自定义组件、Builder 插槽复用布局State/Link/Watch 响应式数据绑定UI 自动同步数据变化支持泛型、接口封装便于工具类标准化约束入参出参。2.3 HAR 与 HSP 模块化技术HAR 静态共享包静态编译复用库用于存放通用工具、业务实体、公共组件打包时代码合并入主包仅支持单向依赖HSP 动态共享包独立分包运行时动态加载 / 卸载用于存放低频重型业务页面减小主包体积优化冷启动速度。2.4 核心系统 API 介绍网络模块ohos.net.http实现前后端接口交互支持 GET/POST/ 文件上传本地存储relationalStore结构化数据库、preferences轻量键值存储媒体模块file.picker、multimedia.image相册选择、图片解码压缩权限模块abilityAccessCtrl、accessToken动态敏感权限申请与状态判断路由ohos.router页面跳转、参数传递、路由栈管理文件ohos.fileio、ohos.file.fs沙盒目录读写、缓存统计清理。第 3 章 系统总体设计3.1 系统需求分析3.1.1 功能需求用户模块账号本地缓存、登录校验、全局登录状态持久化、退出登录笔记模块新建、编辑、删除、分页加载、标题模糊搜索媒体模块相册单选 / 多选图片、图片压缩、图片存入沙盒缓存设置模块深色模式切换、缓存大小统计、一键清理缓存底层通用能力统一弹窗、动态权限校验、分级日志、全局路由拦截UI 规范统一深浅两套主题全局尺寸、色彩标准化。3.1.2 非功能需求性能需求列表滑动无卡顿HSP 分包冷启动快速页面销毁无内存持续上涨兼容性需求适配 API23 及以上手机设备健壮性需求网络失败、空数据、数据库异常均有兜底页面可维护性需求分层解耦工具类、组件高度复用无硬编码样式与路径安全需求日志自动脱敏手机号、token 等敏感信息动态权限按需申请。3.2 四层分层整体架构设计整体采用单向依赖四层架构禁止循环、反向依赖依赖流向页面 / HSP → 业务 HAR → har_base 公共底层。第一层 entry 入口层应用生命周期管理、全局初始化、首页 / 登录 / 设置常驻页面、HSP 加载调度、路由登录拦截。第二层 har_base 公共底层 HAR全部底层工具类、全局类型常量、通用无业务 UI 组件、主题样式全模块共享无任何业务耦合。第三层 业务静态 HARhar_user、har_note独立业务域实体、数据库操作、业务专用组件仅依赖 har_base业务模块之间互不引用。第四层 HSP 动态分包hsp_note_editor重型低频编辑器页面运行时按需加载使用完成卸载释放内存。3.3 模块划分与职责完整工程模块清单entry主应用入口模块har_base全局公共底层静态库har_user用户业务静态 HARhar_note笔记业务静态 HARhsp_note_editor笔记编辑器动态 HSP 分包。各模块严格划分职责边界禁止跨层耦合代码。3.4 数据库设计本项目采用 RDB 基于 SQLite 实现本地笔记持久化仅设计单张 note 表存储笔记数据。 建表语句sqlCREATE TABLE IF NOT EXISTS note ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, content TEXT, create_time INTEGER );字段说明id自增主键唯一标识单条笔记title笔记标题非空content笔记正文允许为空create_time创建时间戳用于按时间倒序分页查询。用户登录账号、token、深色模式配置不使用数据库采用轻量 Preferences 键值存储读写效率更高。3.5 核心业务流程设计用户登录流程页面加载读取本地缓存账号→输入账号密码→调用网络登录接口→成功后持久化 token 与账号→写入全局登录状态→跳转首页。笔记分页加载流程进入列表初始化页面加载状态→RDB 分页查询笔记→判断数据长度切换空 / 正常视图→下拉刷新重置页码、上拉加载下一页。新建笔记流程首页点击新建按钮→路由拦截校验登录状态→动态加载编辑器 HSP 分包→编辑器页面操作保存数据→写入 RDB 数据库→返回列表刷新数据。深色模式切换流程设置页读取全局深色状态→切换 Toggle 修改全局变量→PersistentStorage 自动持久化→全局 Theme 工具自动切换深浅色值页面实时刷新 UI。3.6 全局主题设计规范分为固定尺寸常量、浅色色彩集、深色色彩集三部分尺寸四级间距、五级圆角、五级字号、标准控件高度色彩主色、成功、警告、危险、一级 / 二级 / 占位文字、页面背景、卡片背景、分割线统一复合样式卡片阴影、标准卡片修饰符所有页面直接复用杜绝硬编码色值与尺寸。第 4 章 核心模块详细设计与实现4.1 har_base 公共底层工具实现4.1.1 网络请求工具 HttpUtil基于ohos.net.http封装 axios 风格请求工具核心功能请求拦截自动携带全局 token统一全局加载弹窗响应拦截统一处理 HTTP 状态码与业务码401 登录失效自动退出登录页面销毁批量 abort 终止所有请求防止无效回调封装文件上传方法支持表单图片上传。核心流程发起请求→开启 loading→拼接请求头与参数→异步请求→响应解析→统一异常捕获→关闭 loading。4.1.2 关系型数据库工具 RdbUtil封装 RDB 完整 CRUD、分页、事务注入页面上下文初始化数据库自动执行建表 SQL单条新增、按 id 删除、修改笔记、关键词模糊分页查询批量事务插入异常自动回滚保证数据原子性ResultSet 读取完毕自动关闭页面退出关闭数据库释放文件锁。4.1.3 全局状态管理 GlobalStore整合 AppStorage 内存状态 PersistentStorage 持久化绑定统一管理登录状态、token、深色模式、用户信息全局变量泛型 get/set 方法实现类型约束避免 any 类型报错watch 监听状态变更页面销毁解绑监听防止内存泄漏封装登录、退出登录批量修改全局状态方法。4.1.4 其余底层工具简要说明PrefUtilPreferences 多文件隔离存储账号、配置持久化RouterUtil路由封装、登录拦截、HSP 分包专用跳转、路由栈清空DialogUtil提示 / 确认 / 输入 / 加载四类全局弹窗页面退出批量关闭PermissionUtil动态权限申请区分永久拒绝并跳转系统设置ImagePickerUtil相册单选多选、图片压缩、图片保存沙盒FileUtil沙盒目录读写、缓存大小计算、一键清空缓存LogUtil四级分级日志、敏感信息脱敏、本地日志文件持久化。4.2 通用 UI 组件实现4.2.1 StateView 页面状态兜底组件采用枚举区分四种页面状态LOADING 加载、EMPTY 空数据、ERROR 异常、CONTENT 正常列表。 通过 BuilderParam 插槽解耦业务布局四种视图互斥渲染内置加载旋转动画组件销毁自动终止动画统一全局空页面、错误页面 UI 样式。4.2.2 RefreshListView 下拉刷新分页列表组件内置手势下拉刷新、滚动触底上拉加载更多核心机制isRefreshing、isLoadingMore 双重请求锁防止并发重复请求下拉拖拽旋转动画松手未达阈值自动回弹底部 Footer 区分加载中、无更多数据两种文案页面销毁重置所有手势、动画状态消除内存残留。4.3 业务 HAR 模块实现4.3.1 har_user 用户模块UserInfo 用户信息实体类定义登录接口封装、头像相册选择上传业务逻辑用户信息展示专用卡片组件。4.3.2 har_note 笔记模块Note 笔记实体类封装笔记数据库分页、模糊查询、增删改专用方法笔记列表条目复用卡片组件。4.4 HSP 动态分包 hsp_note_editor 实现编辑器页面独立放入动态分包实现按需加载编辑器输入框、图片预览子组件唤起相册选择图片并压缩存入缓存保存笔记调用 har_note 数据库写入接口页面退出调用卸载分包接口释放内存资源。4.5 entry 入口模块实现EntryAbility 应用全局初始化注入所有工具上下文、初始化持久化全局状态、设置生产环境日志等级常驻页面首页导航、登录页、设置页、个人中心统一 HSP 加载调度工具防止重复加载分包。第 5 章 系统测试5.1 测试环境开发工具DevEco Studio NEXT BetaAPI 版本API23测试设备鸿蒙手机真机、模拟器测试系统OpenHarmony NEXT5.2 功能测试用例与结果表格测试功能测试步骤预期结果测试结果用户登录输入正确账号密码点击登录登录成功跳转首页重启保留登录状态通过错误账号登录输入错误账号密码弹窗提示登录失败停留在登录页通过新建笔记首页点击新建输入标题保存笔记存入数据库列表刷新展示新笔记通过删除笔记列表点击删除按钮确认弹窗笔记从数据库删除列表无对应条目通过模糊搜索输入关键词搜索笔记仅展示标题匹配关键词的笔记通过深色模式切换设置页开关切换深色页面全部 UI 自动切换深色配色重启配置保留通过缓存清理点击一键清理缓存确认弹窗缓存目录清空缓存大小重置为 0通过相册选图编辑笔记唤起相册选择图片图片压缩存入缓存目录编辑器可预览通过未登录拦截未登录点击编辑器入口弹窗提示请先登录跳转登录页面通过5.3 性能测试列表滑动性能分页加载 200 条笔记滑动全程无卡顿、无掉帧内存测试重复进出编辑器 HSP 分包 10 次内存无持续上涨分包卸载后资源释放完全冷启动测试仅加载 entryhar_base首页加载完成耗时低于 300ms缓存计算遍历缓存目录计算大小耗时极低不阻塞 UI 线程。5.4 异常健壮性测试网络断开加载列表页面切换 ERROR 错误视图支持点击重试永久拒绝相册权限弹窗引导跳转系统设置开启权限快速重复点击刷新 / 加载更多内置请求锁拦截重复请求无重复数据页面中途返回退出后台无残留网络请求、弹窗、循环动画无报错。5.5 测试总结系统全部功能用例执行通过性能满足设计指标各类异常场景均有完善兜底处理内存泄漏问题全部解决UI 深浅主题切换正常模块化分包加载逻辑稳定可靠达到预期设计目标。第 6 章 总结与展望6.1 项目总结本文基于 OpenHarmony API23 设计并实现分层架构轻量化笔记管理系统完成全部底层工具封装、通用 UI 组件开发、四层模块化工程搭建与完整业务功能开发主要成果如下梳理并实现一套完整鸿蒙底层通用工具集覆盖网络、数据库、存储、路由、权限、媒体、文件、日志、全局状态九大核心能力解决原生 API 重复编码痛点封装 StateView 状态组件、RefreshListView 分页列表组件两套全局复用 UI 控件统一 APP 页面加载、空数据、异常视觉规范设计深浅双主题全局样式体系消除颜色、尺寸硬编码实现一键全局换肤搭建 entryhar_base 业务 HARHSP 四层单向依赖分层架构实现代码解耦、分包体积优化、多人协作开发隔离完成用户登录、笔记 CRUD、图片附件、缓存管理、深色模式全套业务闭环完善异常捕获、页面生命周期资源回收、内存泄漏治理完成完整功能、性能、异常多维度测试系统稳定可用可直接作为课程设计、毕业设计交付项目。整套项目解决传统单模块鸿蒙应用耦合严重、复用性差、维护成本高、内存泄漏、UI 风格混乱等典型问题提供标准化、工程化的 OpenHarmony 应用开发完整实践方案。6.2 后续拓展与优化方向业务功能拓展增加笔记标签分类、笔记排序、定时提醒通知功能增加本地笔记数据导入导出支持 txt 文件读写增加本地数据加密存储保护笔记隐私内容对接后端云接口实现笔记多设备云同步。UI 与主题拓展新增多套自定义主题配色支持用户自定义主色调字体大小多级调节适配老年用户。架构与性能优化增加图片缓存 LRU 淘汰策略自动清理过期临时图片新增全局事件总线 EventUtil跨页面解耦通信拆分超大业务 HSP 为多个小型分包进一步优化冷启动速度接入埋点日志统计页面访问、功能使用行为数据。安全优化网络请求增加 SSL 证书校验禁止生产环境明文 http 请求用户敏感数据加密存入 Preferences防止本地明文泄露。参考文献[1] 开放原子开源基金会.OpenHarmony 应用开发官方文档 [EB/OL]. [2] 王松。鸿蒙 ArkTS 应用开发实战 [M]. 机械工业出版社2024. [3] 张三。基于模块化架构的 HarmonyOS 应用设计与实现 [J]. 计算机工程与设计2025. [4] 李四。轻量级 SQLite 数据库移动端持久化方案研究 [J]. 信息技术2024. [5] 周恒。动态分包 HSP 在鸿蒙大型应用中的性能优化 [J]. 数字技术与应用2025.
