The planned release date for the 4.4.0 final version is July 27, 2021.
Get Started with the 4.4 RC
If you want to try the version 4.4.0 today, follow the steps below;
- Upgrade the ABP CLI to the version
4.4.0-rc.2using a command line terminal:
dotnet tool update Volo.Abp.Cli -g --version 4.4.0-rc.2
or install if you haven't installed before:
dotnet tool install Volo.Abp.Cli -g --version 4.4.0-rc.2
- Create a new application with the
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.
What's new with the ABP Framework 4.4
Removed EntityFrameworkCore.DbMigrations Project
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.
DbContext unification, we've also used the new
ReplaceDbContext attribute and replaced the
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.
Dynamic Menu Management for the CMS Kit Module
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).
Razor Engine Support for Text Templating
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!
New Customization Points for DbContext/Entities
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
b.Property(x => x.Email).HasMaxLength(300);
The startup template contains a class, like
YourProjectNameEfCoreEntityExtensionMappings, that can be used to place that code.
New ABP CLI Commands
There are new ABP CLI commands introduced with the v4.4:
abp install-libscommand is used for MVC / Razor Pages and Blazor Server applications to restore the
wwwroot/libsfolder. Previously we were running the
gulpcommands to restore that folder. While the
install-libscommand still uses yarn (if available), it is no longer needed to use
abp promptcommand can be used to open a prompt for the ABP CLI and run multiple commands without needing to specify the
abpcommand every time. For example, if you run
abp prompt, then you can directly run
abp install-libs. Use
exitto quit from the ABP prompt.
abp batchcommand can be used to run multiple ABP commands with one command. Prepare a text file, write each command as a line (without the
abpcommand prefix), then execute
abp batch <batch-file>(ex:
abp batch your_commands.txt) command to execute all the commands in that file.
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.
Other ABP Framework Improvements
- #9350 Extracted
IRemoteServiceConfigurationProviderto get remote service configurations. You can replace this service to get the configuration from any source.
- #8829 Implemented error handler and retry for distributed event bus.
- #9288 Use default CORS policy instead of a named one in the startup template. It is suggested to update your own solutions to make it simpler.
- Translated the framework and module localization strings to Hindi, Italian (thanks to Emanuele Filardo), Finnish, French and Slovak (thanks to Michal Čadecký) languages.
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.
What's new with the ABP Commercial 4.4
New Features for the SaaS Module
We've implemented some important features to the SaaS module:
- Integrated to the Payment module and implemented subscription system for the SaaS module.
- Allow to make a tenant active/passive. In this way, you can take a tenant to passive to prevent the users of that tenant from using the system. In addition, you can set a date to automatically make a tenant passive when the date comes.
- Allow to limit user count for a tenant.
- Allow to set different connection strings for a tenant for each database/module, which makes possible to create different databases for a tenant for each microservice in a microservice solution.
New ABP Suite Code Generation Features
Angular UI: Two Factor Authentication for the Resource Owner Password Flow
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.
Other ABP Commercial Improvements
- Added web layers to microservices in the microservice solution. You can use them to create modular UI or override existing pages/components of pre-built modules (e.g. Identity and SaaS).
- ABP Commercial license code has been moved to
appsettings.secrets.jsonin 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.
New Article: Using Elsa Workflow with ABP Framework
You can check it to see how to integrate Elsa into an ABP based solution easily.
Free E-Book: Implementing Domain Driven Design
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.
The LeptonX Theme
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 & .NET Foundation
We will continue to contribute to and support open source! See this blog post for the announcement.
Looking for Developer Advocate(s)
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.
About the Next Version
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.