ABP Framework 5.2 RC 發布及新增功能介紹-有解無憂

ABP Framework 5.2 RC 新增功能

ABP Framework 5.2 RC 新增功能
- 單層解決方案模板
  - EF Core 資料庫遷移
  - UI 和資料庫選項
- API 版本控制
- 源代碼控制移除libs檔案夾
- 對 Swagger UI 隱藏 ABP 默認端點
- CMS Kit 應用模塊自定義全域 CSS 和 JavaScript
- 其他
- 歷史版本回顧
dotNET兄弟會-公眾號

本文將介紹 ABP Framework 5.2 RC 版新增的主要功能：

單層解決方案模板
API 版本控制
源代碼控制移除libs檔案夾
對 Swagger UI 隱藏 ABP 默認端點
CMS Kit應用模塊自定義全域 CSS 和 JavaScript

關注 ABP Framework 最新開發進度，后面還會陸續發布新功能詳解、新功能示例等系列文章，敬請關注！
ABP Framework 研習社（QQ群：726299208）
專注 ABP Framework 學習，經驗分享、問題討論、示例原始碼、電子書共享，歡迎加入！

單層解決方案模板

ABP啟動模板是一個組織良好的分層解決方案，用于創建可維護的應用程式，然而，一些開發人員發現，對于簡單和短期的應用程式來說，它有點復雜，對于這樣的應用程式，我們提供一個新的啟動模板，沒有分層、確保專案結構盡可能簡單，但是在運行時功能，特性和模塊齊全，一切都包含單個專案(csproj)中，如下圖所示:

在創建解決方案時，模板引數使用 -t app-nolayers:

abp new BookStore -t app-nolayers --preview

EF Core 資料庫遷移

創建專案之后，需要在運行應用程式之前創建資料，我們已經向應用程式添加了一個引數--migrate-database，可以指定該引數用來進行資料庫遷移和初始化資料，在命令列終端打開專案目錄(包含csproj檔案)，輸入以下命令:

dotnet run --migrate-database

將運行資料庫遷移并退出，然后就可以正常運行應用程式了，

也可以使用命令 dotnet ef database update （或者 Visual Studio's Package Manager Console 中使用 Update-Database 命令）創建資料庫表，但是，不會生成運行應用程式所必需的初始資料，

為了讓解決方案保持簡單，我們并沒有添加其他應用，比如：單獨用于遷移資料庫的DbMigrator專案，

使用應用程式本身進行遷移資料庫不但可以用于開發環境，也可以在生產環境中使用，但是，還有其他遷移資料庫的方法，請閱讀更多關于微軟檔案，

UI 和資料庫選項

單層解決方案模板同樣支持 Angular 和 Blazor UI，資料庫也支持 MongoDB，對于 UI，可以為 -u 或 --ui 引數設定 mvc（默認）、angular 或 blazor-server 引數以支持不同的UI框架，對于資料庫提供程式，可以為-d或--database-provider引數設定 ef（默認）或者mongodb 以支持不同的資料庫提供程式，

示例：

abp new BookStore -t app-nolayers -u angular -d mongodb --preview

以上命令創建一個單層解決方案，使用 Angular 作為 UI框架，使用 MongoDB 作為資料庫提供程式，

API 版本控制

API版本控制在ABP框架中一直是可用的，但是我們還沒有提供相應的檔案，對于版本 5.2 ，我們創建了一個檔案來解釋如何為應用程式實作API版本控制，并向您的標準應用程式服務類添加版本控制支持，請參閱檔案，

源代碼控制移除`libs`檔案夾

注意：對于開發環境和CI/CD管道來說可能是一個破壞改變，因此，請仔細閱讀本檔案并采取必要的措施，

當你創建的解決方案使用 MVC（Razor Pages）或 Blazor Server UI 框架時，在解決方案的UI專案中包含一個 wwwroot/libs 目錄，結構如下：

libs目錄包含所有客戶端依賴類別庫（大多數為 JavaScript 和 CSS），舉個例子，在上圖中 bootstrap 目錄包含 Bootstrap 類別庫所需的必要檔案，該目錄中的內容是從 node_modules 目錄中復制而來（只復制最小的必須檔案，確保類別庫可用，并不是整個類別庫），通過 ABP CLI 提供的 abp install-libs 命令完成，

在 5.2 版本之前，libs目錄是啟動模板中的一部分，并提交到源代碼控制系統中，比如：Git，在 5.2 版本之后，該目錄默認從原始碼控制中移除，所以開發者必須在解決方案中UI專案的根目錄中運行abp install-libs命令來安裝前端依賴庫，這種方法為解決方案節省了大量空間，例如，MVC UI應用程式的初始大小從 9.83 MB減少到 0.23 MB，

當你使用 ABP CLI 創建解決方案時，install-libs命令會自動執行，所以你的應用程式可以直接作業，但是，如果你的團隊成員（或CI/CD系統）是從源代碼控制系統（如Github）獲取解決方案原始碼，那么應該在運行之前執行abp install-libs命令，

如果你想將 libs 目錄添加到源代碼控制系統中，可以在解決方案根目錄中找到 .gitignore 檔案，移除 **/wwwroot/libs/* 這一行即可，如果你使用的是 Git 以外的版本控制系統，你應該應用系統提供的設定規則來包含或排除 libs 檔案夾，

對 Swagger UI 隱藏 ABP 默認端點

Engincan Veske 寫了一篇文章來解釋如何從 Swagger UI 中隱藏 ABP默認端點，然后我們認為這可能是ABP框架中的一個很好的內置選項，所以在 AddAbpSwaggerGen 方法中添加了一個HideAbpEndpoints 方法，可以像下面的代碼示例使用:

services.AddAbpSwaggerGen(
    options => 
    {
        //... 其他設定
        
        //在Swagger UI上隱藏ABP相關的端點
        options.HideAbpEndpoints();
    }
)

這樣設定之后，ABP的默認端點仍然存在，但將在 Swagger UI 中隱藏，