ABP Framework & ABP Commercial 3.2 RC With The New Blazor UI 🚀

User Avatar
4 years ago, 10438 views, 1 comments
Cover Image

We are extremely excited today to release the ABP Framework Release Candidate (and the ABP Commercial, as always). This release includes an early preview version of the Blazor UI for the ABP.IO Platform.

The Blazor UI

While the Blazor UI should be considered as experimental for now, it is possible to start to develop your application today.

Fundamental Services

Currently, implemented some important framework features;

  • Authentication through the MVC backend using the OpenId Connect authorization code flow. So, all the current login options (login, register, forgot password, external/social logins...) are supported.
  • Authorization, using the ABP Framework permissions as well as the standard authorization system.
  • Localization just works like the MVC UI.
  • Basic Theme with the top main menu.
  • Dynamic C# HTTP API proxies, so you can directly consume your backend API by injecting the application service interfaces.
  • Some other fundamental services like ISettingProvider, IFeatureChecker, ICurrentUser...

Also, the standard .net services are already available, like caching, logging, validation and much more. Since the ABP Framework has layered itself, all the non-MVC UI related features are already usable for the Blazor UI.

Pre-Built Modules

Some modules have been implemented;

  • Identity module is pre-installed and provides user, role and permission management.
  • Profile management page is implemented to allow to change the password and personal settings.

About the Blazorise Library

We've selected the Blazorise as a fundamental UI library for the Blazor UI. It already supports different HTML/CSS frameworks (like Bootstrap, Bulma, Ant Design...) and significantly increases the developer productivity.

blazorise-github

We also have good news: Mladen Macanović, the creator of the Blazorise, is joining to the core ABP Framework team in the next weeks. We are excited to work with him to bring the power of these two successful projects together.

The Tutorial

We've updated the web application development tutorial for the Blazor UI. You can start to develop applications today! The source code of the BookStore application developed with this tutorial is here.

Get started with the Blazor UI

If you want to try the Blazor UI today, follow the instructions below.

Upgrade the ABP CLI

Install the latest ABP CLI preview version:

dotnet tool update Volo.Abp.Cli -g --version 3.2.0-rc.2

Create a new Solution

Then you can create a new solution using the abp new command:

abp new AbpBlazorDemo -u blazor --preview

Also, specify the -t app-pro parameter if you are an ABP Commercial user.

See the ABP CLI documentation for the additional options, like MongoDB database or separated authentication server.

Open the Solution

Open the generated solution using the latest Visual Studio 2019. You will see a solution structure like the picture below:

visual-studio-solution-with-blazor

Run the Application

  • Run the DbMigrator project to create the database and seed the initial data.
  • Run the HttpApi.Host project for the server-side.
  • Run the Blazor project to start the Blazor UI.

Use admin as the username and 1q2w3E* as the password to login to the application.

Here, a screenshot from the role management page of the Blazor UI:

blazor-role-management-img

What's New with the ABP Framework 3.2

Besides the Blazor UI, there are a lot of issues that have been closed with the milestone 3.2. I will highlight some of the major features and changes released with this version.

MongoDB ACID Transactions

MongoDB integration now supports multi-document transactions that comes with the MongoDB 4.x.

We've disabled transactions for solutions use the MongoDB, inside the YourProjectMongoDbModule.cs file in the MongoDB project. If your MongoDB server supports transactions, you should manually enable it in this class:

Configure<AbpUnitOfWorkDefaultOptions>(options =>
{
    options.TransactionBehavior = UnitOfWorkTransactionBehavior.Auto;
});

Or you can delete this code since this is already the default behavior.

Upgrade Notes

If you are upgrading an existing solution and your MongoDB server doesn't support transactions, please disable it:

Configure<AbpUnitOfWorkDefaultOptions>(options =>
{
    options.TransactionBehavior = UnitOfWorkTransactionBehavior.Disabled;
});

See the Unit Of Work document to learn more about UOW and transactions.

Also, add this file into your MongoDB project (remember to change MongoDbMyProjectNameDbSchemaMigrator and IMyProjectNameDbSchemaMigrator with your own project name).

Integration Tests

Transactions are also disabled for automated integration tests coming with the application startup template, since the Mongo2Go library (we use in the test projects) has a problem with the transactions. We've sent a Pull Request to fix it and will enable the transactions again when they merge & release it.

