更新记录

1.0.1（2025-10-10） 下载此版本

1.增加系统整体国际化设置 2.优化页面布局，增加页面部分动态效果 3.修改已知的部分bug

1.0.0（2025-09-18） 下载此版本

1.小说阅读APP（成品发布） 2.修改完善已知的bug 3.功能特性 1).仿真翻页动画: 提供多种翻页模式，包括仿真、平移、滚动、覆盖，带来真实翻书的触感。 2).智能分类: 支持对书籍进行分类和编排榜单等。 3).个性化设置: 高度自定义文字间距、段落间距、首行缩进、背景图片及字体（支持系统字体与导入字体）。 4).护眼模式: 提供舒适的日间与夜间阅读主题，保护用户视力。

平台兼容性

uni-app(3.6.15)

uni-app x

novel-reader - 仿真翻页小说阅读器

novel-reader 是一款基于 uni-app 框架开发的跨平台移动端小说阅读应用。它专注于为用户提供沉浸式、高度自定义且护眼的阅读体验，完美复现了真实纸张的翻页效果,同时提供了覆盖、上下滑动等不同的阅读模式，给用户带来多元化的阅读感受。

代码结构

本项目采用模块化架构设计，遵循 uni-app 的标准项目结构，同时根据小说阅读器的特定需求进行了优化。以下是项目的主要代码结构：

├── api/                 # API接口定义文件
│   └── api.js           # 封装所有后端API接口
├── common/              # 公共工具和配置
│   ├── js/              # JavaScript工具函数
│   ├── request/         # 网络请求相关配置
│   └── sqlite.js        # SQLite数据库操作
├── components/          # 自定义组件
│   ├── cz-nav/          # 导航组件
│   ├── lb-tabbar/       # 标签栏组件
│   ├── uview-v1/        # UI组件库
│   └── ...              # 其他功能组件
├── libs/                # 第三方库和工具
│   ├── config/          # 全局配置文件
│   ├── css/             # 样式文件
│   ├── function/        # 功能函数
│   ├── mixin/           # Vue混入
│   ├── request/         # 请求封装
│   └── store/           # 状态管理
├── pages/               # 应用页面
│   ├── baseBusiness/    # 基础业务页面
│   │   ├── home/        # 首页
│   │   ├── mine/        # 我的页面
│   │   ├── readDesk/    # 书桌
│   │   └── ...          # 其他业务页面
│   ├── login/           # 登录相关页面
│   └── mainTab/         # 主标签页
├── static/              # 静态资源
│   ├── home/            # 首页相关资源
│   ├── iconfont/        # 图标字体
│   ├── images/          # 图片资源
│   └── tabBar/          # 标签栏图标
├── App.vue              # 应用根组件
├── index.html           # HTML入口文件
├── main.js              # 应用入口文件
├── manifest.json        # 应用配置清单
├── package.json         # 项目依赖配置
├── pages.json           # 页面路由配置
└── uni.scss             # uni-app全局样式

核心文件说明

• App.vue: 应用的根组件，包含全局生命周期钩子和应用级配置
• main.js: 应用入口文件，初始化Vue实例、导入插件和全局配置
• pages.json: 定义页面路由、导航栏样式和全局配置
• manifest.json: 应用配置清单，包含应用名称、图标、权限等信息
• api/api.js: 封装所有与后端交互的API接口
• common/request/request.js: 网络请求的封装，统一处理请求和响应

注意事项

• 该系统目前只能真机运行，内置SQlite本地化数据库和调用系统部分功能，网页版本运行，会包数据库错误，在使用时，在运行项目时注意，如PC运行，自行去除相应模块即可！
• 报错如： {message: "plus is not defined"}

主要模块

1. 核心阅读模块

   • 实现仿真翻页、平移、滚动、覆盖等多种翻页模式
   • 支持个性化阅读设置（字体、背景、间距等）
   • 提供不同阅读背景切换

2. 书城模块

   • 分类浏览小说
   • 排行榜展示
   • 搜索功能

3. 书架模块

   • 书籍阅读管理
   • 进度自动保存

4. 用户模块

   • 个人信息管理
   • 阅读历史记录

功能特性

• 仿真翻页动画: 提供多种翻页模式，包括仿真、平移、滚动、覆盖，带来真实翻书的触感。
• 智能分类: 支持对书籍进行分类和编排榜单等。
• 个性化设置: 高度自定义文字间距、段落间距、首行缩进、背景图片及字体（支持系统字体与导入字体）。
• 护眼模式: 提供多种模式的阅读主题，保护用户视力。

技术栈

• 开发框架: uni-app (Vue.js)
• 语言: Vue.js, JavaScript
• 本地数据库: SQLite实现本地化缓存
• 原生渲染: 使用 uni-app 原生渲染模式，保障 iOS 和 Android 端的性能与体验，支持两端同时打包。
• 后端框架: SpringBoot + Mysql + Redis + nginx

支持平台

本项目目前专注于原生移动端体验。

• ✅ iOS (通过云打包或本地打包生成 ipa 文件)
• ✅ Android (通过云打包或本地打包生成 apk 文件)
• ❌ 微信小程序/其他小程序/PC/WEB (暂不支持)
• iOS原生源码地址：Objective-C

安装与使用

1. 克隆项目

   git clone https://gitee.com/qx-team/novel-reader.git
   cd novel-reader

2. 安装依赖

   npm install

3. 运行开发

   • 使用 HBuilderX 导入项目，选择“运行到手机或模拟器”。
   • 或使用命令行：

     # 运行到浏览器
     npm run dev:h5
     # 运行到 Android App (需配置模拟器或真机)
     npm run dev:app-plus

4. 构建发行版

   • 在 HBuilderX 中，选择 发行 -> 原生App-云打包。
   • 或修改 manifest.json 后使用命令行生成打包资源：

     npm run build:app-plus

     （之后需在 HBuilderX 中继续完成云打包或本地打包操作）。

5. 关键组件

   • 好用翻页插件
   • uView UI官方文档：https://uviewui.com

6. 常见问题

   • 如遇到，初始进来图标没加载的问题，请参照此处理

后台管理

• 分类管理: 新增、修改、删除小说分类，配置分类方向、排序、图片等。
• 作者管理：维护作者名称、描述、图片等信息，自动记录操作时间与人员。
• 排行榜管理：搭建畅销榜、新作榜等各类榜单，设置性别、排序等属性。
• 榜单调控: 通过开关灵活设置小说在各榜单的展示状态。
• 推荐运营：按性别、小说编号等筛选推荐小说，自定义排序、图片、外链等。
• 快速链接: https://gitee.com/qx-team/novel-admin-java.git

功能展示

• 书桌：
• 书本详情：
• 阅读设置 ：
• 书本目录 ：
• 仿真翻页 ：
• 覆盖翻页：
• 上下滚动翻页 ：
• 皮肤：
• 我的：

许可证

本项目采用 MIT 许可证。

免责声明

1.本项目提供的源代码仅用学习与交流。 2.用户使用本系统从事任何违法违规的事情，一切后果由用户自行承担作者不承担任何法律责任。 3.应用内阅读的文档均由用户自行导入，请确保您阅读的内容遵循其相关的版权法规。开发者不承担任何因使用本应用而产生的版权责任。如有侵犯权利，请联系作者删除。 4.下载本站源码则代表你同意上述的免责声明协议。

享受纯粹的阅读时光吧！