作者：七七 发布时间：2026-01-19 HarmonyOS版本：6.0.0.47 (API 20) 项目源码：zqaini002 系列文章：共30篇，持续更新至2026年6月

---

写在前面

我是七七，2026 届应届生，目前正在实习的一名普通 Java 开发者。最近《噶了么》特别火啊（下架咯），突发奇想打算做一个鸿蒙相关的小项目，顺便学习下国产化开发技术～

从2026年1月开始，我将用6个月时间，带你从零开始完成一个真实的HarmonyOS 6.0应用。

---

这个应用做什么？

产品名称：今天空白（Today is Blank）

核心理念：

• 每天只记录一件你今天做过的事

• 没记录？明确告诉你：今天空白

• 不做目标管理、不做OKR、不做成长系统

• 只给你一个残酷的事实：时间是否被浪费

为什么做这个应用？

在这个到处充斥着"打卡激励"、"目标管理"的时代，我想做一个反其道而行之的应用：

• 不鼓励你

• 不激励你

• 不评价你

只陈述事实：你今天做了什么，还是什么都没做

这种克制与冷静，反而能让人更清醒地面对时间流逝。

---

技术栈全景

前端技术栈

开发框架：HarmonyOS NEXT 6.0
SDK 版本：6.0.0.47 (API 20)
开发语言：ArkTS
UI 框架：ArkUI（声明式UI）
状态管理：V2 装饰器（@ObservedV2/@ComponentV2/@Local/@Param）
构建工具：Hvigor
数据存储：Preferences（轻量级键值存储）
加密方案：AES-256-GCM（端到端加密）

后端技术栈

开发语言：仓颉（Cangjie 1.0.4）- 华为自研语言
Web 框架：Cjoy（高性能 Web 框架）
数据库：PostgreSQL 16+ / OpenGauss
数据库驱动：opengauss-driver（完全兼容 PostgreSQL 协议）
认证方式：JWT（Access Token + Refresh Token）
加密方案：E2EE（端到端加密，服务器零知识）

架构设计

前端架构：SOLID 原则 + DDD（领域驱动设计）
状态管理：Store 模式（V2 响应式）
数据流向：Repository 模式（隔离数据访问）
同步策略：离线优先 + LWW 冲突解决

---

系列文章规划

这个系列共30篇文章，分为8个阶段：

第一阶段：入门与环境搭建（1月）

第1篇【本篇】：系列总览 - 项目介绍与技术路线图 第2篇：HarmonyOS 6.0 环境搭建 - DevEco Studio 配置 + 真机调试 第3篇：ArkTS 语言核心特性 - 装饰器、类型系统、异步编程

第二阶段：V2状态管理深度实战（2月）

第4篇：V2 状态管理（上）- 核心概念与基础用法 第5篇：V2 状态管理（下）- Store 模式与性能优化 第6篇：ArkUI 声明式UI - 布局、样式、组件封装 第7篇：极简UI设计系统 - Design Tokens + 主题系统 第8篇：数据持久化方案 - Preferences、KV、SQLite 选型 第9篇：Preferences 实战 - Repository 模式实现 第10篇：DDD 实践 - 领域模型 + SOLID 原则落地

第三阶段：端到端加密深度实战（3月）

第11篇：密码学基础 - AES、PBKDF2、哈希算法 第12篇：HarmonyOS Crypto API - AES-GCM 加密解密 第13篇：E2EE 架构设计 - 零知识存储完整方案 第14篇：LWW 冲突解决 - 分布式同步算法实战

第四阶段：仓颉语言后端开发（3月下旬-4月）

第15篇：仓颉语言快速入门（v1.0.4）- 语法、类型系统、并发 第16篇：Cjoy 框架实战 - RESTful API 搭建 第17篇：JWT 认证系统 - 双 Token 机制完整实现 第18篇：PostgreSQL/OpenGauss 集成 - opengauss-driver 驱动、连接池、事务 第19篇：后端 API 完整实现 - 同步与记录模块

第五阶段：网络与同步（4月）

第20篇：HarmonyOS 网络请求 - @ohos.net.http + 拦截器 第21篇：离线优先架构 - 本地优先 + 云端同步

第六阶段：测试、调试与发布（4月下旬）

第22篇：单元测试 - @ohos/hypium + Mock 第23篇：性能优化 - 启动优化 + 渲染优化 + 内存管理 第24篇：应用发布 - 签名打包 + AppGallery 上架

第七阶段：进阶与扩展（5月-6月）

第25篇：分布式能力 - 跨设备协同与数据同步 第26篇：Widget 开发 - 桌面小组件快捷记录 第27篇：国际化 - 多语言支持与本地化 第28篇：暗黑模式 - 动态主题切换实现 第29篇：HarmonyOS PC 版 - 多设备适配

第八阶段：收官（6月）

第30篇：开源

---

这个系列的特点

1. 真实项目驱动

• 代码开源在 GitHub，完全可运行

• 每篇文章对应一个开发阶段

2. 最新技术栈

• HarmonyOS 6.0（2025年最新版，API 20）

• V2 状态管理（官方推荐的新一代方案）

• 仓颉语言（华为自研，全网稀缺教程）

3. 深度实战

• 不只是 APDI 罗列，而是完整的架构设计

• 包含端到端加密、分布式同步等生产级特性

• 遵循 SOLID、DDD 等工程最佳实践

4. 系统学习路径