If you are upgrading an existing solution and using MongoDB, please disable transactions for the test projects just as described above.

Kafka Integration for the Distributed Event Bus

ABP Framework's distributed event system has been integrated to RabbitMQ before. By the version 3.2, it has a Kafka integration package, named Volo.Abp.EventBus.Kafka.

See the Kafka integration documentation to learn how to install and configure it.

Host Features

ABP Feature System allows you to define features in your application. Then you can enable/disable a feature dynamically on the runtime. It is generally used in a multi-tenant system to restrict features for tenants, so you can charge extra money for some features in a SaaS application.

In some cases, you may want to use the same features in the host side (host is you as you are managing the tenants). For this case, we've added a "Manage Host Features" button to the Tenant Management page so you can open a modal dialog to select the features for the host side.

host-features

AbpHttpClientBuilderOptions

ABP Framework provides a system to dynamically create C# proxies to consume HTTP APIs from your client applications. AbpHttpClientBuilderOptions is a new option class to configure the HttpClients used by the proxy system.

Example: Use the Polly library to retry up to 3 times for a failed HTTP request

public override void PreConfigureServices(ServiceConfigurationContext context)
{
    PreConfigure<AbpHttpClientBuilderOptions>(options =>
    {
        options.ProxyClientBuildActions.Add((remoteServiceName, clientBuilder) =>
        {
            clientBuilder.AddTransientHttpErrorPolicy(policyBuilder =>
                policyBuilder.WaitAndRetryAsync(
                    3,
                    i => TimeSpan.FromSeconds(Math.Pow(2, i))
                )
            );
        });
    });
}

See the issue #5304 for the details.

ABP Build Command

We are using mono repository approach and the abp repository has tens of solutions and hundreds of projects (the framework, modules, tooling, templates...) with all of them are referencing to each other.

It gets a significant time to build the whole repository for every Git push. To optimize this process, we've created the abp build command in the ABP CLI:

abp build

We will use this command to build the abp repository or a solution inside it. However, it is available to everyone in case of need.

Most of the people will not need it. If you need it, see the ABP CLI document to learn all the details and options.

Other Features, Improvements and Changes

  • Introduced the DynamicRangeAttribute that can be used to determine the range values on runtime, just like the DynamicStringLengthAttribute was introduced before.
  • Improved the feature management modal for multi-tenant applications to group features on the UI and show hierarchically.
  • Added --skip-cli-version-check option to ABP CLI to improve the performance by bypassing the online version check.
  • Angular UI now redirect to MVC UI (the authentication server-side) for profile management page, if the authorization code flow is used (which is the default).
  • Account module profile management page is now extensible. You can implement the IProfileManagementPageContributor interface and register it using the ProfileManagementPageOptions class.
  • Improvements and optimizations for the Angular service proxy generation.

And a lot of minor improvements and bug fixes. You can see the milestone 3.2 for all issues & PRs closed with this version.

What's New with the ABP Commercial 3.2

Breaking Changes

The new profile picture management feature uses the BLOB storing system, so it needs a Storage Provider. The new startup template comes with the Database BLOB Provider pre-installed. You can change it if you want to use another BLOB provider (like Azure, AWS or a simple file system).

Existing solutions must configure a BLOB provider after upgrading to the version 3.2. Follow the BLOB Storing document to configure the provider yourself.

The Blazor UI

The experimental Blazor UI is also available for the ABP Commercial. The Lepton Theme hasn't been implemented with this initial preview, however we are working on it with the highest priority.

You can use the ABP Suite or the following ABP CLI command to create a new solution with the Blazor UI:

abp new AbpBlazorDemo -u blazor -t app-pro --preview

Please try it and provide feedback to us. Thanks in advance.

See the instructions in the Get started with the Blazor UI section above to properly create and run your application.

File Management Angular UI

Angular UI for the File Management module is available with version 3.2. You can add it to your solution using the ABP Suite.

file-management-module-angular

Profile Picture Management

We've added profile picture management for the account module, so a user can select one of the options below for her profile picture;

  • Use the default placeholder as the avatar.
  • Use Gravatar service to get the picture matching the email address of the user.
  • Upload a file as the profile picture.

account-profile-picture

Two Factor Authentication Features

Created features and settings to disable, enable or force to use 2FA on login for the tenants and users.

Upgrading the ABP Suite

You can use the following command to upgrade the ABP Suite to the latest preview version:

abp suite update --preview

