快速使用YuebonCore

準備工作

#安裝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 命令