ABP Version 9.3 Migration Guide

This document is a guide for upgrading ABP v9.2 solutions to ABP v9.3. There are some changes in this version that may affect your applications, please read it carefully and apply the necessary changes to your application.

Switched to MySql.EntityFrameworkCore for EF Core MySQL Provider

In this version, we switched the EF Core MySQL provider from Pomelo.EntityFrameworkCore.MySql to MySql.EntityFrameworkCore.

If you want to use the Pomelo.EntityFrameworkCore.MySql provider, then you can follow the Use Pomelo provider documentation to migrate your application.

See the internal changes we made in #23392, for implementation details.

Updated RabbitMQ.Client to 7.x

In this version, we updated RabbitMQ.Client to 7.1.2. This is a major version update that brings significant improvements to the library:

1. Full async/await support throughout the entire public API and internals
2. Improved performance and resource utilization
3. Better error handling and connection management

With this update, you should update your method calls to use the new async/await support (in the RabbitMQ related provider packages). There are some method signature changes and new API calls, aligned with the new API. You can see the internal changes we made in #22510 and make the relevant changes in your code.

Docs Module: Export as PDF

In this version, we have introduced a new feature to the Docs Module that allows you to export the documentation as a PDF file. (Administrators generate PDF files from the back-office side, and then "Download PDF" button appears on the document system, allowing users to download the compiled documentation as a PDF file.)

While implementing this feature, we have made changes in some services of the Docs Module. Typically, you don't need to make any changes in your code unless you have overridden or used internal services of the Docs Module.

For example, the ProjectAdminAppService constructor has been changed to accept a new parameter:

public class ProjectAdminAppService : ApplicationService, IProjectAdminAppService
{
    public ProjectAdminAppService(
        IProjectRepository projectRepository,
        IDocumentRepository documentRepository,
        IDocumentFullSearch elasticSearchService,
        IGuidGenerator guidGenerator,
+       IProjectPdfFileStore projectPdfFileStore)
}

You can see the all internal changes we made in #22430 and #22922 and make the relevant changes in your code if needed.

Angular UI: Migrating NPM Packages to Standalone Structure

In this version, we've updated our Angular packages to support the new standalone components architecture. This is a non-breaking change - your existing module-based applications will continue to work without any modifications. However, if you wish to migrate to the standalone approach, we've provided the necessary updates in our packages.

The main changes include:

• Updated routing configurations to support both module-based and standalone approaches
• Added support for standalone components in ABP Suite code generation
• Updated schematics to support both module-based and standalone templates

For detailed migration steps and best practices, please refer to our upcoming documentation and/or blog post. The migration is optional, and you can continue using the module-based approach if you prefer.

Angular UI: Migrating Version to v20

In this version, we've updated our Angular version to v20. This update brings our Angular user interface to the latest and most powerful version

Key Updates:

• Updated Angular packages (core, common, forms, router, etc.) to ~20.0.0
• Updated @angular/cli and @angular-devkit/* to ~20.0.0
• Updated Typescript to ~5.8.0
• Updated RxJS to ~7.8.0
• Updated third-party libraries to their latest versions compatible with Angular v20

Breaking Changes:

• Minimum required Node.js version is now v20.19.0
• @angular/platform-browser no longer includes deprecated APIs like DOCUMENT token globally; ensure you're importing from @angular/common