Other News

The ABP Community

ABP Community web site is constantly being improved and new articles are added. We will add "commenting" and "rating" features to the articles soon to increase the interactivity between the people.

abp-community-20200917

If you have something to share with the ABP community or want to follow the project progress, please check the community.abp.io!

CMS Kit Project

We are silently working on a project, named CMS Kit, for a few months. CMS Kit is a set of reusable CMS (Content Management System) components based on the ABP Framework. Some of the components currently being developed:

  • Comments; Allows users to comment under something (a blog post, a document, an image... etc).
  • Reactions; Allows users to give reactions to something (a comment, a picture... etc.) using simple emoji icons.
  • Rating; Allows users to rate some content from 1 to 5.
  • Newsletter; Allows you to put a newsletter box to your web site to collect emails from users.
  • Contact; Put a form to get a message from the web site visitors.

There are more planned components like articles, tags, votes, favorites, portfolios, image galleries, FAQs... etc. We will document and deploy these components when they get matured and ready to use. Some of them will be open source & free while some of them are paid (included in the ABP Commercial license).

Feedback

Please try the ABP Framework 3.2.0 RC and provide feedback to help us to release a more stable version. The planned release date for the 3.2.0 final version is October 01.

1 comments

Leave Comment
User Avatar
ZhaoYi 4 years ago

Very much looking forward to..

More From Hikalkan

Announcing ABP Studio (beta) General Availability

ABP Studio (beta) is generally available to everyone and ready for download. Continue Reading

hikalkan July 2024

Unifying the ABP Platform

Some big changes and improvements are coming to the ABP.IO Platform soon Continue Reading

hikalkan April 2024

ABP.IO Platform 7.1 Final Has Been Released

Introducing the ABP.IO Platform version 7.1! Continue Reading

hikalkan March 2023

ABP.IO Platform 5.2 Final Has Been Released

Introducing the ABP.IO Platform version 5.2.0! Continue Reading

hikalkan April 2022

ABP.IO Platform 5.2 RC Has Been Published

Introducing the new features and changes coming with ABP Framework and ABP Commercial version 5.2. Continue Reading

hikalkan March 2022

ABP.IO Platform v5.1 Has Been Released

Introducing the new features and changes coming with ABP Framework and ABP Commercial version 5.1. Continue Reading

hikalkan January 2022

ABP.IO Platform 5.0 RC.1 Has Been Released

Introducing the ABP v5.0 RC and the new features coming with this version. Continue Reading

hikalkan November 2021

ABP.IO Platform 4.4 Final Has Been Released!

ABP Framework and ABP Commercial 4.4 versions have been released. Continue Reading

hikalkan August 2021

ABP Platform 4.4 RC Has Been Released

This post covers the new features and changes coming with the ABP.IO platform version 4.4. Continue Reading

hikalkan June 2021

ABP.IO Platform v4.3 Has Been Released!

Introducing the ABP.IO Platform version 4.3.0! Continue Reading

hikalkan April 2021

ABP Commercial 4.3 RC Has Been Published

Introducing the ABP Commercial v4.3 RC and the new features coming with this version Continue Reading

hikalkan April 2021

ABP Framework 4.3 RC Has Been Published

Introducing the ABP v4.3 RC and the new features coming with this version Continue Reading

hikalkan April 2021

ABP.IO Platform 4.2 Final Has Been Released!

ABP Framework and ABP Commercial 4.2 versions have been released today. Continue Reading

hikalkan January 2021

ABP.IO Platform v4.2 RC Has Been Released!

This post covers the new features and changes coming with the ABP.IO platform 4.2 version. Continue Reading

hikalkan January 2021

ABP.IO Platform v4.1 Final Has Been Released!

ABP Framework and ABP Commercial 4.1 versions have been released. Continue Reading

hikalkan January 2021

ABP.IO Platform v4.1 RC Has Been Released!

Released ABP.IO Platform v4.1 RC. Some new features: Module Entity Extensions, Blazor UI Improvements, Spanish Language Translation etc. Learn more... Continue Reading

hikalkan December 2020

ABP.IO Platform 4.0 with .NET 5.0 in the 4th Year!

Released ABP.IO Platform v4.0 Final. Some new features: Migrated to .NET 5.0, Stable Blazor UI, Identity Server 4 Upgrade, Moved to System.Text.Jso... Continue Reading

hikalkan December 2020

