- A+
准备工作
#安装sdk
下载安装微软官方SDK 3.1最新版,代码地址:https://dotnet.microsoft.com/download
本地安装 node 和 git。NodeJS 是必须的,可在如下地址获得 NodeJS 的安装包:https://nodejs.org/en/ ,也可以到qq群90311523获取下载,
如果需用Redis,请安装Redis并启动,下载地址:https://github.com/MicrosoftArchive/redis/releases; 如果不用redis缓存可以将UseRedis设置为false。
提示
前端安装完node后,最好设置下淘宝的镜像源,不建议使用cnpm(可能会出现奇怪的问题)
npm config set registry https://registry.npm.taobao.org
#下载代码
使用git工具下载代码,代码地址:https://gitee.com/yuebon/YuebonNetCore.git
#初始化数据库
目前支持数据库有:
- Microsift SqlServer 2012+
- MySql 5.7+
使用数据库脚本mssql vue版本
或mssql mvc版本
或mysql初始化脚本
文件夹里面的结构脚本和数据脚本初始化数据库
提示
各数据库表结构一样,初始化数据存在差异,vue版和mvc版主要是功能菜单模块数据差异。
#后台运行
使用Visual Studio 2019或Rider打开 YuebonNetCore.sln
#修改连接字符串
- 修改Yuebon.WebApp/appsettings.json连接字符串,如下:
"ConnectionStrings": { "MySql": "server=localhost;port=3306;database=jcrm;user=root;CharSet=utf8;password=root;", "MsSqlServer": "Server=192.168.1.105;Database=YuebonFW;User id=sa; password=Yuebon!23;MultipleActiveResultSets=True;", "MsSqlServerCode": "Server=192.168.1.105;Database=YuebonFW;User id=sa; password=Yuebon!23;MultipleActiveResultSets=True;" }, "AppSetting": { "SoftName": "YueBonCore Framework", "CertificatedCompany": "Yuebon", "ConStringEncrypt": "false",//连接字符串是否加密 "DefaultDataBase": "MsSqlServer",//默认数据库连接 },
- 修改Yuebon.WebApi/appsettings.json连接字符串,如下:
"ConnectionStrings": { "MySql": "server=localhost;port=3306;database=jcrm;user=root;CharSet=utf8;password=root;", "MsSqlServer": "Server=192.168.1.105;Database=YuebonFW;User id=sa; password=Yuebon!23;MultipleActiveResultSets=True;", "MsSqlServerCode": "Server=192.168.1.105;Database=YuebonFW;User id=sa; password=Yuebon!23;MultipleActiveResultSets=True;" }, "AppSetting": { "SoftName": "YueBonCore Framework", "CertificatedCompany": "Yuebon", "ConStringEncrypt": "false", "DefaultDataBase": "MsSqlServer", },
- 其中:
1、ConStringEncrypt配置数据库连接字符串是否加密,加密设置为true,否则设置false
2、DefaultDataBase设置默认数据库连接
#编译运行
使用visualstudio生成解决方案。 注:首次启动时,visual studio会启动nuget还原第三方依赖包,请保持网络通畅,并等待一段时间
启动Yuebon.WebApi项目。
#前端运行
项目采用vue家族技术作为前端,在项目目录VueUI中。
#修改接口访问地址
在目录中VueUIsrc修改setting.js文件中接口访问地址,将地址改为webapi项目启动访问地址
apiHostUrl: 'http://localhost:54678/api/', // 基础接口 apiSecurityUrl: 'http://localhost:54678/api/Security/', // 权限管理系统接口 fileUrl: 'http://localhost:54678/', // 文件访问路径 fileUploadUrl: 'http://localhost:54678/api/Files/Upload'// 文件上传路径
#编译运行
#进入目录 cd VueUI # 安装依赖 npm install # 强烈建议不要用直接使用 cnpm 安装,会有各种诡异的 bug,可以通过重新指定 registry 来解决 npm 安装速度慢的问题。 npm install --registry=https://registry.npm.taobao.org # 本地开发 启动项目 npm run dev
打开浏览器,输入:http://localhost:8085 (默认账户 admin/admin123) 若能正确展示登录页面,并能成功登录,菜单及页面展示正常,则表明环境搭建成功
提示
因为本项目是前后端分离的,所以需要前后端都编译启动好,才能进行访问
#常见问题
1、前后都启动好了,出现500错误,请检查跨域访问设置
2、node-sass安装失败
Windows 用户若安装不成功,很大概率是node-sass安装失败。解决node-sass安装不成功的问题
npm i node-sass --sass_binary_site=https://npm.taobao.org/mirrors/node-sass
3、启动后出现如错误:Module build failed (from ./node_modules/babel-loader/lib/index.js):
解决方法:进入当前项目目录 npm install @babel/core @babel/preset-env 命令