OsharpNS輕量級.net core快速開發框架簡明入門教程 教程目錄 1. 從零開始啟動Osharp 1.1. "使用OsharpNS項目模板創建項目" 1.2. "配置資料庫連接串並啟動項目" 1.3. "OsharpNS.Swagger使用實例(登錄和授權)" 1.4. "Angular6 ...
OsharpNS輕量級.net core快速開發框架簡明入門教程
教程目錄
- 從零開始啟動Osharp
1.1. 使用OsharpNS項目模板創建項目
1.2. 配置資料庫連接串並啟動項目
1.3. OsharpNS.Swagger使用實例(登錄和授權)
1.4. Angular6的前端項目啟動 - Osharp代碼生成器的使用
2.1 生成器的使用
2.2 生成代碼詳解（如何自己實現業務功能） - Osharp部分模塊使用
3.1 Osharp.Redis使用
3.2 Osharp.Hangfire使用
3.3 Osharp.Permissions使用 - 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命令行視窗
- 執行命令
dotnet new -i OSharpNS.Template.Mvc_Angular
- 執行命令
dotnet new osharp_cmd獲取Osharp安裝腳本，執行完成後，目錄中出現cmd_build.bat文件
- 雙擊
cmd_build.bat，並根據要求命名項目名稱（也可以根據喜好對項目進行命名，本示例使用CanDoo.Test作為項目名稱），完成項目創建
配置資料庫連接串並啟動項目
- 打開解決方案
CanDoo.Test.sln後，各個工程之間的引用關係已配置好，osharp框架的類庫已引用 nuget.org 上的相應版本，並將自動還原好
- 在解決方案上，右擊，點擊
還原Nuget包，完成相關引用的還原
- 在解決方案上，右擊，點擊
屬性，更改啟動項目為CanDoo.Test.Web
- 打開
appsettings.Development.json，對資料庫連接串根據實際進行修改（appsettings.json為正式發佈時使用的配置文件，調試時使用的是appsettings.Development.json，請註意區分）
- 運行項目
CanDoo.Test.Web，如果能看到Swagger說明運行成功（首次啟動系統自動創建資料庫，初始化相關參數，時間較久）
補充說明：OsharpNS正在大力完善中，更新比較快，如果需要更新OsharpNS的引用，請點擊在解決方案上，右擊，點擊管理解決方案的Nuget程式包...，切換到更新標簽，勾選包括預發行版（因為OsharpNS處於預發行狀態，只更新Osharp相關的即可，其他的預發行的包別去用）
OsharpNS.Swagger使用實例(登錄和授權)
- 將系統運行起來後，看到Swagger界面，找
/api/Test/Test01，點擊後展開查看介面信息 - 點擊
Try it out，再點擊Excute調用介面
Response body中顯示用戶註冊成功,系統自動註冊2個用戶，其中用戶名:admin 密碼gmf31529019為超級管理員用戶
- 找到介面
/api/Identity/JwtokenJwt,點擊後查看介面信息 - 點擊
Try it out，輸入用戶名和密碼，再點擊Excute調用介面
{
"Account": "admin",
"Password": "gmf31529019",
}
- 查看
Response body中反饋信息中Data的數據比較關鍵
{
"Type": 200,
"Content": "登錄成功",
"Data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxIiwidW5pcXVlX25hbWUiOiJhZG1pbiIsIm5iZiI6MTU1NTY3NDQyNywiZXhwIjoxNTU1NzYwODI3LCJpYXQiOjE1NTU2NzQ0MjcsImlzcyI6Im9zaGFycCBpZGVudGl0eSIsImF1ZCI6Im9zaGFycCBhbmd1bGFyIGRlbW8ifQ.gJ7QjyoO7VFCuvAW5iVDY2fm9Lt3OWCu4WdXwiUqMKE"
}
- 回到Swagger最頂部，找到綠色的文字
Authorize，點擊後在彈出視窗的Value中輸入Bearer加登錄是反饋的Data
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxIiwidW5pcXVlX25hbWUiOiJhZG1pbiIsIm5iZiI6MTU1NTY3NDQyNywiZXhwIjoxNTU1NzYwODI3LCJpYXQiOjE1NTU2NzQ0MjcsImlzcyI6Im9zaGFycCBpZGVudGl0eSIsImF1ZCI6Im9zaGFycCBhbmd1bGFyIGRlbW8ifQ.gJ7QjyoO7VFCuvAW5iVDY2fm9Lt3OWCu4WdXwiUqMKE
- 至此訪問其他介面的時候 不會再提示未登錄
Angular6的前端項目啟動
- 下載並安裝node.js，下載地址：https://nodejs.org/en/ ，建議下載LTS版本
- 進入前端目錄
CanDoo.Test\src\ui\ng-alain，以管理員身份打開PowerShell
- 設置npm的淘寶鏡像倉庫：由於npm的國外倉儲會很慢，所以最好把npm倉庫地址指定國內鏡像，推薦淘寶鏡像
npm config set registry https://registry.npm.taobao.org - 安裝全局Angular/Cli：如果Angular/Cli沒有安裝，執行如下命令全局安裝Angular
npm install -g @angular/cli，Angular的快速啟動，請參考Angular官方文檔：https://angular.cn/guide/quickstart - 執行NodeJS包安裝命令
npm install
- 包安裝完成後，輸入項目啟動命令
npm start，如果運行成功，在瀏覽器中輸入http://localhost:4201/就能看到界面了 - 重新安裝Angular的方法：https://blog.csdn.net/qq_37692642/article/details/79372105
- 執行
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，安裝成功
- 直接使用
用戶名:admin 密碼:gmf31529019就能進入後臺了 - 非官方的VUE界面，後期會跟隨作者的腳步更新
