序言

对于一名开发者来说，独自开发一款小程序与App，也许总会有一些疑问：

1. 需要掌握哪些技术？

答：java、vue、及常规Linux命令

2. 需要多少成本？

答：服务器购买，云服务器新人50多三年；

域名购买，10块的域名够用，后续每年30左右的续期费用；

短信套餐购买，50块钱，够用很久了；

微信小程序发布，需要300块钱的审核费用；

ios版本的App发布，貌似也要钱。

3.需要多久完成？

答：如果第一次，需完成域名备案、服务器环境搭建、程序基础功能开发等，可能用时较久；

如果第二次，仅仅在第一次的基础加改代码，短时间可以完成就够了。

1.    心得说明

本文基于个人开发和发布《九云题库》H5/微信小程序/APP的经验，分享从零到完成一套完整系统开发、发布的全过程，其中涉及到部署资源的获取，开发过程、部分程序设计思路、注意事项以及最终部署方法等。

1.1     功能说明

1. 实现PC端/H5/App/小程序4端的常规登陆/注册/更新等
2. 实现题目分类和题目的增删改查功能，支持手机端和PC端操作
3. 实现题目收藏/取消收藏，移动端
4. 实现错题记录/移除记录，移动端
5. 实现刷题/看题/搜题功能，移动端
6. 实现题目提问/留言讨论功能，移动端
7. 其它移动端的基础必备功能

1.2     附件截图

以下是App、H5、微信小程序三个移动端的部分截图

2.    实现方案

1.1     资源方案

2.1.1   服务器选择与规划

服务器选择，系统需要有一个承载平台，因此需要一个服务器，购买云服务器centos7系统是一个不错的选择，或者使用其它服务器。

服务器规划，软件和应用尽可能都放在/home路径，方便统一管理，如：/home/app放系统软件

/home/nginx放nginx配置

/home/docker放docker镜像

/home/minio放minio文件

/home/mysql_tump放mysql备份文件

注：软件安装最好修改默认端口，否则服务器容易被攻击。

2.1.2   服务器-jdk环境

将下载好的 jdk-8u211-linux-x64.tar.gz 放在 /home/app 路径

2.1.3   服务器-端口开通

云服务器平台需要开通端口，服务器启用防火墙，开通各个服务的端口，以下是centos7下的防火墙相关操作，同时云服务器平台也需要开通对应的端口

2.1.4     服务器-Nginx

执行命令-增加支持ssl

Nginx配置说明，在/home/app/nginx/conf/nginx.conf的http下增加引用配置，其具体nginx配置只需在引用目录添加即可，方便管理和维护

在引用目录下编写对应各个需求的nginx配置，一个nginx配置写一个文件，cert专门放ssl证书

2.1.5     服务器-gitea

安装源码管理工具，gitea很占用服务器性能资源，也可以使用开源平台

2.1.6   服务器-docker

安装docker并设置远程访问，设置远程访问后，方便idea直接发布后端

2.1.7   服务器-minio

安装成功后，浏览器打开9090端口，创建Minio仓库并设置权限，既可在后端配置使用，此处通过docker安装minio

2.1.8   服务器-redis

最后这步很重要，修改redis端口，个人服务器曾因未修改端口被攻击，修改端口号方式

2.1.9   服务器-mysql8

安装mysql8后，对于每个系统，要使用单独的数据库以及单独的账号，避免某个数据库账号泄露导致所有数据库数据泄露的风险。

备份数据很重要，通过Linux的定时任务crontab，实现数据库每日备份，并删除过期的备份

在scripts中写入备份和删除备份脚本

编辑Linux自带的crontab任务，加入备份和删除备份两个任务

2.1.10   域名选择与规划

小程序只支持https域名式地址，因此必须有一个域名。可在云服务商注册购买域名或其它域名方式，域名需要进行备案。

域名规划，可以解析多个子域名。子域名全部指向服务器IP，具体子域名通过nginx指向不同的端口，负载均衡也由nginx完成，通过不同域名指向不同的领域系统或功能，如：

