歡迎光臨
每天分享高質量文章

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

已同步到看一看
赞(0)

分享創造快樂