abp/docs/en/Blog-Posts/2024-02-16 v8_1_Preview/POST.md

ABP.IO Platform 8.1 RC Has Been Released

Today, we are happy to release the ABP Framework and ABP Commercial version 8.1 RC (Release Candidate). This blog post introduces the new features and important changes in this new version.

Try this version and provide feedback for a more stable version of ABP v8.0! Thanks to all of you.

Get Started with the 8.1 RC

Follow the steps below to try version 8.1.0 RC today:

1. Upgrade the ABP CLI to version 8.1.0-rc.1 using a command line terminal:

dotnet tool update Volo.Abp.Cli -g --version 8.1.0-rc.1

or install it if you haven't before:

dotnet tool install Volo.Abp.Cli -g --version 8.1.0-rc.1

2. Create a new application with the --preview option:

abp new BookStore --preview

See the ABP CLI documentation for all the available options.

You can also use the Get Started page to generate a CLI command to create a new application.

You can use any IDE that supports .NET 8.x, like Visual Studio 2022.

Migration Guides

There are a few breaking changes in this version that may affect your application. Please see the following migration documents, if you are upgrading from v8.x or earlier:

• ABP Framework 8.0 to 8.1 Migration Guide
• ABP Commercial 8.0 to 8.1 Migration Guide

What's New with ABP Framework 8.1?

In this section, I will introduce some major features released in this version. Here is a brief list of titles explained in the next sections:

• Introducing the ExposeKeyedServiceAttribute
• Custom Menu Component Support for MVC UI
• Introducing the DisableAbpFeaturesAttribute

Introducing the ExposeKeyedServiceAttribute

Keyed dependency injection (DI) services were added to the built-in DI container as a new feature with .NET 8.0. This is an important feature, which allows for registering and retrieving DI services using keys/names.

In this version, we have introduced the ExposeKeyedServiceAttribute to allow you to automatically register keyed services by conventions.

Example:

[ExposeKeyedService<ITaxCalculator>("taxCalculator")]
[ExposeKeyedService<ICalculator>("calculator")]
public class TaxCalculator: ICalculator, ITaxCalculator, ICanCalculate, ITransientDependency
{
}

In the example above, the TaxCalculator class exposes the ITaxCalculator interface with the key taxCalculator and the ICalculator interface with the key calculator.

Thanks to that, you can use the FromKeyedServicesAttribute to resolve a certain keyed service in the constructor:

public class MyClass
{
    //...
    public MyClass([FromKeyedServices("taxCalculator")] ITaxCalculator taxCalculator)
    {
        TaxCalculator = taxCalculator;
    }
}

Notice that the ExposeKeyedServiceAttribute only exposes the keyed services. So, you can not inject the ITaxCalculator or ICalculator interfaces in your application without using the FromKeyedServicesAttribute as shown in the example above.

If you want to learn more about the keyed dependency injection services, please refer to the Microsoft's documentation and ABP Framework's Dependency Injection document.

Custom Menu Component Support for MVC UI

In this version, we have introduced the custom menu component support, which allows you to use a custom component for a certain menu item.

You can use the UseComponent extension method while defining menu items to use your custom component for the related menu item:

context.Menu.Items.Add(
  new ApplicationMenuItem("Custom.1", "My Custom Menu", "#")
    .UseComponent(typeof(MyMenuComponent)));

Then, for the related menu item, your custom component will be rendered on the UI.

Introducing the DisableAbpFeaturesAttribute

In this version, we have introduced the DisableAbpFeaturesAttribute to allow you to disable interceptors, middlewares, and MVC filters for a specific controller.

For example, you may want to disable interceptors for a certain controller, but you may also don't want to disable middlewares and mvc filters, in that case, you can use the DisableAbpFeaturesAttribute as follows:

[Route("api/my-endpoint")]
[DisableAbpFeatures(DisableInterceptors = true, DisableMiddleware = false, DisableMvcFilters = false)]
public class MyController : AbpController
{

}

This can be useful if you have some APIs that are used frequently but you don't need all the features of ABP Framework.

Note: If you want to disable all interceptors, middlewares, and filters for a certain controller, then you can use the [DisableAbpFeatures] without the need to specify the parameters, they are disabled by default.

What's New with ABP Commercial 8.1?

We've also worked on ABP Commercial to align the features and changes made in the ABP Framework. The following sections introduce a few new features coming with ABP Commercial 8.1.

//TODO:!!!

Community News

.NET Conf China 2023 Watch Party

ABP.IO was thrilled to sponsor the first .NET Community event in 2024 held in Shenzen on January 14, 2024.

The event included four wonderful technical lectures to reveal big data and AI's potential opportunities and innovations. It was a transfer of knowledge and a platform for communication and cooperation among technology enthusiasts and we are happy to being attended.

If you want to learn more about the .NET Conf China 2023 Watch Party event, please check the blog post.

Volosoft Attended NDC London 2024

Core team members of the ABP Framework, Halil Ibrahim Kalkan, Alper Ebicoglu, Engincan Veske, and Bige Beşikci Yaman attended NDC London 2024 from the 31st of January to the 2nd of February.

It was the 5th time in a row we were a proud sponsor of NDC London. It, now, basically feels like home spending 3 days in Queen Elizabeth Centre II with NDC London for the ABP.IO team to be there.

These 3 days with the team was all about chatting and having fun with amazing attendees and speakers. We met with talented and passionate software developers and introduced the open source ABP Framework - web application framework built on ASP.NET Core and ABP Commercial - the complete web application development platform built on open source ABP Framework - to them.

We shared our insights and key highlights from the NDC London 2024 event, which you can find at https://blog.abp.io/abp/NDC-London-2024-ABP.IO-Key-Highlights.

New ABP Community Articles

There are exciting articles contributed by the ABP community as always. I will highlight some of them here:

• Every Programmer Should Know #2: Optimistic Concurrency Control by Berkan Sasmaz
• Global Error Handling in Angular by Sinan Öztürk
• ABP Framework goes Azure by Bart Van Hoey
• ABP Supports .NET8 by Alper Ebicoglu
• Engincan Veske has created three new community articles:
  • ABP Now Supports Keyed Services!
  • Mutation Testing in C# with Stryker
  • ABP Suite: Best CRUD Page Generation Tool for .NET
• Ahmed Tarek has created nine new community articles:
  • 📑 Cover IO Based Apps With Unit Tests in .NET C# 🧪
  • Better Enhanced Repository Pattern Implementation in .NET C#
  • When Not To Use DI, IoC, and IoC Containers in .NET C#
  • ⏰ Best Practice for Using Timers in .NET C# ⏳
  • How to Fully Cover .NET C# Console Application With Unit Tests
  • Web Scraping in .NET C#
  • Step by step guide to develop a Fluent API from scratch in .NET C# using the Builder Design Pattern
  • A Best Practice for Designing Interfaces in .NET C#
  • Invariance, Covariance, and Contravariance in .NET C#

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

Conclusion

This version comes with some new features and a lot of enhancements to the existing features. You can see the Road Map documentation to learn about the release schedule and planned features for the next releases. Please try ABP v8.1 RC and provide feedback to help us release a more stable version.

Thanks for being a part of this community!