From 41829f7509d1e739e3d9f002b7e5b91723780ae1 Mon Sep 17 00:00:00 2001 From: EngincanV Date: Tue, 17 Jun 2025 14:15:29 +0300 Subject: [PATCH 1/3] Create v9.3 Migration Guide --- .../release-info/migration-guides/abp-9-3.md | 45 +++++++++++++++++++ .../en/release-info/migration-guides/index.md | 1 + 2 files changed, 46 insertions(+) create mode 100644 docs/en/release-info/migration-guides/abp-9-3.md diff --git a/docs/en/release-info/migration-guides/abp-9-3.md b/docs/en/release-info/migration-guides/abp-9-3.md new file mode 100644 index 0000000000..f2aa05ae49 --- /dev/null +++ b/docs/en/release-info/migration-guides/abp-9-3.md @@ -0,0 +1,45 @@ +# 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. + +## Open-Source (Framework) + +### Updated `RabbitMQ.Client` to `7.x` + +In this version, we updated `RabbitMQ.Client` to `7.1.2`. [This is a major version update](https://github.com/rabbitmq/rabbitmq-dotnet-client/blob/main/v7-MIGRATION.md) 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](https://github.com/abpframework/abp/pull/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](../../modules/docs.md) that allows you to export the documentation as a PDF file. (Adminstrators 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: + +```diff +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](https://github.com/abpframework/abp/pull/22430) and [#22922](https://github.com/abpframework/abp/pull/22922) and make the relevant changes in your code if needed. + +## PRO + +> Please check the **Open-Source (Framework)** section before reading this section. The listed topics might affect your application and you might need to take care of them. + +### Angular UI: Migrating NPM Packages to Standalone Structure + +//TODO: ... \ No newline at end of file diff --git a/docs/en/release-info/migration-guides/index.md b/docs/en/release-info/migration-guides/index.md index 4a8eaaf467..e09c41c952 100644 --- a/docs/en/release-info/migration-guides/index.md +++ b/docs/en/release-info/migration-guides/index.md @@ -2,6 +2,7 @@ The following documents explain how to migrate your existing ABP applications. We write migration documents only if you need to take an action while upgrading your solution. Otherwise, you can easily upgrade your solution using the [abp update command](../upgrading.md). +- [9.2 to 9.3](abp-9-3.md) - [9.x to 9.2](abp-9-2.md) - [9.0 to 9.1](abp-9-1.md) - [8.x to 9.0](abp-9-0.md) From dcec9b367bc91bfc41aa6c9adbfb9ae6ad426585 Mon Sep 17 00:00:00 2001 From: Engincan VESKE Date: Tue, 17 Jun 2025 11:24:46 +0000 Subject: [PATCH 2/3] Update docs/en/release-info/migration-guides/abp-9-3.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/en/release-info/migration-guides/abp-9-3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/release-info/migration-guides/abp-9-3.md b/docs/en/release-info/migration-guides/abp-9-3.md index f2aa05ae49..1776122aa8 100644 --- a/docs/en/release-info/migration-guides/abp-9-3.md +++ b/docs/en/release-info/migration-guides/abp-9-3.md @@ -16,7 +16,7 @@ With this update, you should update your method calls to use the new async/await ### Docs Module: Export as PDF -In this version, we have introduced a new feature to the [Docs Module](../../modules/docs.md) that allows you to export the documentation as a PDF file. (Adminstrators 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.) +In this version, we have introduced a new feature to the [Docs Module](../../modules/docs.md) 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. From 11088e3eb5231922f4f6e3928dfe3a8151fd05c9 Mon Sep 17 00:00:00 2001 From: EngincanV Date: Tue, 17 Jun 2025 16:26:12 +0300 Subject: [PATCH 3/3] Update abp-9-3.md --- .../en/release-info/migration-guides/abp-9-3.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/en/release-info/migration-guides/abp-9-3.md b/docs/en/release-info/migration-guides/abp-9-3.md index 1776122aa8..3d085eba7d 100644 --- a/docs/en/release-info/migration-guides/abp-9-3.md +++ b/docs/en/release-info/migration-guides/abp-9-3.md @@ -2,9 +2,7 @@ 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. -## Open-Source (Framework) - -### Updated `RabbitMQ.Client` to `7.x` +## Updated `RabbitMQ.Client` to `7.x` In this version, we updated `RabbitMQ.Client` to `7.1.2`. [This is a major version update](https://github.com/rabbitmq/rabbitmq-dotnet-client/blob/main/v7-MIGRATION.md) that brings significant improvements to the library: @@ -14,7 +12,7 @@ In this version, we updated `RabbitMQ.Client` to `7.1.2`. [This is a major versi 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](https://github.com/abpframework/abp/pull/22510) and make the relevant changes in your code. -### Docs Module: Export as PDF +## Docs Module: Export as PDF In this version, we have introduced a new feature to the [Docs Module](../../modules/docs.md) 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.) @@ -36,10 +34,13 @@ public class ProjectAdminAppService : ApplicationService, IProjectAdminAppServic You can see the all internal changes we made in [#22430](https://github.com/abpframework/abp/pull/22430) and [#22922](https://github.com/abpframework/abp/pull/22922) and make the relevant changes in your code if needed. -## PRO +## Angular UI: Migrating NPM Packages to Standalone Structure -> Please check the **Open-Source (Framework)** section before reading this section. The listed topics might affect your application and you might need to take care of them. +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](https://github.com/abpframework/abp/pull/22829). -### Angular UI: Migrating NPM Packages to Standalone Structure +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 -//TODO: ... \ No newline at end of file +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. \ No newline at end of file