docs/en/Blog-Posts/2021-06-28 v4_4 Preview/POST.md
Today, we have released the ABP Framework and the ABP Commercial version 4.4 RC (Release Candidate). This blog post introduces the new features and important changes in this new version.
The planned release date for the 4.4.0 final version is July 13, 2021.
If you want to try the version 4.4.0 today, follow the steps below;
4.4.0-rc.1 using a command line terminal:dotnet tool update Volo.Abp.Cli -g --version 4.4.0-rc.1
or install if you haven't installed before:
dotnet tool install Volo.Abp.Cli -g --version 4.4.0-rc.1
--preview option:abp new BookStore --preview
See the ABP CLI documentation for all the available options.
You can also use the Direct Download tab on the Get Started page by selecting the Preview checkbox.
There is no breaking change with this version. However, if you are using Entity Framework Core, you will need to run the Add-Migration command to add a new database migration since some changes done in the module database mappings.
With this version, we are doing an important change in the application startup solution template. The startup solution was containing an EntityFrameworkCore.DbMigrations project that contains a separate DbContext class which was responsible to unify the module database mappings and maintain the code-first database migrations. With the v4.4, we've removed that project from the solution. In the new structure, the EntityFrameworkCore integration project will be used for database migrations as well as on runtime.
We'd published a community article about that change. Please see the article to understand the motivation behind the change.
Beside the DbContext unification, we've also used the new ReplaceDbContext attribute and replaced the IIdentityDbContext and ITenantManagementDbContext interfaces to make it possible to perform join queries over repositories for these modules easily. In the next days, we will publish another community article to explain the problem and the solution. However, most of times, you don't need to know these details.
CMS Kit is a set of reusable Content Management System features packaged as an ABP application module. We had published the first usable version with the previous release. With this release, we are adding another feature to the CMS Kit module: You can now dynamically arrange the main menu on the UI, which is an essential feature for any kind of content management system. In this way, you can add pages or any kind of arbitrary URLs to the main menu from the UI.
A screenshot from the menu management page (from the CMS Kit admin side):
And the items rendered in a public website:
Note that this feature is also available with the open source CMS Kit module (while the screenshots have been taken from the ABP Commercial).
Text Templating is a system to generate content on runtime by using a model (data) and a template. It was running on the Scriban templating engine. Beginning from this version, we have a second option: We can use the familiar razor syntax to build and render the templates. See the text templating razor integration document to get started with the new engine!
Two new extension methods are added to ObjectExtensionManager.Instance to override EF Core mappings of pre-built application modules.
Example: Change mappings for the IdentityDbContext to override mappings for the IdentityUser entity
ObjectExtensionManager.Instance.MapEfCoreDbContext<IdentityDbContext>(modelBuilder =>
{
modelBuilder.Entity<IdentityUser>(b =>
{
b.ToTable("MyUsers");
b.Property(x => x.Email).HasMaxLength(300);
});
});
The startup template contains a class, like YourProjectNameEfCoreEntityExtensionMappings, that can be used to place that code.
There are new ABP CLI commands introduced with the v4.4:
abp install-libs command is used for MVC / Razor Pages and Blazor Server applications to restore the wwwroot/libs folder. Previously we were running the yarn and gulp commands to restore that folder. While the install-libs command still uses yarn (if available), it is no longer needed to use gulp.abp prompt command can be used to open a prompt for the ABP CLI and run multiple commands without needing to specify the abp command every time. For example, if you run abp prompt, then you can directly run install-libs instead of abp install-libs. Use exit to quit from the ABP prompt.abp batch command can be used to run multiple ABP commands with one command. Prepare a text file, write each command as a line (without the abp command prefix), then execute abp batch <batch-file> (ex: abp batch your_commands.txt) command to execute all the commands in that file.Added appsettings.secrets.json to the startup template that can be used to set your sensitive/secret configuration values. You can ignore this file from source control (by adding to .gitignore if you're using git) and keep it only in developer/production machines.
IRemoteServiceConfigurationProvider to get remote service configurations. You can replace this service to get the configuration from any source.Beside these, there are a lot of enhancements and bug fixes. See the 4.4-preview milestone for all issues and pull requests closed with this version.
We've implemented some important features to the SaaS module:
There are many improvements done for for ABP Suite, including CRUD page generation for the microservice solution template.
In the previous version, we had implemented the resource owner password authentication flow for the Angular UI, which makes the login process easier for simpler applications. With this release, we've implemented two-factor authentication for that flow. Authorization code flow already supports 2FA.
appsettings.secrets.json in the new startup templates.Beside these, there are many minor improvements and fixes done in the modules and themes.
In this section, I will share some news that you may be interested in.
We have been frequently asked how to use Elsa Workflows with the ABP Framework. Finally, we have created an article to demonstrate it.
You can check it to see how to integrate Elsa into an ABP based solution easily.
We've published a free e-book for the ABP Community in the beginning of June. This is a practical guide for implementing Domain Driven Design (DDD). While the implementation details are based on the ABP Framework infrastructure, the basic concepts, principles and models can be applied to any solution, even if it is not a .NET solution.
Thousands of copies are already downloaded. If you haven't seen it yet, click here to get a free copy of that e-book.
We have been working on a new ABP theme, named the LeptonX, for a long time. The theme will be available for ABP Framework (free - lite version) and ABP Commercial (pro version). It is being finalized in the next weeks and we will release the first version in a short time.
See this blog post to learn more about that project.
Volosoft, the company leads the ABP Framework project, has been a corporate sponsor of the .NET Foundation. We are happy by taking our place among other great sponsors!
We will continue to contribute to and support open source! See this blog post for the announcement.
We are actively looking for professional developer advocates for the ABP.IO platform. If you want to create content and touch to the ABP community, please check our job post.
The next version will be a major version: 5.0, which will be based on .NET 6.0. We are planning to release it in the end of 2021, short time after the .NET 6.0 release. We will release multiple preview/beta versions before the RC version. See the road map for details of the planned works for the version 5.0.