• 从环境搭建到上架发布，全流程覆盖

• 从基础到进阶，循序渐进

• 每周 1-2 篇，持续 6 个月

---

适合谁学习？

HarmonyOS 入门开发者

• 刚接触 HarmonyOS，想系统学习

• 有前端基础，想转 HarmonyOS 开发

移动端开发者

• 有 Android/iOS 经验，想了解 HarmonyOS

• 对跨平台开发感兴趣

全栈工程师

• 想学习端到端加密实现

• 对仓颉语言后端开发感兴趣

架构师

• 想了解 SOLID、DDD 在移动端的实践

• 关注离线优先、分布式同步等架构设计

---

如何阅读这个系列？

建议阅读顺序

1. 按顺序阅读（推荐）

• 每篇文章都基于前一篇的知识

• 完整体验从 0 到 1 的开发过程

2. 按需阅读

• 查看系列规划，选择感兴趣的主题

• 每篇文章都包含完整代码，可独立阅读

学习建议

动手实践

• 跟着文章一起写代码

• 克隆 GitHub 仓库，运行真实项目

理解原理

• 不要只复制代码，理解背后的设计思路

• 思考为什么这样设计，有没有更好的方案

交流讨论

• 评论区提问和分享你的想法

• 参与 GitHub Issues 讨论

---

准备工作

在开始学习之前，你需要准备：

硬件要求

• Mac（macOS 10.15+）或 Windows（Windows 10+）

• 内存：8GB 以上（推荐 16GB）

• 硬盘：至少 20GB 可用空间

软件准备

• DevEco Studio 5.0.3.900+（支持 HarmonyOS 6.0）

• HarmonyOS SDK 6.0.0.47（API 20）

• Git（版本管理）

真机/模拟器

• HarmonyOS 真机（推荐，需要开发者账号）

• 或 HarmonyOS 模拟器（DevEco Studio 自带）

基础知识

• TypeScript/JavaScript 基础（必须）

• 移动端开发经验（有更好，没有也可以学）

• 后端开发基础（学习后端部分时需要）

---

项目核心功能预览

虽然是极简应用，但包含了很多生产级特性：

核心功能

每日唯一记录（新增/修改/删除） 本地持久化存储 账号注册/登录 端到端加密同步 多设备数据同步 冲突智能解决（LWW）

技术亮点

V2 状态管理（@ObservedV2/@Trace） Repository 模式（数据访问隔离） AES-256-GCM 加密（客户端加密） PBKDF2 密钥派生 JWT 双 Token 认证 离线优先架构

---

学习目标

学完这个系列，你将能够：

独立开发 HarmonyOS 应用

• 熟练使用 ArkTS 和 ArkUI

• 掌握 V2 状态管理核心用法

• 理解 HarmonyOS 应用架构设计

实现生产级特性

• 端到端加密完整方案

• 多端数据同步与冲突解决

• 性能优化与安全防护

掌握后端开发

• 仓颉语言基础与实战

• RESTful API 设计与实现

• 数据库操作与 ORM

建立工程思维

• SOLID 原则实践

• DDD 领域驱动设计

• 测试驱动开发（TDD）

---

更新计划

发布节奏

• 频率：每周 1-2 篇

• 时间：每周一/周四上午 9:00

• 平台：CSDN（首发）+ 掘金 + 思否 + 知乎

如何订阅？

1. 关注我的账号（CSDN/掘金/思否）

2. Watch GitHub 仓库（接收更新通知）

---

互动交流

提问方式

• 评论区：文章下方直接评论

• GitHub Issues：技术问题提 Issue

我的承诺

每条评论都会认真回复 GitHub Issues 24 小时内响应 代码问题提供完整解决方案

---

开源信息

项目信息

• 项目名称：今天空白（Today is Blank）

• Bundle Name：com.zq.today_is_blank

• 版本：1.0.0

• 开源协议：MIT License

GitHub 仓库

• 完整源码：GitHub - Today_is_blank

• 前端代码：frontend/ 目录

• 后端代码：backend/ 目录

• 文章源码：每篇文章对应项目中的实际代码

参与贡献

欢迎提交 PR，包括但不限于：

• 代码优化

• 文档改进

• Bug 修复

• 新功能建议

---

最后

这将是一个长达 6 个月的技术旅程。

从今天开始，我将每周更新 1-2 篇文章，带你从零开始，一步一步完成这个应用。

不求快，只求稳。

每一行代码都是真实的，每一个设计都经过思考，每一个决策都有理由。

如果你也想：

• 系统学习 HarmonyOS 6.0 开发

• 了解仓颉语言后端开发

• 建立完整的移动端工程思维

那就从今天开始，跟我一起，把这个应用做出来。

---

下期预告

下一篇：《HarmonyOS 6.0 环境搭建 - DevEco Studio 配置 + 真机调试完整指南》

内容包括：

• DevEco Studio 安装与配置

• HarmonyOS 6.0 SDK 下载

• 签名证书申请（详细步骤）

• 真机调试配置

• 常见问题解决

---

如果这个系列对你有帮助，请点赞、收藏、关注我！

我们下期见！

---

关键词：#HarmonyOS6.0 #鸿蒙开发 #ArkTS #端到端加密 #仓颉语言 #移动开发 #全栈开发 #开源项目 #系列教程

作者：七七 GitHub：zqaini002 项目源码：Today_is_blank 系列目录：README