OsharpNS輕量級.net core快速開發框架簡明入門教程

OsharpNS官方資源
專案地址：https://github.com/i66soft/osharp-ns20
演示地址：https://www.osharp.org 直接使用QQ登入可以檢視效果
檔案地址：https://docs.osharp.org 正在完善中….
釋出部落格：https://www.cnblogs.com/guomingfeng/p/osharpns-publish.html 大神看這個檔案應該就能跑起來，從零開始啟動Osharp基於此檔案完成
VS生成器外掛：https://marketplace.visualstudio.com/items?itemName=LiuliuSoft.osharp
官方交流QQ群：85895249

OsharpNS所需的基礎環境

1.OSharpNS始終緊隨微軟的步伐，使用最新版本的 dotnetcore，請前往Download .NET (Linux, macOS, and Windows),”Download .NET (Linux, macOS, and Windows”)點選Download .NET Core SDK下載並安裝最新版本的dotnetcore
2.下載並安裝.net core開發環境（本人使用VS2017/VS2019作為作為OsharpNS的開發環境,歡迎高手提供VS Code開發和除錯.net core程式的方法,這環境太龐大）
3.下載並安裝Angular6的前端開發環境（本人使用VS Code）

在正式開始之前，先看看最終能看到的效果

使用OsharpNS專案模板建立專案

1.在任意空白目錄，開啟cmd或者powershell命令列視窗

1. 執行命令dotnet new -i OSharpNS.Template.Mvc_Angular
   
2. 執行命令dotnet new osharp_cmd獲取Osharp安裝指令碼，執行完成後，目錄中出現cmd_build.bat檔案
   
3. 雙擊cmd_build.bat，並根據要求命名專案名稱（也可以根據喜好對專案進行命名，本示例使用CanDoo.Test作為專案名稱），完成專案建立
   

配置資料庫連線串並啟動專案

1. 開啟解決方案CanDoo.Test.sln後，各個工程之間的取用關係已配置好，osharp框架的類庫已取用 nuget.org 上的相應版本，並將自動還原好
   
2. 在解決方案上，右擊，點選還原Nuget包，完成相關取用的還原
   
3. 在解決方案上，右擊，點選屬性，更改啟動專案為CanDoo.Test.Web
   
4. 開啟appsettings.Development.json，對資料庫連線串根據實際進行修改（appsettings.json為正式釋出時使用的配置檔案，除錯時使用的是appsettings.Development.json，請註意區分）
   
5. 執行專案CanDoo.Test.Web，如果能看到Swagger說明執行成功（首次啟動系統自動建立資料庫，初始化相關引數，時間較久）
   
   補充說明：OsharpNS正在大力完善中，更新比較快，如果需要更新OsharpNS的取用，請點選在解決方案上，右擊，點選管理解決方案的Nuget程式包...，切換到更新標簽，勾選包括預發行版（因為OsharpNS處於預發行狀態，只更新Osharp相關的即可，其他的預發行的包別去用

OsharpNS.Swagger使用實體(登入和授權)

1. 將系統執行起來後，看到Swagger介面，找/api/Test/Test01，點選後展開檢視介面資訊
2. 點選Try it out，再點選Excute呼叫介面
   
3. Response body中顯示使用者註冊成功,系統自動註冊2個使用者，其中使用者名稱:admin 密碼gmf31529019為超級管理員使用者
   
4. 找到介面/api/Identity/JwtokenJwt,點選後檢視介面資訊
5. 點選Try it out，輸入使用者名稱和密碼，再點選Excute呼叫介面

{
  "Account": "admin",
  "Password": "gmf31529019",
}

1. 檢視Response body中反饋資訊中Data的資料比較關鍵

{
  "Type": 200,
  "Content": "登入成功",
  "Data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxIiwidW5pcXVlX25hbWUiOiJhZG1pbiIsIm5iZiI6MTU1NTY3NDQyNywiZXhwIjoxNTU1NzYwODI3LCJpYXQiOjE1NTU2NzQ0MjcsImlzcyI6Im9zaGFycCBpZGVudGl0eSIsImF1ZCI6Im9zaGFycCBhbmd1bGFyIGRlbW8ifQ.gJ7QjyoO7VFCuvAW5iVDY2fm9Lt3OWCu4WdXwiUqMKE"
}

1. 回到Swagger最頂部，找到綠色的文字Authorize，點選後在彈出視窗的Value中輸入Bearer加登入是反饋的Data

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxIiwidW5pcXVlX25hbWUiOiJhZG1pbiIsIm5iZiI6MTU1NTY3NDQyNywiZXhwIjoxNTU1NzYwODI3LCJpYXQiOjE1NTU2NzQ0MjcsImlzcyI6Im9zaGFycCBpZGVudGl0eSIsImF1ZCI6Im9zaGFycCBhbmd1bGFyIGRlbW8ifQ.gJ7QjyoO7VFCuvAW5iVDY2fm9Lt3OWCu4WdXwiUqMKE

1. 至此訪問其他介面的時候 不會再提示未登入

Angular6的前端專案啟動

1. 下載並安裝node.js，下載地址：https://nodejs.org/en/ ，建議下載LTS版本
2. 進入前端目錄CanDoo.Test\src\ui\ng-alain，以管理員身份開啟PowerShell
   
3. 設定npm的淘寶映象倉庫：由於npm的國外倉儲會很慢，所以最好把npm倉庫地址指定國內映象，推薦淘寶映象npm config set registry https://registry.npm.taobao.org
4. 安裝全域性Angular/Cli：如果Angular/Cli沒有安裝，執行如下命令全域性安裝Angularnpm install -g @angular/cli，Angular的快速啟動，請參考Angular官方檔案：https://angular.cn/guide/quickstart
5. 執行NodeJS包安裝命令npm install
   
6. 包安裝完成後，輸入專案啟動命令npm start，如果執行成功，在瀏覽器中輸入http://localhost:4201/就能看到介面了
7. 重新安裝Angular的方法：https://blog.csdn.net/qq_37692642/article/details/79372105
8. 執行npm install時候出現錯誤，註意看下Python的Path路徑是否配置了（我本地是裝好Python並且配置好Path的），但是安裝時候還是出錯了，解決時參考的檔案：https://blog.csdn.net/ztz87/article/details/81734916 ，檢視錯誤資訊是node-sass安裝失敗，我執行了設定淘寶映象npm set SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/，再次執行npm install node-sass，安裝成功
   
9. 直接使用使用者名稱:admin 密碼:gmf31529019就能進入後臺了
10. 非官方的VUE介面，後期會跟隨作者的腳步更新