www.ninecloud.top — 网站首页与静态文件路径

api.ninecloud.top — 接口

fs.ninecloud.top — Nginx文件服务

minio.ninecloud.top — Minio文件服务

git.ninecloud.top — Gitea服务

doc.ninecloud.top —文档服务

每个子域名需要各自申请ssl证书，将证书文件放在服务器并在nginx里配置，即可实现https访问，在云服务商购买的域名都有免费的ssl证书可用。

2.1.11   短信方案

系统存在验证码登录，找回密码等场景，因此有短信发送需求，可购买各服务商平台的短信套餐，接入系统

发送短信需要在服务商的云平台申请签名和模版，各个云平台管理都比较严格，尤其是个人用户，申请签名和模版很难成功，需要耐心。

2.1.12   微信公众平台

微信发布小程序，需要在微信公众平台注册小程序账号，进行一些认证，https地址白名单设置，权限设置等，拿到后续开发需要的AppID，AppSecret等关键数据。

2.1.13   其它小程序平台

尝试成功发布过支付宝小程序，和微信小程序大同小异。

2.1.14   App发布

通过jre生成Android签名证书，然后使用开发工具HbuilderX工具打包成apk文件，放在服务器，用户直接通过浏览器下载即可安装使用。

Window本地生成App证书方式，dos命令进入jre目录

在HbuilderX中，打包app时，需要用到上面的文件，别名，和密码

1.2     代码方案

2.2.1   开发发布说明

工具说明：

后端工具idea 框架若依Plus

前端工具VsCode 框架若依vue3

移动端工具HbuilderX 框架uniapp vue3

微信小程序的devtools

数据库工具dbever

服务器工具Xshell、Xftp

其它工具，接口调试postman，P图工具photoshop，redis客户端等

发布说明：

后端发布，在idea设置docker远程连接，打包jar，以docker命令部署

前端部署，生成静态文件，上传服务器/home/www/msw/目录

移动端H5，生成静态文件，上传服务器/home/www/uquestion目录

移动端App，打包生成Apk后，上传/home/nginx/apk目录，通过系统配置指定路径和版本确定apk地址，App端可自动触发升级，H5端可点击下载

移动端微信小程序，HbuilderX生成小程序项目文件，通过微信小程序工具打开文件上传即可，然后进入微信公众平台，进行审核升级

2.2.2   后端开发-数据库设计

分类表

问题表

评论表

日志表

2.2.3   后端开发-框架基于若依Plus

在若依plus基础上增加ruoyi-question模块，单独存放题库相关功能。

其中四个controller分别是：class-题目分类，option-题目，log-收藏和错题，comment-提问与回复

通过SaToken的SaMode.OR模式，给PC端和手机端都需要的接口增加两个任意满足权限，手机端通用基础权限可固定为app:base:api，用户注册会默认给到相关权限，权限代码例如：

2.2.4   后端开发-登陆/注册机制

登录有两种方式，账号密码登录和手机号验证码登录，个人版的微信小程序只能获取OpenId无法获取手机号，OpenId唯一可用于登录， 但由于多端可注册可登录，避免同一用户出现两个账号，因此小程序放弃OpenId登录，与其它端保持一致。

以下是登陆Body文件， 其中通过登陆类型type来区分两种登陆方式，通过registerFlag来判断手机号验证码登录时，系统没有账号是否自动注册。

2.2.5   后端开发-其它说明

其它还需使用后端的功能有：公告，系统配置，退出登录，更新用户信息或头像，找回密码，发送短信，生成二维码等

2.2.6   前端开发-框架基于若依Vue3

将若依前端代码进行深度改造，样式代码尽可能单独提出来在index.scss引入，统一管理，如表格样式，弹窗样式，树样式等。

好处是尽可能在具体页面不再写css内容，确保整个系统样式统一，便于维护和修改。

表格样式

将函数方法组件分四个引用文件一次性引入，避免在main.js文件内写太多的内容，不利于维护和管理

