準備工作
#安裝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中。
#修改接口訪問地址
在目錄中VueUI\src修改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 命令