简介基于HarmonyOS打造的个人日记本应用完整源码面向有一定ArkTS基础或对鸿蒙应用开发感兴趣的开发者覆盖从登录、日记列表、撰写编辑到多媒体记录与关系型数据库存储等核心功能并展示了跨设备数据同步思路适合日常记录与鸿蒙应用开发练手。压缩包共101个文件体积仅391KB其中26个ets界面与逻辑文件构成主要页面11个json和9个json5文件负责工程配置与模块声明7个ts文件提供辅助脚本另有39个png图片、1个gif动效及项目构建说明等整体结构清晰便于按模块阅读。已有437人学习或下载。代码围绕日记列表、写日记、登录页、下拉刷新、数据库工具等典型模块展开覆盖界面布局、事件交互、本地数据持久化、智能提醒、内容加密与社区交互等实现能帮助理解HarmonyOS应用工程的组织方式也可直接作为二次开发或毕设源码基础模块注释规范、命名清晰方便在DevEco Studio中打开研读对想了解鸿蒙系统开发规范与完整应用落地的读者很有价值。1. 为什么在 HarmonyOS 里做日记本Stage 模型、ArkTS 与本地优先的选型个人日记本这类 APP功能边界最简单技术容量却一点不小。文本编辑、日期索引、图片附件、数据持久化、隐私保护每一样都要选型而这些选型在 HarmonyOS 上的答案和 Android、iOS 并不完全一样。拿到一份“基于 HarmonyOS 开发的个人日记本应用 APP 源代码”第一件事不是急着看页面代码而是先搞懂它跑在哪个应用模型上、UI 是声明式还是命令式、数据层用的是关系型数据库还是首选项。这三个问题决定了后续改功能、换图标、加搜索时是不是要大重构。常见方案是 ArkTS ArkUI 声明式开发 Stage 模型配合 RelationalStore 存正文元数据、文件目录存图片这套组合对日记场景足够稳也是 HarmonyOS 应用基础认证考试覆盖的主流路线。下面从工程结构开始把一套可以落地的日记本源码拆开讲。2. 搭 ArkTS 工程从 DevEco Studio 空工程到第一次运行2.1 拿到源代码先看哪几个文件HarmonyOS 工程和 Android 工程最大的差异在目录约定。打开一份日记本项目先别急着点运行按这个顺序看文件build-profile.json5确认compatibleSdkVersion和targetSdkVersion源码能不能编译九成取决于这里的版本与本地 SDK 是否匹配。AppScope/app.json5应用级配置bundleName是应用唯一标识改包名要同步这里。entry/src/main/module.json5模块级配置页面路径、权限声明、入口 Ability 都在这里。entry/src/main/ets/pagesArkTS 页面目录日记列表、编辑页、设置页一般都在这个目录下。entry/src/main/resources/base/profile/main_pages.json页面路由注册表。每新增一个页面必须在这个 JSON 里登记否则router.pushUrl会直接报错找不到页面。文件路径作用常见踩坑build-profile.json5SDK 版本、签名配置版本号对不上编译报 API 不匹配module.json5权限、Ability 声明没声明权限运行时静默失败main_pages.json页面路由表新增页面忘记注册跳转白屏entry/src/main/etsArkTS 源码目录页面代码全放 pages 会导致路由混乱提示main_pages.json里第一个页面就是应用冷启动入口。日记本 App 通常是“日记列表页”而不是“新建页”改启动页只调这个数组的顺序即可不要动 Ability 的onWindowStageCreate。2.2 最小可运行的日记编辑页不管源代码多复杂核心页面永远长这样一个标题输入框、一个正文多行输入框、一个保存按钮。用 ArkUI 写出来是这样的Entry Component struct DiaryEditorPage { State title: string ; State content: string ; build() { Column({ space: 12 }) { TextInput({ placeholder: 补一个标题比如今天加班改 bug, text: this.title }) .onChange((value: string) { this.title value; }) TextArea({ placeholder: 写点细节别只写“今天很累”, text: this.content }) .onChange((value: string) { this.content value; }) Button(保存这篇日记) .width(100%) .onClick(() { // 这里不要直接写数据库操作应该调数据层方法 saveDiary(this.title, this.content); }) } .padding(16) .width(100%) .height(100%) .backgroundColor(#F5F5F5) } }逻辑说明State装饰器是 ArkUI 声明式响应的核心title和content一旦被onChange回调改写UI 会自动刷新不需要像传统命令式写法那样手动操作组件实例。参数说明TextInput适合单行输入TextArea适合多行正文.width(100%)和.padding(16)是链式调用的通用属性方法顺序不影响结果。保存按钮的onClick里只调saveDiary函数具体插入逻辑放在数据层这是让源码可维护的关键习惯。2.3 在模拟器与真机上跑通DevEco Studio 里点右上角 Run 按钮之前确认三件事登录华为账号并完成自动签名否则 HAP 装不进设备开发者模式已开启通过hdc list targets能看到设备模拟器冷启动较慢首次编译要等几十秒属正常现象。命令行方式也可以验证构建产物hdc list targets hdc install entry/build/default/outputs/default/entry-default-signed.hap hdc shell aa start -a EntryAbility -b com.example.diary说明hdc list targets查看设备连接状态hdc install安装签名后的 HAP 包aa start带-a指定 Ability 名、-b指定 bundleName用来验证应用启动是否正常。如果aa start报错先回module.json5里核对 Ability 名称是否写成了EntryAbility这是初学者最容易踩的坑。3. 写日记的核心Editor 组件、RDB 存储与 DatePicker 索引3.1 日记表字段设计日期字符串与时间戳的边界日记本的数据结构不同 App 差异很大但“按天查看”这个核心诉求决定了表结构的关键设计日期字段存纯日期字符串时间戳单独存。把2025-06-14拆成day字段存TEXT把created_at和updated_at存成INTEGER毫秒时间戳。这样做的原因是 SQL 查询时可以直接用等值匹配查某一天的日记而不需要写BETWEEN 00:00:00 AND 23:59:59这种区间条件。字段名类型说明idINTEGER主键自增titleTEXT标题允许为空contentTEXT正文核心字段dayTEXT日期格式yyyy-MM-dd加索引moodTEXT心情标签如“开心”“疲惫”imagesTEXT图片相对路径的 JSON 数组created_atINTEGER首次保存时间戳updated_atINTEGER最近修改时间戳3.2 用 RelationalStore 初始化数据库HarmonyOS 的 RelationalStore 是官方关系型数据库能力适合日记这类结构化数据。初始化代码import relationalStore from ohos.data.relationalStore; import common from ohos.app.ability.common; const DB_NAME diary.db; const TABLE_NAME diary; async function initDb(context: common.UIAbilityContext): PromiserelationalStore.RdbStore { const config: relationalStore.StoreConfig { name: DB_NAME, securityLevel: relationalStore.SecurityLevel.S1, }; const store await relationalStore.getRdbStore(context, config); await store.executeSql( CREATE TABLE IF NOT EXISTS ${TABLE_NAME} ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL DEFAULT , content TEXT NOT NULL DEFAULT , day TEXT NOT NULL, mood TEXT DEFAULT , images TEXT DEFAULT [], created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL ) ); await store.executeSql( CREATE INDEX IF NOT EXISTS idx_diary_day ON ${TABLE_NAME} (day) ); return store; }逻辑说明getRdbStore是异步接口首次调用会创建数据库文件并缓存连接后续调用复用同一实例。建表语句里的IF NOT EXISTS保证重复初始化不报错这是源码里必须有的防御性写法。参数说明securityLevel是 RelationalStore 的隐私分级参数S1 最低、S4 最高。日记内容属于个人隐私按华为应用市场的审核惯例建议至少设为 S2。如果源代码里用的是 S1且要上架这里需要改。3.3 插入、更新与按日查询插入日记时把day格式化好图片列表序列化成 JSON 字符串async function insertDiary(store: relationalStore.RdbStore, data: DiaryItem): Promisenumber { const values: relationalStore.ValuesBucket { title: data.title, content: data.content, day: data.day, mood: data.mood, images: JSON.stringify(data.images), created_at: Date.now(), updated_at: Date.now(), }; return await store.insert(TABLE_NAME, values); }查询某一天的日记用RdbPredicates构造等值条件async function queryByDay(store: relationalStore.RdbStore, day: string): PromiseDiaryItem[] { const predicates new relationalStore.RdbPredicates(TABLE_NAME); predicates.equalTo(day, day).orderByDesc(created_at); const resultSet await store.query(predicates, [id, title, content, day, mood, images, created_at]); const list: DiaryItem[] []; while (resultSet.goToNextRow()) { list.push({ id: resultSet.getLong(resultSet.getColumnIndex(id)), title: resultSet.getString(resultSet.getColumnIndex(title)), content: resultSet.getString(resultSet.getColumnIndex(content)), day: resultSet.getString(resultSet.getColumnIndex(day)), mood: resultSet.getString(resultSet.getColumnIndex(mood)), images: JSON.parse(resultSet.getString(resultSet.getColumnIndex(images))), createdAt: resultSet.getLong(resultSet.getColumnIndex(created_at)), }); } resultSet.close(); // 不 close 会造成游标泄漏查询变慢 return list; }逻辑说明ResultSet类似数据库游标goToNextRow()判断是否有下一行配合getColumnIndex定位列。这里最容易出的问题是忘记close()导致后续查询越跑越慢。images字段因为是 JSON 数组取出后要JSON.parse还原成数组。参数说明orderByDesc(created_at)让同一天的多条记录按时间倒序适合“补写多条”的场景。如果改成orderByAsc列表顺序会反过来按用户习惯调整即可。3.4 日期切换DatePicker 的月份从 0 开始日记本的日期索引层常见做法是页面顶部放一个日期选择器。HarmonyOS 的DatePicker组件使用方式State selectedDate: Date new Date(); // 把 Date 格式化为 yyyy-MM-dd注意 getMonth() 从 0 开始计数 function formatDay(d: Date): string { const y d.getFullYear().toString().padStart(4, 0); const m (d.getMonth() 1).toString().padStart(2, 0); const day d.getDate().toString().padStart(2, 0); return ${y}-${m}-${day}; } // 在 build() 中使用 DatePicker({ selected: this.selectedDate, onDateChange: (value: Date) { this.selectedDate value; this.currentDay formatDay(value); this.loadDiary(this.currentDay); } })逻辑说明onDateChange回调返回的是完整Date对象必须通过formatDay转成字符串再传给查询层。getMonth()返回 0-11不做1处理会让索引永远差一个月这个 bug 在源码里非常常见。参数说明selected属性是受控绑定外部修改selectedDate会同步滚轮位置onDateChange只在用户滑动时触发代码里主动set日期不会触发回调所以页面加载时要手动调一次loadDiary。4. 让日记更像产品图片附件、草稿自动保存与密码锁4.1 图片附件photoAccessHelper 选图后复制到沙箱老源码里常见用mediaLibrary.requestPermission申请读图权限但 API 10 之后这条路已经废弃换成PhotoViewPicker免权限选图。把选中的图片复制到应用沙箱既能避免权限问题又能防止原图被删除导致日记图片失效import picker from ohos.file.picker; import fs from ohos.file.fs; async function attachImages(context: common.UIAbilityContext): Promisestring[] { const photoPicker new picker.PhotoViewPicker(); const result await photoPicker.select({ MIMEType: picker.PhotoViewMIMETypes.IMAGE_TYPE, maxSelectNumber: 9, }); const dir ${context.filesDir}/diary_images; fs.mkdirSync(dir); const savedPaths: string[] []; for (let i 0; i result.photoUris.length; i) { const dest ${dir}/${Date.now()}_${i}.jpg; await fs.copyFile(result.photoUris[i], dest); savedPaths.push(dest); } return savedPaths; }逻辑说明PhotoViewPicker.select返回的是系统授权后的临时 URI 列表应用只能通过这个 URI 读取内容。直接保存 URI 到数据库并不可靠因为系统可能在应用退出后回收访问权限。因此选完图立刻copyFile到filesDir才是正确用法。参数说明maxSelectNumber: 9控制一次最多选 9 张MIMEType过滤文件类型只选图片。copyFile的源参数支持file://协议 URI这是 API 10 之后的行为。如果源码里用的是fs.open 手动读取字节的老写法可以整体替换成这段。4.2 草稿自动保存防抖定时器与页面生命周期写日记是高频输入场景每敲一个字就写一次数据库会产生大量无效写入。常见做法是加一个 800 毫秒的防抖定时器停止输入后才落盘private timer: number -1; private scheduleSave(newContent: string) { if (this.timer ! -1) { clearTimeout(this.timer); } this.timer setTimeout(() { this.saveDraft(newContent); this.timer -1; }, 800); } aboutToDisappear() { if (this.timer ! -1) { clearTimeout(this.timer); this.saveDraft(this.content); } }逻辑说明scheduleSave每次被调用先清掉上一次定时器再重新计时只有停顿满 800 毫秒才触发saveDraft。这一步能把几百次输入合并成几次数据库写入。参数说明aboutToDisappear是 ArkUI 页面销毁生命周期用户返回列表或退出应用时如果定时器还没触发就立即保存最后一次内容避免草稿丢失。这种“防抖 兜底”组合是日记类源码最值得保留的部分。4.3 密码锁哈希校验与首选项的边界给日记加上锁需要先想清楚一件事HarmonyOS 应用沙箱内的数据库文件普通用户拿不到但 root 设备或备份恢复场景下可被读取。所以密码锁只防“打开应用的人”不防“拿到文件的人”。存储密码校验值时不要存明文常见做法是用cryptoFramework的 SHA-256 做摘要后加盐保存验证时用同样流程计算后比对import preferences from ohos.data.preferences; async function verifyPin(context: common.UIAbilityContext, input: string): Promiseboolean { const pref await preferences.getPreferences(context, { name: diary_security }); const savedHash await pref.get(pin_hash, ); if (savedHash ) { const newHash sha256WithSalt(input); await pref.put(pin_hash, newHash); await pref.flush(); return true; } return savedHash sha256WithSalt(input); }逻辑说明preferences是轻量键值库适合存密码哈希这类小数据不适合存日记正文。sha256WithSalt内部用cryptoFramework.createMd(SHA256)实现具体构造方式在不同 API 版本下有差异但核心思路一致密码加固定盐值后取摘要数据库中永远不出现原文。参数说明pref.flush()是持久化落盘操作put之后不 flush数据在应用重启后可能丢失。没有自定义生物认证需求时密码锁做到这个程度已经够用想用指纹则需要额外接入ohos.biometrics模块并申请ohos.permission.ACCESS_BIOMETRIC权限。4.4 全文搜索LIKE 查询与索引失效按内容搜日记是本类 App 的高频诉求直接给字段加索引并不能解决问题。SQL 里LIKE %关键词%这种前置通配写法无法利用索引必须做全表扫描。日记数据量在万条以内时性能足够不需要上全文索引async function searchDiary(store: relationalStore.RdbStore, keyword: string): PromiseDiaryItem[] { const predicates new relationalStore.RdbPredicates(TABLE_NAME); predicates.like(title, %${keyword}%).or().like(content, %${keyword}%); const resultSet await store.query(predicates, [id, title, content, day, created_at]); // 遍历逻辑同 queryByDay这里省略 }说明.like().or().like()链式调用生成WHERE title LIKE ? OR content LIKE ?。like条件用or连接时要保证or()前后都有完整条件。搜索结果的排序建议加orderByDesc(updated_at)因为用户更关心最近修改的日记而不是创建最早的。如果后续日记量增长到数万条再考虑引入fts4全文索引现阶段不必过度设计。5. 让简单功能具备工程化能力签名打包、备份与代码级检查5.1 DevEco Studio 签名打包的三步从源码到可安装 HAP必须经过签名。DevEco Studio 菜单栏打开 File Project Structure Signing Configs勾选 Automatically generate signature登录华为账号后会自动生成调试签名上架华为应用市场需要的是发布证书要进 AppGallery Connect 后台申请。hdc file recv /data/app/el2/100/base/com.example.diary/haps/entry/files/diary.db ./backup/ hdc shell aa force-stop com.example.diary第一行是导出应用沙箱里的数据库文件com.example.diary要换成源码里的真实bundleName路径中的el2/100指设备用户 100 的加密存储分区。第二行是强制停止应用用来验证数据写入是否完整。日常调试时这两个命令组合使用可以快速拿到真实数据排查问题。5.2 应用内导出备份JSON 兜底方案沙箱数据库会随应用卸载而清空这是源码交付后用户反馈“数据没了”的最常见原因。在设置页加一个“导出全部日记”按钮比教用户备份文件更可靠。核心逻辑是把查询结果序列化成 JSON用文件流写入沙箱再引导用户通过分享或hdc取走async function exportToJson(context: common.UIAbilityContext, list: DiaryItem[]): Promisestring { const dest ${context.filesDir}/diary_backup_${Date.now()}.json; const file fs.openSync(dest, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE | fs.OpenMode.TRUNC); fs.writeSync(file.fd, JSON.stringify(list, null, 2)); fs.closeSync(file.fd); return dest; }说明OpenMode.TRUNC表示打开时清空旧内容防止同一命名下的文件残留过期数据writeSync是同步写对万条级别的日记数据量足够快不需要引入异步任务队列。5.3 交付前过一遍代码检查点检查项操作达标标准SQL 注入所有查询走RdbPredicates参数绑定无字符串拼接 SQL游标泄漏搜索ResultSet的close()调用每个查询路径都有 close敏感权限module.json5里逐项核对没有READ_MEDIA之类旧权限防抖兜底aboutToDisappear中保存草稿强制停止应用后草稿不丢日期格式所有getMonth()是否 1跨月日记索引正确图片引用图片存沙箱相对路径不直接存原图 URI最后再验证一遍清空应用数据后安装 HAP确认首次启动能自动建库写一篇带图片的日记杀进程重启确认数据和图片都在切换日期到昨天再切回来确认索引无串号。这三步跑通这份 HarmonyOS 日记本源码才算真正交付完成。本文还有配套的精品资源点击获取