应用下载地址：
https://appgallery.huawei.com/app/detail?id=com.liuhaikang.poetry
应用截图：
介绍
古诗书院是一款学习古诗词的应用，包括唐诗三百首、宋词三百首、水墨唐诗等众多诗词。 主要功能
一、学习诗词 不同的朝代和内容分类，都有对应诗词 查看详情：部分诗词包含原文、拼音和翻译 快速搜索：按标题、作者或内容查找
二、收藏与记录 收藏喜欢的诗词，方便随时查看 标记已背诵的诗词，记录学习进度 查看最近背诵记录，了解学习情况
三、朗读功能 点击朗读，听诗词发音 帮助理解诗词韵律
四、学习统计 查看使用天数 查看已背诵的诗词数量 查看学习进度
五、个性化设置 选择喜欢的字体 设置是否开启振动触感 设置是否开启点击音效
六、适用人群 适合诗词爱好者，帮助赏析诗词。
技术架构
开发框架
-
语言: ArkTS (TypeScript的超集)
-
UI框架: ArkUI声明式开发范式
-
状态管理: AppStorage + @State/@StorageLink
-
数据存储: AppStorage + PersistentStorage
核心模块
- 数据管理
应用采用模块化的数据结构，将诗词数据按分类组织：
-
小学1-6年级教材诗词（12个分类）
-
经典诗词（唐诗三百首、宋词、楚辞等）
-
蒙学经典（三字经、弟子规、百家姓等）
所有数据通过 `PoetryUtils.ts` 统一管理，提供按ID、分类、关键词搜索等功能。
- 字体管理
实现了自定义字体管理器 `FontManager`，支持：
-
系统字体和自定义字体动态加载
-
字体注册和生命周期管理
-
支持宋体、楷体等多种字体切换
```typescript
// 字体加载示例
await fontManager.loadFont('song');
const fontFamily = fontManager.getFontFamilies('song');
```
- 音频服务
基于 `@ohos.multimedia.media` 实现了完整的音频播放服务：
-
背景音乐：使用AVPlayer实现循环播放，支持播放状态管理
-
音效播放：点击音效、成功/错误提示音
-
TTS朗读：集成系统TTS引擎，支持诗词语音朗读
音频服务采用单例模式，确保全局唯一实例，并通过状态回调机制管理播放生命周期。
- 本地存储
使用 `StorageService` 封装了所有存储操作：
-
背诵记录: 使用Set存储已背诵诗词ID，支持时间戳记录
-
收藏功能: 独立的收藏Set管理
-
学习记录: 练习记录、接龙记录等历史数据
-
用户设置: 字体、音效、振动等偏好设置
- 拼音对齐算法
实现了智能的拼音与汉字对齐算法，核心逻辑：
-
按标点符号（，。？！；）分割诗句
-
提取每个片段对应的拼音
-
将拼音与汉字逐字对齐，处理标点符号
```typescript
// 拼音对齐核心方法
alignPinyinWithCharacters(line: string, pinyinLine: string): ProcessedCharacter[]
```
技术亮点
- 响应式设计
通过 `ResponsiveFont` 工具类实现自适应布局：
-
根据屏幕宽度动态调整字体大小
-
平板设备优化显示效果
-
支持多设备适配
- 动画系统
使用ArkUI的 `animateTo` API实现丰富的动画效果：
-
图标跳动动画（首页功能按钮）
-
音乐按钮旋转动画（随播放状态）
-
页面切换过渡动画
- 状态同步
通过 `@StorageLink` 实现跨组件状态同步：
-
背诵状态全局同步
-
字体设置实时生效
-
收藏状态即时更新
- 性能优化
-
**懒加载**: 字体按需加载，减少启动时间
-
**数据缓存**: 诗词列表在内存中缓存
-
**资源管理**: 音频播放器及时释放，避免内存泄漏
开发经验总结
- 模块化设计
将功能拆分为独立的服务类（AudioService、StorageService、FontManager），便于维护和测试。
- 类型安全
充分利用TypeScript的类型系统，定义清晰的接口（Poetry、ProcessedLine等），减少运行时错误。
- 用户体验
-
点击反馈：触觉振动 + 音效
-
加载状态：优雅的加载动画
-
错误处理：友好的错误提示
- 代码规范
-
统一的命名规范
-
完善的注释说明
-
清晰的代码结构
未来优化方向
-
数据云端同步: 支持多设备数据同步
-
AI功能: 智能推荐、个性化学习路径
-
社交功能: 学习打卡、排行榜
-
离线语音识别: 支持语音背诵检测
总结
这个项目展示了HarmonyOS应用开发的完整流程，从数据管理、UI设计到多媒体处理，涵盖了现代移动应用开发的核心技术点。通过合理的架构设计和模块化开发，实现了功能丰富、性能优良的诗词学习应用。
技术栈: HarmonyOS + ArkTS + ArkUI
开发工具: DevEco Studio
项目规模: 约5000+行代码，包含70+个诗词数据文件