本文將介紹 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項目。

使用應用程序本身進行遷移數據庫不但可以用于開發環境，也可以在生產環境中使用。但是，還有其他遷移數據庫的方法。請關于微軟文檔^[1]。

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版本控制，并向您的標準應用程序服務類添加版本控制支持。請參閱文檔^[2]。

源代碼控制移除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^[3]?寫了一篇文章^[4]來解釋如何從 Swagger UI 中隱藏 ABP默認端點。然后我們認為這可能是ABP框架中的一個很好的內置選項，所以在?AddAbpSwaggerGen?方法中添加了一個HideAbpEndpoints?方法，可以像下面的代碼示例使用:

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

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

CMS Kit 應用模塊自定義全局 CSS 和 JavaScript

我們一直在改進 CMS Kit 應用模塊，并不斷添加新功能。在 5.2 版本中新增的特性是：全局資源系統，可以為應用程序編寫自定義的全局 JavaScript 或 CSS 代碼，并應用于所有應用程序頁面中：

通過這種方式，您可以在運行時定制應用程序的外觀和行為。有關更多信息，請參閱文檔^[5]。

請注意，頁面^[6]功能已經提供作用于頁面的腳本/樣式編輯器。但是這個新功能允許您編寫作用于應用程序所有頁面的腳本/樣式，二者可以結合使用。

其他

?為 Blazor UI 升級 Blazorise 類庫到 v1.0，升級之后確保應用程序中所有依賴 Blazorise 包使用 v1.0

歷史版本回顧

^{ABP Framework 5.0 RC.1 新特性和變更說明}

^{ABP Framework V4.4 RC 新增功能介紹}

References

[1]?微軟文檔:?https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations
[2]?文檔:?https://docs.abp.io/en/abp/5.2/API/API-Versioning
[3]?Engincan Veske:?https://twitter.com/EngincanVeske
[4]?一篇文章:?https://community.abp.io/posts/how-to-hide-abp-related-endpoints-on-swagger-ui-mb2w01fe
[5]?文檔:?https://docs.abp.io/en/abp/5.2/Modules/Cms-Kit/Global-Resources
[6]?頁面:?https://docs.abp.io/en/abp/5.2/Modules/Cms-Kit/Pages

總結

以上是生活随笔為你收集整理的ABP Framework 5.2 RC 版本发布及新增功能介绍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。