The planned release date for the 4.0.0 final version is December 3, 2020.
Get Started with the 4.0 RC
If you want to try the version
4.0.0 today, follow the steps below;
- Upgrade the ABP CLI to the version
4.0.0-rc.5using a command line terminal:
dotnet tool update Volo.Abp.Cli -g --version 4.0.0-rc.5
or install if you haven't installed before:
dotnet tool install Volo.Abp.Cli -g --version 4.0.0-rc.5
- 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.
Migrating From 3.x to 4.0
The version 4.0 comes with some major changes including the migration from .NET Core 3.1 to .NET 5.0.
We've prepared a detailed migration document to explain all the changes and the actions you need to take while upgrading your existing solutions.
What's new with the ABP Framework 4.0
The Blazor UI
The Blazor UI is now stable and officially supported. The web application development tutorial has been updated based on the version 4.0.
abp bundle command
index.html file in the dependency order by respecting to modularity. In the next version it will automatically unify & minify the files. The documentation is being prepared.
There are some other changes in the startup template and some public APIs. Follow the Migration Guide to apply changes for existing solutions that you're upgrading from the version 3.3. While we will continue to make improvements add new features, we no longer make breaking changes on the existing APIs until the version 5.0.
A lot of minor and major improvements have been done for the Blazor UI. Some of them are listed below:
IComponentActivatorto resolve the component from the
IServiceProvider. So, you can now inject dependencies into the constructor of your razor component.
- Introduced the
AbpComponentBasebase class that you derive your components from. It has useful base properties that you can use in your pages/components.
IUiNotificationServiceservice to show toast notifications on the UI.
- Improved the
IUiMessageServiceto show message & confirmation dialogs.
ABP Framework 4.0 uses the System.Text.Json by default as the JSON serialization library. It, actually, using a hybrid approach: Continues to use the Newtonsoft.Json when it needs to use the features not supported by the System.Text.Json.
Follow the Migration Guide to learn how to configure to use the Newtonsoft.Json for some specific types or switch back to the Newtonsoft.Json as the default JSON serializer.
Identity Server 4 Upgrade
ABP Framework upgrades the IdentityServer4 library from 3.x to 4.1.1 with the ABP Framework version 4.0. IdentityServer 4.x has a lot of changes. Some of them are breaking changes in the data structure.
Follow the Migration Guide to upgrade existing solutions.
Creating a New Module Inside the Application
ABP CLI has now a command to create a new module and add it to an existing solution. In this way, you can create modular applications easier than before.
Example: Create a ProductManagement module into your solution.
abp add-module ProductManagement --new --add-to-solution-file
Execute this command in a terminal in the root folder of your solution. If you don't specify the
--add-to-solution-file option, then the module projects will not be added to the main solution, but the project references still be added. In this case, you need to open the module's solution to develop the module.
See the CLI document for other options.
WPF Startup Template
Introducing the WPF startup template for the ABP Framework. Use the ABP CLI new command to create a new WPF application:
abp new MyWpfApp -t wpf
This is a minimalist, empty project template that is integrated to the ABP Framework.
Thanks to the contributors from the ABP Community, the framework modules and the startup template have been localized to German language by Alexander Pilhar & Nico Lachmuth and to Spanish language by Jose Manuel Gonzalez and Washington Acero M..
- Upgraded to Angular 11.
- Since Mongo2Go library not supports transactions, you can use transactions in unit tests for MongoDB.
What's new with the ABP Commercial 4.0
The Blazor UI
The Blazor UI for the ABP Commercial is also becomes stable and feature rich with the version 4.0;
- ABP Suite now supports to generate CRUD pages for the Blazor UI.
- Completed the Lepton Theme for the Blazor UI.
- Implemented the File Management module for the Blazor UI.
The ABP Suite
While creating create/edit modals with a navigation property, we had two options: A dropdown to select the target entity and a modal to select the entity by searching with a data table.
Dropdown option now supports lazy load, search and auto-complete. In this way, selecting a navigation property becomes much easier and supports large data sets on the dropdown.
Example: Select an author while creating a new book
With the new version, you can disable backend code generation on CRUD page generation. This is especially useful if you want to regenerate the page with a different UI framework, but don't want to regenerate the server side code.
Identity Server Management UI Revised
Completely revised the Identity Server Management UI based on the IDS 4.x changes.
About the Next Release
The next feature version,
4.1.0, will mostly focus on completing the missing documents, fixing bugs, performance optimizations and improving the Blazor UI features. The planned preview release date for the version
4.1.0 is December 10 and the final (stable) version release date is December 24.
Follow the GitHub milestones for all the planned ABP Framework version release dates.