# uniapp仿真翻页小说阅读器

**Repository Path**: qx-team/novel-reader

## Basic Information

- **Project Name**: uniapp仿真翻页小说阅读器
- **Description**: novel-reader 是一个款支持仿真等多种翻页方式的小说阅读器。包括小说推荐、作品检索、小说排行、小说阅读等功能，支持自定义多背景、阅读主题切换、等，基于uniapp开发，能够直接生成IOS和Android两种格式安装包，一套代码两种体验，内置集成数据库，轻松实现小说本地存储！
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-09-03
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

[![uni-app](https://img.shields.io/badge/Framework-uni--app-brightgreen.svg)](https://uniapp.dcloud.io/)
[![Platform](https://img.shields.io/badge/Platform-iOS%20%7C%20Android-blue.svg)](#)
![MiniProgram](https://img.shields.io/badge/MiniProgram-Not%20Supported-lightgrey.svg)

**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](https://uniapp.dcloud.io/) (Vue.js)
- **语言**: Vue.js, JavaScript
- **本地数据库**: SQLite实现本地化缓存
- **原生渲染**: 使用 `uni-app` 原生渲染模式，保障 iOS 和 Android 端的性能与体验，支持两端同时打包。
- **后端框架**: SpringBoot + Mysql + Redis + nginx 

## 支持平台

本项目目前专注于原生移动端体验。
- ✅ **iOS** (通过云打包或本地打包生成 ipa 文件)
- ✅ **Android** (通过云打包或本地打包生成 apk 文件)
- ❌ 微信小程序/其他小程序/PC/WEB (暂不支持)
- iOS原生源码地址：[Objective-C](https://gitee.com/qx-team/ios-novel-reader-oc.git)

## 安装与使用

1.  **克隆项目**
    ```bash
    git clone https://gitee.com/qx-team/novel-reader.git
    cd novel-reader
    ```
2.  **安装依赖**
    ```bash
    npm install
    ```

3.  **运行开发**
    -   使用 **HBuilderX** 导入项目，选择“运行到手机或模拟器”。
    -   或使用命令行：
        ```bash
        # 运行到浏览器
        npm run dev:h5
        # 运行到 Android App (需配置模拟器或真机)
        npm run dev:app-plus
        ```

4.  **构建发行版**
    -   在 `HBuilderX` 中，选择 **发行** -> **原生App-云打包**。
    -   或修改 `manifest.json` 后使用命令行生成打包资源：
        ```bash
        npm run build:app-plus
        ```
        （之后需在 HBuilderX 中继续完成云打包或本地打包操作）。
5. 	**关键组件**
	- [好用翻页插件](https://ext.dcloud.net.cn/plugin?id=13712)
	- uView UI[官方文档：https://uviewui.com](https://uviewui.com)

5. 	**常见问题**
	- [如遇到，初始进来图标没加载的问题，请参照此处理](https://blog.csdn.net/m0_59415345/article/details/140495319)

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

## 功能展示
 -   书桌：
![](README_files/1.png)
 -   书本详情：
![](README_files/2.png)
 -  阅读设置 ：
![](README_files/3.png)
 -  书本目录 ：
![](README_files/4.png)
 -  仿真翻页 ：
![](README_files/5.png)
 -  覆盖翻页：
![](README_files/6.png)
 -  上下滚动翻页 ：
![](README_files/7.png)
 -  皮肤：
![](README_files/8.png)
 -  我的：
![](README_files/8.png)
## 联系我们

添加WX：QxWx_001 
QQ群：530532516
## API体验接口：
添加作者微信/QQ，备注：小说后台体验，获得相应后台体验地址！

## 捐赠novel-reader的研发
novel-reader系统uniapp和框架源码全部开源免费，如果您认为novel-reader帮到了您的开发工作，您可以捐赠novel-reader的研发工作，捐赠无门槛，哪怕是一杯可乐也好(相信这比打赏主播更有意义)。

![](README_files/9.png)

## 许可证

本项目采用 [MIT](LICENSE) 许可证。

## 免责声明

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


**享受纯粹的阅读时光吧！**