快速使用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",
  },

　　

• 其中：

一、ConStringEncrypt配置數據庫鏈接字符串是否加密，加密設置爲true，不然設置false

二、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） 若能正確展現登陸頁面，並能成功登陸，菜單及頁面展現正常，則代表環境搭建成功

提示

由於本項目是先後端分離的，因此須要先後端都編譯啓動好，才能進行訪問

#常見問題

一、先後都啓動好了，出現500錯誤，請檢查跨域訪問設置

二、node-sass安裝失敗

Windows 用戶若安裝不成功，很大機率是node-sass安裝失敗。解決node-sass安裝不成功的問題

npm i node-sass --sass_binary_site=https://npm.taobao.org/mirrors/node-sass 

三、啓動後出現如錯誤：Module build failed (from ./node_modules/babel-loader/lib/index.js):

解決方法：進入當前項目目錄 npm install @babel/core @babel/preset-env 命令