OsharpNS輕量級.net core快速開發框架簡明入門教程-從零開始啓動Osharp

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

教程目錄

1. 從零開始啓動Osharp

   1.1. 使用OsharpNS項目模板建立項目

   1.2. 配置數據庫鏈接串並啓動項目

   1.3. OsharpNS.Swagger使用實例(登陸和受權)

   1.4. Angular6的前端項目啓動

2. Osharp代碼生成器的使用

   2.1 生成器的使用

   2.2 生成代碼詳解(如何本身實現業務功能)

3. Osharp部分模塊使用

   3.1 Osharp.Redis使用

   3.2 Osharp.Hangfire使用

   3.3 Osharp.Permissions使用

4. Osharp深度學習和使用

   4.1 切換數據庫(從SqlServer改成MySql)

   4.2 多上下文配置(多個數據庫的使用)

   4.3. 自定義模塊的定義（Senparc.Weixin的使用）

   4.4. 繼續學習中....

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文件，最新的命令須要執行dotnet new osharp了，注意對比紅框框出來的部分的對比
   
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/Jwtoken,點擊後查看接口信息
5. 點擊Try it out，輸入用戶名和密碼，再點擊Excute調用接口

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

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 密碼:osharp123456就能進入後臺了
10. 非官方的VUE界面，後期會跟隨做者的腳步更新