9.4 KiB

Raw Blame History

ABP.IO Platform 5.1 Has Been Released

Today, we are releasing the ABP Framework and the ABP Commercial version 5.1 (with a version number 5.1.1). This blog post introduces the new features and important changes in this new version.

Warning

For a long time we were releasing RC (Release Candidate) versions a few weeks before every minor and major release. This version has been released without a preview version. This is because we've accidently released all the packages with a stable version number, without a -rc.1 suffix and there is no clear way to unpublish all the NuGet and NPM packages. Sorry about that. However, it doesn't mean that this release is buggy. We've already resolved known problems. We will publish one or more patch releases if needed. You can follow this milestone for known problems or submit your own bug report. If you are worried about its stability, you can wait for the next patch release.

Get Started with the 5.1

follow the steps below to try the version 5.1 today;

Upgrade the ABP CLI to the latest version using a command line terminal:

dotnet tool update Volo.Abp.Cli -g

or install if you haven't installed before:

dotnet tool install Volo.Abp.Cli -g

Create a new application:

abp new BookStore

See the ABP CLI documentation for all the available options.

You can also use the Direct Download tab on the Get Started page.

You can use any IDE that supports .NET 6.x development (e.g. Visual Studio 2022).

Migration Notes & Breaking Changes

This is an minor feature release, mostly with enhancements and improvements based on the version 5.0. There is no breaking change except the Angular UI upgrade. ABP 5.1 startup templates use Angular 13.

Angular UI

If you want to upgrade ABP Framework but want to continue with Angular 12, add the following section to package.json file of the Angular project:

"resolutions": {
    "ng-zorro-antd": "^12.1.1",
    "@ng-bootstrap/ng-bootstrap": "11.0.0-beta.2"
  }

What's new with ABP Framework 5.1?

In this section, I will introduce some major features released with this version.

The new hosting model

ABP startup application template now uses the new ASP.NET Core hosting APIs (see the Microsoft's minimal APIs document) on application startup (see the exact place in the ABP startup template). So, the Startup.cs file has been removed.

Old-style hosting logic will continue to work as long as ASP.NET Core supports it. It is recommended to switch to the new model if possible for your solution. See this guide if you need to know how you can to do that.

Asynchronous startup lifecycle methods

The new hosting model allows us to execute asynchronous code on application initialization in ABP module classes. If you are using the new hosting model (which is default with 5.1 startup templates), you can override the Async versions of the module lifecycle methods.

For example, you can now override the ConfigureServicesAsync (instead of ConfigureServices) or OnApplicationInitializationAsync (instead of OnApplicationInitialization) as shown in the following code block:

public class MyModule : AbpModule
{
    public override async Task ConfigureServicesAsync(ServiceConfigurationContext context)
    {
        /* You can use await here and safely execute other async methods */
    }

    public override async Task OnApplicationInitializationAsync(ApplicationInitializationContext context)
    {
        /* You can use await here and safely execute other async methods */
    }
}

If you override both of asynchronous and synchronous versions of the same method, only the asynchronous one will be executed. So, override only one of them based on your needs.

eShopOnABP is getting mature

Our team is working to finalize the eShopOnAbp example solution, which is a reference microservice solution built with the ABP Framework. They will explain the project status and show what's done in the next ABP Community Talks meeting (see the ABP Community Talks 2021.1 section below in this post).

The new ABP.IO design!

We were working on a new design for the abp.io websites for a while. We are making the final touches; the new design will be live very soon. Here a screenshot from the design work:

![new-abp-io-design](D:\Github\abp\docs\en\Blog-Posts\2022-01-11 v5_1_Preview\new-abp-io-design.png)

ABP Commercial and ABP Community websites will also have new designs as a part of this update.

Other changes

Here some other notable changes that come with this release:

Support markdown in CMS-Kit comments feature (#10792)
Used file scoped namespaces for all the ABP Framework source code :) (#10552)

All issues & PRs in 5.1 milesone.

About the ABP Commercial

The core team is also working on the ABP Commercial (which provides pre-built modules, themes, tooling and support on top of the ABP Framework). We've done a lot of minor improvements and fixes to the modules and tooling.

One exiting new is about the LeptonX theme; We are working on to make it available in MVC (Razor Pages) and Blazor UI options too (in addition to the Angular UI). We are also adding more components, layout options, demo pages, etc... We are planning to release a beta version in the next weeks. Here an animated GIF from the dashboard we've prepared as a demonstration:

If you are wondering what is the LeptonX project, please see that blog post.

As another visible functionality, we've added a new feature to the CMS Kit Pro module that is used to forward a URL to another URL. This is a screenshot from the management UI:

This feature can be used to create short URLs in your application (like URL shortening services provide) or forward old pages to their new URLs.

In addition to the new features shipped in every minor version, we are working on long-term projects for ABP.IO Platform and ABP Commercial (a little secret for now :). We will have announcements once these projects get mature.

Community News

ABP Community Talks 2021.1

This is the second episode of the ABP Community Talks and we are talking about microservice development with the ABP Framework, based on the eShopOnAbp reference solution. We will also briefly talk about the changes that come with ABP version 5.1. This live meeting will be at January 20, 2022, 17:00 (UTC) on YouTube.

Join this event on the Kommunity platform: https://kommunity.com/volosoft/events/abp-community-talks-20221-microservice-development-acd0f44b

You can also subscribe to the Volosoft channel for reminders for further ABP events and videos.

New ABP Community posts

Here, some of the recent posts added to the ABP community:

Minimal API development with the ABP Framework by @antosubash (three parts, video tutorial).
Integrating the Syncfusion MVC Components to the ABP MVC UI by @EngincanV.
Add Tailwind CSS to your ABP Blazor UI by @antosubash (video tutorial).
Import external users into the users Table from an ABP Framework application by @bartvanhoey.

Thanks to the ABP Community for all the contents they have published. You can also post your ABP and .NET related (text or video) contents to the ABP Community.

Conclusion

In this blog post, I summarized the news about that new version and the ABP Community. Please try it and provide feedback by opening issues on the GitHub repository. Thank you all!

9.4 KiB Raw Blame History