Vue.NetCore 开发框架使用说明
2025-02-12创建数据库
1. db文件夹下,找到对应数据库脚本并执行(需要提前创建好数据库后再执行脚本)
启动后台
1. 使用VS2022打开后台项目修改appsettings.json中数据库链接串;
2. 打开后台目录.Net6版本,双击dev_run.bat启动 后台启动 默认端口是9991
启动前端
1. 打开目录../Vol.Vue3.vite或Vol.Vue3版本 ,双击install.bat等待安装,安装完成后双击run.bat启动
2. 启动成功后,浏览器输入http://localhost:9990/访问
启动异常排查
后台启动闪退
1. 使用vs2022打开项目,手动生成下解决方案。
2. 使用cmd切换至 /Vol.WebApi目录输入dotnet run查看异常
3. 检查appsettings.json数据库连接配置与DBType属性是否配置正确
前端启动闪退
1. 使用cmd输入node -v检查是否安装nodejs
2. 前端启动异常:
vie版本使用cmd切换至 ../Vol.Vue3.Vite目录下执行npm install
老版本使用cmd切换至 ../Vol.Vue3目录下执行 npm config set strict-ssl false&npm cache clear --force & npm install
3. 如果没有报错,再接着执行 npm run serve 看异常信息
前端登录报错
1. 看不到验证码:检查后台有没有启动
2. 能看到验证码但一直显示登录或者报错,WebApi目录下->Download->Logger看异常信或者将后台错误信息返回(ExceptionHandlerMiddleWare.cs文件中将new { message = "~服务器没有正确处理请求,请稍等再试!", status = false }改为new { message = message, status = false })
代码生成
先在数据库创建表,必须有主键,只能是自增Id或Guid,MySql数据库使用Guid请将字段设置为char长度36位
表最好包括创建(修改)人、时间等字段,在新增或编辑时,框架会自动给这几个字段设置值
字段格式要求参照后台项目appsettings.json中属性CreateMember、ModifyMember的说明
主从(明细)表生成代码需要注意
明细表的外键必须是主表的主键字段,可参照SellOrder的明细表SellOrderList的外建
主从表代码生成步骤都是一样,在生成主表前需要先将从表按现有步骤生成
在主表生成配置页面填上【明细表名】与【明细表中文名】,点击生成vue页面、model、业务类即可完成主从页面代码的生成
代码生成器中可以不用生成从表vue页面
1、创建mysql表,只有字段类型是guid时设置成char(36),其他字段的长度都不要设置成长度36,否则会替换成guid类型
2、数据库字段不要设置类型bit(bool),请用int或byte替代
后台请运行 ../VOL.WebApi/builder_run.bat命令,如果不需要生成业务类运行dev_run.bat即可(第一次生成某张表代码时候才需要运行builder_run.bat)
项目发布
发布后台
1、直接右击发布(发布方法,选文件系统即可)
2、将发布的文件全部放到iis目录下
3、浏览器打开后台的部署地址,能显示swagger界面就说明部署成功了(出现异常请看下面的[发布后访问报错])
部署IIS上需要安装Runtime(linux上也需要),否则站点打不开 点击下载6.0 hosting 点击下载3.1.8 hosting ,下载安装完成后重启IIS,或者使用cmd输入iisreset重启
发布前端
1、修改src\api\http.js文件,修改process.env.NODE_ENV 配置:axios.defaults.baseURL ='部署的后台地址',如:http://132.232.2.109:9991/
2、执行前端发布:../vol.vue/目录下双击build.bat运行,发布完成后的项目在dist文件夹里
发布后访问报错
1、确认后台部署的站点能不能打开
2、确认后台appsettings.json中是否配置跨域。(修改配置后,重启下后台项目)
3、在部署的后台项目文件夹下,修改web.config属性stdoutLogEnabled="true",当前目录下新建一个空文件夹logs,再直接访问后台接口,查看logs日志
4、如果logs文件夹下没有日志,查数据库sys_log表或Logger\Queue\路径下日志
5、linux下发布.netcore需要安装libgdiplus插件
前端刷新页面404报错
1、修改前端route文件夹下index.js文件,将 mode: 'history'改为 history: true
前后台发布在一起
将前端发布后的dist文件里面的内容(只要复制dist里面的内容)直接放到wwwroot文件下即可(前端http.js里面的axios.defaults.baseURL值改为空)
//axios.defaults.baseURL = '';
注意:如果是vue3版本请将Startup.cs中的app.UseDefaultFiles();注释掉 这个测试不去也行
项目更新
直接覆盖文件:后台VOL.Core类库、VOL.Builder类库,前端:components->basic、builder文件夹,common.js
注意:在没有修改过上面的文件才能直接覆盖,如果有修改请对比文件差异
其他文件更新:后台:VOL.System类库,Template文件夹;前端:main.js、views->index.vue、login.vue、router文件夹,根据需要更新,不更新也没影响
参考文档
https://gitee.com/x_discoverer/Vue.NetCore
http://v2.volcore.xyz/document/
http://v3.volcore.xyz/