第五款 HarmonyOS 上架作品 奇趣故事匣 来了

第五款 HarmonyOS 上架作品 奇趣故事匣 来了

前言

北京时间 2025 年 7 月 4 日 ，青蓝逐码组织第五款鸿蒙元服务 奇趣故事匣 也发布上架了，奇趣故事匣 是一个奇幻故事类的应用，目前包含的核心功能有 奇趣故事分类、浏览、语音播报，还包括有华为静默登录，它也是我们青蓝逐码组织的一个小伙伴独立开发前端+后端的作品，耗时一个多月的业余时间完成🎉。

效果一览

开发故事

这次作品是一个小伙伴独立完成开发并且上架的，作战能力很强，这里我们可以分享下他开发的历程故事。

建立作品选型

我们在立项前也会简单的做个技术沟通，确保目标和方向是正确并且可行的。

技术方案讨论

如果小伙伴不懂后端，但是执行力强，还可以推荐具体的技术，如端云

程序员的思维 - 记账类 APP

传统的记账类太多，很容易引起生理反感

接入了华为的 AI 朗读

在商讨后期接入大模型，可以让用户自己 AI 创作故事

思想的碰撞会指引出具体的行动方向

头脑乱掉了，简单的业务给限制住了

实践得真知

开发日志

独立开发就是快，自己一个人噌噌噌的写和改。

上架历程

从提测到真正真正上架，也花了有差不多小半个月时间了

技术说明文档

项目概述

奇趣故事匣是一款基于 HarmonyOS 开发的故事阅读应用，采用原子化服务(Atomic Service)架构。应用提供故事浏览、分类查看、在线阅读、收藏管理、阅读历史等功能，支持华为账号授权登录。

基本信息

• 应用名称: 奇趣故事匣

• 应用类型: 原子化服务 (atomicService)

• 版本: 1.0.0 (versionCode: 1000000)

• 兼容 SDK 版本: 5.0.4(16)

• 运行系统: HarmonyOS

技术架构

开发框架

• 开发语言: ArkTS (TypeScript 扩展)

• UI 框架: ArkUI

• 架构模式: Stage 模型

• 组件化: ComponentV2 + @Local 状态管理

• 数据持久化: PersistenceV2

• 导航: Navigation + NavPathStack

项目结构

FunStoryBox/
├── AppScope/                    ## 应用级配置
│   ├── app.json5               ## 应用配置文件
│   └── resources/              ## 应用级资源
├── entry/                      ## 主模块
│   ├── src/main/
│   │   ├── ets/                ## TypeScript源码
│   │   │   ├── components/     ## 可复用组件
│   │   │   ├── constants/      ## 常量定义
│   │   │   ├── entryability/   ## 应用入口
│   │   │   ├── models/         ## 数据模型
│   │   │   ├── pages/          ## 页面组件
│   │   │   └── utils/          ## 工具类
│   │   ├── module.json5        ## 模块配置
│   │   └── resources/          ## 资源文件
│   └── build-profile.json5     ## 构建配置
├── config/                     ## 签名证书配置
└── build-profile.json5         ## 项目构建配置

核心功能模块

1. 用户认证模块

• 华为账号授权登录: 集成华为账号 Kit，支持 OAuth2.0 授权流程

• 自动登录: 应用前台时自动检测登录状态

• 用户信息管理: 持久化存储用户基本信息

2. 故事内容模块

• 故事浏览: 支持分类浏览、热门推荐、最新更新

• 故事详情: 展示故事基本信息、章节列表、相关推荐

• 在线阅读: 章节内容阅读，支持阅读进度记录

• 搜索功能: 故事标题和内容搜索

3. 个人中心模块

• 阅读历史: 记录和管理用户阅读记录

• 收藏管理: 故事收藏和取消收藏

• 个人信息: 用户资料展示和管理

4. 数据管理模块

• 网络请求: 封装 HTTP 工具类，支持 GET/POST/DELETE 请求

• 数据模型: 定义完整的业务数据结构

• 状态管理: 使用 @Local 和 PersistenceV2 管理应用状态

主要页面说明

页面路由配置

应用使用 Navigation 组件进行页面管理，路由配置如下：

页面名称

文件路径

功能描述

Layout

pages/Layout.ets

主布局页面，包含底部导航

StoryDetail

pages/StoryDetail.ets

故事详情页面

ReadStory

pages/ReadStory.ets

故事阅读页面

RecommendList

pages/RecommendList.ets

推荐列表页面

CategoryDetail

pages/CategoryDetail.ets

分类详情页面

SearchStory

pages/SearchStory.ets

故事搜索页面

AuthorDetail

pages/AuthorDetail.ets

作者详情页面

ReadHistory

pages/ReadHistory.ets

阅读历史页面

FavoriteStory

pages/FavoriteStory.ets

收藏故事页面

核心页面架构

1. 主布局页面 (Layout.ets)

• 底部 Tab 导航，包含：首页、发现、我的

• 使用 Tabs 组件实现页面切换

• 集成用户信息状态管理

2. 首页 (Home.ets)

• 分类统计展示

• 热门故事推荐

• 最新故事列表

• 最近阅读记录

• 下拉刷新功能

3. 发现页面 (Discover.ets)

• 故事分类浏览

• 推荐内容展示

4. 个人中心 (Mine.ets)

• 用户信息展示

• 阅读历史入口

• 收藏管理入口

技术特性

1. 组件化开发

• 可复用组件: PageHeader、SectionTitle、StoryCard、StoryList

• 组件通信: 使用 @Local 装饰器实现组件间状态共享

• 生命周期管理: 合理使用 aboutToAppear 等生命周期方法

2. 状态管理

• 全局状态: 使用 AppStorageV2 管理导航栈

• 持久化状态: 使用 PersistenceV2 存储用户信息

• 响应式更新: @Monitor 装饰器监听状态变化

3. 网络通信

• HTTP 封装: 统一的网络请求工具类

• 错误处理: 完善的网络错误处理机制

• 数据格式: 支持 JSON 和 form-urlencoded 格式

4. 安全特性

• 应用签名: 配置开发和发布环境的签名证书

• 权限管理: 申请网络访问权限

• 数据加密: 集成 RSA 加密工具

API 接口设计

基础配置

• 服务器地址: https://ad.qqgsj.lzzvx.com
  

• 超时时间: 60 秒

• 请求格式: JSON / form-urlencoded

主要接口

接口类型

接口路径

功能描述

GET

/api/category/totalStoriesCount

获取分类故事统计

GET

/api/story/hot

获取热门故事

GET

/api/story/latest

获取最新故事

GET

/api/story/search

故事搜索

POST

/api/user/authorizeLogin

华为账号授权登录

GET

/api/user/read/history/latest

获取最近阅读记录

POST

/api/favorite/add

添加收藏

DELETE

/api/favorite

取消收藏

数据模型

核心实体

用户模型 (User)

故事模型 (Story)

章节模型 (Chapter)

总结

目前我们上架的作品也已经达到了五个。

关于青蓝逐码组织

如果你兴趣想要了解更多的鸿蒙应用开发细节和最新资讯，甚至你想要做出一款属于自己的应用！欢迎在评论区留言或者私信或者看我个人信息，可以加入技术交流群。