# dt-read

**Repository Path**: fredCoding_zh/dt-read

## Basic Information

- **Project Name**: dt-read
- **Description**: DT阅读  免费无广告小说阅读微信小程序
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 64
- **Created**: 2020-05-19
- **Last Updated**: 2021-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DT-READ

![logo](/public/logo/logo.png "logo")

使用通用 APP 框架[uni-app](https://uniapp.dcloud.io/)，利用[Thor-ui](https://github.com/dingyong0214/ThorUI-uniapp)，搭建的微信小程序。

后台使用的是微信小程序自带的云开发。
云开发数据库中的数据源解析方式导出文件路径`/src/static/database_export.json`。云函数路径在`/cloudfunctions`。

> 所需数据库如下图所示：
> ![云开发数据库](/public/interface/云开发数据库.png "云开发数据库")
> 管理员标志在数据库`config`中的`admin=true`字段。

通过解析小说网站结构，相关的数据显示在微信小程序。

可以动态在数据库添加小说网站的解析，解析是动态的。只要在数据库里添加数据源的解析，即可在小程序中正常使用该数据源。不需要额外写代码。

> 已有的小说源：

- [笔趣阁儿](http://www.biquger.com)
- [小说族](http://www.xiaoshuozu.com)
- [天籁小说网](https://www.23txt.com)
- ~~[笔趣阁备用站](https://www.biquge.cc)~~
- ~~[全本小说网](https://www.qb5200.tw)~~
- [小说书网](https://www.xiaoshuo530.com)
- [斗破苍穹小说网](https://dpcq1.com)

## 部分界面如下图所示

<div style="display:flex;flex-wrap:wrap;">
<img width="280" src="/public/interface/主界面-我的书架.jpg" alt="主界面-我的书架" title="主界面-我的书架">
<img width="280" src="/public/interface/搜索书籍.jpg" alt="搜索书籍" title="搜索书籍" />
<img width="280" src="/public/interface/阅读界面-菜单.jpg" alt="阅读界面-菜单" title="阅读界面-菜单" />
<img width="280" src="/public/interface/个人中心.jpg" alt="个人中心" title="个人中心" />
<img width="280" src="/public/interface/设置界面.jpg" alt="设置界面" title="设置界面" />
</div>

## 安装依赖

```shell
yarn install
```

### 开发环境运行

```bash
yarn dev:mp-weixin
```

如果需要本地调试小程序云函数，则可以运行`sh function.sh dev`，可以一次性把云函数复制到指定的目录

然后用微信开发者工具导入小程序，目录在`/dist/dev/mp-weixin/`

### 生产环境运行

```shell
yarn build:mp-weixin
```

如果需要本地调试小程序云函数，则可以运行`sh function.sh build`，可以一次性把云函数复制到指定的目录

然后用微信开发者工具导入小程序，目录在`/dist/build/mp-weixin/`

## 怎么发布自己的小程序？

> 使用的工具如果没有安装，请自行百度安装

1. **下载代码到本地**
   ```shell
   # 默认已安装Git工具
   git clone git@gitee.com:wtto00/dt-read.git
   ```
1. **安装依赖**
   ```shell
   # 默认已安装nodejs环境，且已安装yarn工具
   cd dt-read
   yarn
   ```
1. **申请一个小程序**  
   已有小程序的，可以省略此步骤  
   [腾讯官网申请注册一个小程序](https://mp.weixin.qq.com/wxopen/waregister?action=step1&token=&lang=zh_CN)
1. **修改 appid**  
   到[小程序后台](https://mp.weixin.qq.com/wxamp/devprofile/get_profile?token=930514308&lang=zh_CN)，依次点击 `开发`>`开发设置`，可以看到自己小程序的`AppID(小程序ID)`，复制此字符串，打开代码文件`/src/manifest.json`，找到内容`"mp-weixin":{"appid":"wx58311362dbfc378d"}`，把自己小程序的 appid 覆盖此处的 appid。
1. **安装打开微信开发者工具**  
   已安装的可忽略  
   到[腾讯官网下载开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)，安装完成后，打开
1. **生成小程序发布包**
   ```
   yarn build:mp-weixin
   ```
1. **复制小程序云函数**
   ```shell
   # windows系统cmd以及powershell不识别命令，可以使用git bash
   sh function.sh build
   ```
1. **开发者工具导入小程序**  
   打开微信开发者工具，点击`小程序-导入项目`，点击`目录`，选择目录`/dist/build/mp-weixin`，然后点击右下角`导入`按钮
1. **小程序云开发数据库**
   微信开发者工具导入项目后，点击微信开发者工具上面的`云开发`按钮，首次进入需要申请一个免费的空间即可，然后点击`云开发控制台`窗口上方的`数据库`按钮，点击左侧上方`集合名称`旁边的`+`按钮添加集合。集合名称依次按照顶部截图中的创建。创建 7 个集合后，点击集合`book_sources`，然后点击右侧的导入，选择文件`/src/static/database_export.json`
1. **云函数绑定空间**  
   在微信开发者工具编辑器左侧的资源管理器中，右键目录`cloudfunctions`，选择当前环境为自己申请的免费空间。之后可以会有上传云函数一类的操作。
1. **测试**  
   你现在可以在微信开发者工具左侧的预览模式中体验一下，是否可以正常工作了
1. **发布**  
   点击微信开发者工具上方的按钮`上传`，就可以发布一个体验版本了。版本管理可以在小程序后台-管理-版本管理，中查看。