ABP.IO Platform v4.0 RC Has Been Released based on .NET 5.0!

Released ABP.IO Platform v4.0 RC. Some new features: Migrated to .NET 5.0, Stable Blazor UI, Identity Server 4 Upgrade, Moved to System.Text.Json, ... Continue Reading

hikalkan November 2020

ABP Framework & ABP Commercial 3.3 Final Have Been Released

Released ABP v3.3. Some new features: New modules & features for the Blazor UI, Automatic Validation for AntiForgery Token for HTTP APIs, Rebus Int... Continue Reading

hikalkan October 2020

ABP Framework & ABP Commercial v3.3 RC Have Been Released

Released ABP v3.3 RC. Some new features: New modules & features for the Blazor UI, Automatic Validation for AntiForgery Token for HTTP APIs, Rebus ... Continue Reading

hikalkan October 2020

ABP Framework v3.2 Final Has Been Released

Released ABP v3.2 final. Some new features: The Blazor UI, MongoDB ACID Transactions, Kafka Integration for the Distributed Event Bus etc. Learn mo... Continue Reading

hikalkan October 2020

Introducing the Angular Service Proxy Generation

ABP Framework has introduced the new Angular Service Proxy Generation system with the version 3.1. This post introduces the service proxy generatio... Continue Reading

hikalkan September 2020

ABP Framework v3.1 Final Has Been Released

Released ABP v3.1 final. Some new features: Angular Service Proxies, Authorization Code Flow for the Angular UI, Global Feature System etc. Learn m... Continue Reading

hikalkan September 2020

ABP Framework v3.1 RC Has Been Released

Released ABP v3.1 RC. Some new features: Angular Service Proxies, Authorization Code Flow for the Angular UI, Global Feature System etc. Learn more... Continue Reading

hikalkan August 2020

ABP Framework v3.0 Has Been Released

Released ABP v3.0. Some new features: Angular 10, The Oracle Integration Package, Azure BLOB Storage Provider etc. Learn more about what's new with... Continue Reading

hikalkan July 2020

ABP Framework v2.9.0 Has Been Released

Released ABP v2.9.0. Some new features: Organization Units System, Blob Storing Package, EF Core Oracle Integration Package, Chat Module Angular UI... Continue Reading

hikalkan June 2020

ABP v2.8.0 Releases & Road Map

Released ABP Framework and ABP Commercial v2.8. Some new features: SignalR Integration Package, RTL Support for the MVC UI, New Lepton Theme Styles... Continue Reading

hikalkan May 2020

ABP Framework v2.7.0 Has Been Released!

Released ABP Framework v2.7. Some new features: Object Extending System, Text Templating Package, Subscribing to the Exceptions etc. Learn more abo... Continue Reading

hikalkan May 2020

ABP Framework v2.3.0 Has Been Released!

Released ABP Framework v2.3. Some new features: React Native Mobile App, Angular TypeScript Proxy Generator, CRUD app service etc. See the GitHub m... Continue Reading

hikalkan March 2020

ABP Framework v2.0 and the ABP Commercial

Released ABP Framework v2.0 and ABP Commercial. See the release notes for changes. Create a demo to see application startup template of ABP Commerc... Continue Reading

hikalkan January 2020

ABP v1.0 Has Been Finally Released

Released the first stable ABP v1.0, after ~3 years of continuous development! Start playing with the new ABP framework now. See the GitHub mileston... Continue Reading

hikalkan October 2019

ABP v0.21 Has Been Released based on the ASP.NET Core 3.0

Released ABP v0.21 with no new feature. The release is just upgrade to the stable AspNet Core 3.0. Check v0.20 release notes for new features, and ... Continue Reading

hikalkan September 2019

ABP v0.19 Release With New Angular UI

Released ABP v0.19 with 90+ issues resolved and 650+ commits pushed. Some new features: Angular UI, Widget System. See the roadmap for all upcomings. Continue Reading

hikalkan August 2019

ABP CLI, New Templates & Features v0.18 Release

Released ABP v0.18 with 80+ issues resolved and 550+ commits pushed. Changes: ABP CLI command line tool, and new startup templates. See the roadmap... Continue Reading

hikalkan June 2019

Microservice Demo, Projects Status and Road Map

See microservice solution demo documentation for a detailed explanation of the solution. It aims to demonstrate a simple yet complete microservice ... Continue Reading

hikalkan February 2019