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命令行窗口

2. 執行命令dotnet new -i OSharpNS.Template.Mvc_Angular

3. 執行命令dotnet new osharp_cmd獲取Osharp安裝腳本，執行完成后，目錄中出現cmd_build.bat文件，最新的命令需要執行dotnet new osharp了，注意對比紅框框出來的部分的對比

4. 雙擊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",
}

6. 查看Response body中反饋信息中Data的數據比較關鍵

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

7. 回到Swagger最頂部，找到綠色的文字Authorize，點擊后在彈出窗口的Value中輸入Bearer 加登錄是反饋的Data

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxIiwidW5pcXVlX25hbWUiOiJhZG1pbiIsIm5iZiI6MTU1NTY3NDQyNywiZXhwIjoxNTU1NzYwODI3LCJpYXQiOjE1NTU2NzQ0MjcsImlzcyI6Im9zaGFycCBpZGVudGl0eSIsImF1ZCI6Im9zaGFycCBhbmd1bGFyIGRlbW8ifQ.gJ7QjyoO7VFCuvAW5iVDY2fm9Lt3OWCu4WdXwiUqMKE

8. 至此訪問其他接口的時候 不會再提示未登錄

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界面，后期會跟隨作者的腳步更新