如框架工具具体情况如下，后续新增公共js方法文件，直接在此文件添加即可；新增单个的方法，直接在对应文件添加方法即可，无需再引用。

2.2.7   前端开发-题目分类管理

题库分类，使用树形结构设计，支持增删改查和复制，以及点击题目数量跳转到对应分类的题目管理页面

分类的编辑

2.2.8   前端开发-题目管理

题目管理，除常规的增删改查外，还有批量删除和复制功能，列表支持单击勾选，表格关键字过滤题目，列显示隐藏等。

编辑功能，选项支持添加与删除，添加时，自动按ABCDE…的顺序排列，删除时重新排列顺序。

2.2.9   移动端开发-框架参考若依App

仅仅是参考若依App移动端，第一是因为若依App是vue2版本，第二是因为若依App很多功能都没有开发，不足以支撑完整功能。

与PC端一样，尽可能把样式文件单独提取出来，避免重复写css，如图片样式，广告样式，列表样式等

由于移动端的样式复杂多变，很难固定统一，所以用基础样式，将常用的样式全部写好，html的class直接用即可。

公共方法的引用，同前端一样，由一个文件引用全部方法，然后在main.js里面引用此文件，方便维护和管理。

组件引用，uniapp组件只需要按规范写在components文件下即可

2.2.10   移动端开发-功能规划

App采用常规设计，有三个导航按钮，分别是首页，题库，我的

首页，最上用滚动banner和动态公告，让系统有一些动感，下方放直通分类的题目。

题库页，使用树形结构展示所有分类和题目，最上方搜索栏可以过滤题目和选择是否有答案的题目。

我的页，常规功能是用户信息，上传图像，邀请好友，设置等，其中系统设置、题库分类、题目管理不在App基础权限内，一般用户未授权前不可见，我的收藏和我的错题记录刷题过程中的操作。

2.2.11   移动端开发-登陆机制

对于移动端，用户登陆后，如果以账号密码方式登陆，则存储用户名密码，同时存储获取到的token等信息，后续登陆同PC前端一样，header中携带token进行访问；

不同之处在于，移动端token过期后，自动触发重登陆机制，用存储中的账号密码自动重新登录，用户是没有任何感觉的，避免每次打开都要重新登陆。同时设置退出和清除缓存功能，让用户可以清除缓存信息。

2.2.12   移动端开发-上传图像

若依App原版上传图像截取，图片是铺满方式，支持有限，个人用不惯。重写图像裁剪组件，经过一番调试后，兼容H5、App和微信小程序。

组件支持左右上下翻转、不同角度的旋转、不同程度的放大缩小，支持预览等。

2.2.13   移动端开发-App更新机制

H5端直接显示最新版本，支持下载App。

App端每次更新一个版本进行打包，将打包的apk文件以版本号命名，上传到文件服务器，准备发布新版本直接就改配置参数为对应版本即可；

用户登陆后获取到最新参数配置，其中有App的版本号，和当前系统版本号比对，如果不一致则提醒用户更新。

以下分别是App-我的页面，App关于页面，H5关于页面情况

2.2.14   移动端开发-分类/题目管理

分类和题目管理，都采用树形结构，移动端录入题目一样支持复制，但如果在手机端操作还是没那么方便，如果是修改或者是新增少量，倒是比较快，如果很多，用电脑以H5地址打开，或者直接在后端管理录入，效果更好

2.2.15   移动端开发-题库刷题

刷题页面支持搜索，搜索后非末级也显示题目数量，并可点击进入搜索内容的全部题目

2.2.16   移动端开发-其它功能

邀请好友，服务器根据用户图像生成二维码，更改二维码样式颜色等。

设置-含公告查看，修改密码，联系我们，清空缓存，关于，退出登录

3.    总结一下

做一套完整的系统，可以完善自己所学的知识，找到自己的弱项，也有一种成就刚。

题库功能还有优化空间，如题库类型需要问答型题目，题目还可以展示做题人数，正确率等信息，评论支持上传图片等。