diff --git a/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/POST.md b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/POST.md new file mode 100644 index 0000000000..0bd7f03378 --- /dev/null +++ b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/POST.md @@ -0,0 +1,80 @@ +# ABP.IO Platform 10.6 Final Has Been Released! + +We are glad to announce that [ABP](https://abp.io/) 10.6 stable version has been released. + +## What's New With Version 10.6? + +All the new features were explained in detail in the [10.6 RC Announcement Post](https://abp.io/community/announcements/abp-platform-10.6-rc-has-been-released-reoq6kzw), so there is no need to review them all again. You can check it out for more details. + +Here are some of the highlights of this version: + +- Background jobs now support dedicated workers, parallel execution, and successful job retention. +- API definition and generated proxies have better support for response content types, remote streams, and multipart uploads. +- Angular UI packages and templates have been upgraded to Angular 22. +- Antiforgery and OpenIddict flows include important security and reliability improvements. +- ABP Commercial adds OpenIddict access-token generation from the UI and React CRUD page generation support in ABP Suite. +- AI Management indexing is more resilient for large or memory-constrained workloads. +- The final release also includes dependency updates and stability fixes collected during the RC period. + +## Getting Started with 10.6 + +### How to Upgrade an Existing Solution + +You can upgrade your existing solutions with either ABP Studio or ABP CLI. In the following sections, both approaches are explained: + +### Upgrading via ABP Studio + +If you are already using the ABP Studio, you can upgrade it to the latest version. ABP Studio periodically checks for updates in the background, and when a new version of ABP Studio is available, you will be notified through a modal. Then, you can update it by confirming the opened modal. See [the documentation](https://abp.io/docs/latest/studio/installation#upgrading) for more info. + +After upgrading the ABP Studio, then you can open your solution in the application, and simply click the **Upgrade ABP Packages** action button to instantly upgrade your solution: + +![](upgrade-abp-packages.png) + +### Upgrading via ABP CLI + +Alternatively, you can upgrade your existing solution via ABP CLI. First, you need to install the ABP CLI or upgrade it to the latest version. + +If you haven't installed it yet, you can run the following command: + +```bash +dotnet tool install -g Volo.Abp.Studio.Cli +``` + +Or to update the existing CLI, you can run the following command: + +```bash +dotnet tool update -g Volo.Abp.Studio.Cli +``` + +After installing/updating the ABP CLI, you can use the [`update` command](https://abp.io/docs/latest/CLI#update) to update all the ABP related NuGet and NPM packages in your solution as follows: + +```bash +abp update +``` + +You can run this command in the root folder of your solution to update all ABP related packages. + +## Migration Guides + +This version includes explicitly marked migration-impacting changes for specific customization scenarios, especially custom background job stores/workers and custom AI Management document chunk repositories. The new background job runtime features are opt-in and existing applications keep the current behavior unless they enable them explicitly. + +Please read the migration guide carefully, if you are upgrading from v10.5 or earlier versions: [ABP Version 10.6 Migration Guide](https://abp.io/docs/10.6/release-info/migration-guides/abp-10-6) + +If you use the Angular UI, also check the dedicated [Angular 22 and ABP 10.6 Upgrade Guide](https://abp.io/docs/10.6/release-info/migration-guides/abp-10-6-angular-22). + +## Community News + +### New ABP Community Articles + +As always, exciting articles have been contributed by the ABP community. I will highlight some of them here: + +- [Introducing ABP Low-Code: Build Real ABP Apps in Minutes](https://abp.io/community/announcements/introducing-abp-lowcode-build-real-abp-apps-in-minutes-647ymozi) by [Salih Ozkara](https://abp.io/community/members/salih) +- [Building a Vendor Onboarding Workflow with ABP Low-Code](https://abp.io/community/articles/building-a-vendor-onboarding-workflow-with-abp-lowcode-1wx0ckzc) by [Salih Ozkara](https://abp.io/community/members/salih) +- [Event Recap - WeAreDevelopers World Congress 2026](https://abp.io/community/articles/event-recap-wearedevelopers-world-congress-2026-v59t8vfn) by [Irem Demirci](https://abp.io/community/members/iremdemirci) +- [Empathy in the Workplace for Software Companies](https://abp.io/community/articles/empathy-in-the-workplace-for-software-companies-wsjjw9we) by [Alper Ebicoglu](https://abp.io/community/members/alper) + +Thanks to the ABP Community for all the content they have published. You can also [post your ABP related (text or video) content](https://abp.io/community/posts/create) to the ABP Community. + +## About the Next Version + +The next feature version will be 10.7. You can follow the [release planning here](https://github.com/abpframework/abp/milestones). Please [submit an issue](https://github.com/abpframework/abp/issues/new) if you have any problems with this version. diff --git a/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/cover-image.png b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/cover-image.png new file mode 100644 index 0000000000..a1583a17f9 Binary files /dev/null and b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/cover-image.png differ diff --git a/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/upgrade-abp-packages.png b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/upgrade-abp-packages.png new file mode 100644 index 0000000000..4ec1d19589 Binary files /dev/null and b/docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/upgrade-abp-packages.png differ diff --git a/docs/en/release-info/migration-guides/abp-10-6.md b/docs/en/release-info/migration-guides/abp-10-6.md index 724e30ec2b..7015eabbaa 100644 --- a/docs/en/release-info/migration-guides/abp-10-6.md +++ b/docs/en/release-info/migration-guides/abp-10-6.md @@ -7,7 +7,7 @@ # ABP Version 10.6 Migration Guide -This document is a guide for upgrading ABP v10.5 solutions to ABP v10.6. There are some important changes that may require action in specific application scenarios. +This document is a guide for upgrading ABP v10.5 solutions to ABP v10.6. This version includes explicitly marked migration-impacting changes for specific customization scenarios, while most applications can upgrade with no additional action beyond the notes below. > **Package Version Changes:** Before upgrading, review the [Package Version Changes](../../package-version-changes.md) document to see version changes on dependent NuGet and NPM packages and align your project with ABP's internal package versions. @@ -20,7 +20,7 @@ This version contains the following changes on the open-source side: **Who is affected** - Applications using the default background job worker and wanting dedicated workers, parallel execution, or successful job retention. -- Applications with a custom `IBackgroundJobStore` implementation. +- Applications with a custom `IBackgroundJobStore` or `IBackgroundJobWorker` implementation. - Applications using the Background Jobs module with EF Core and enabling successful job retention. **What changed** @@ -37,7 +37,7 @@ This version contains the following changes on the open-source side: No action is required if you do not enable the new options and do not maintain a custom background job store. -If you maintain a custom `IBackgroundJobStore`, implement the new interface members so your solution compiles. +If you maintain a custom `IBackgroundJobStore` or `IBackgroundJobWorker`, implement the new interface members so your solution compiles. If you enable `StoreSuccessfulJobs`, add/review the EF Core migration for the `CompletionTime` column and configure retention options explicitly: @@ -187,12 +187,13 @@ No action is required. Re-test authorization, account, and audit-log scenarios i **Who is affected** - Applications that pin ABP transitive dependencies directly. -- Applications using `Microsoft.Data.SqlClient`, Swashbuckle, or Angular with fixed versions. +- Applications using `Microsoft.Data.SqlClient`, MongoDB.Driver, Swashbuckle, or Angular with fixed versions. **What changed** - `Microsoft.*` and `System.*` packages were upgraded to **10.0.9**. - `Microsoft.Data.SqlClient` was upgraded to **7.0.2**. +- MongoDB.Driver was upgraded to **3.10.0**. - `Swashbuckle.AspNetCore` was upgraded to **10.2.3**. - ABP Angular packages were upgraded to **Angular 22.0.x**. @@ -200,11 +201,12 @@ No action is required. Re-test authorization, account, and audit-log scenarios i - Review your direct package references and align them with ABP's package versions where needed. - Rebuild and run database/integration tests if you directly use `Microsoft.Data.SqlClient`. +- Re-test MongoDB integrations if your solution directly references MongoDB.Driver packages. - Re-test Swagger/OpenAPI integration if you customized Swashbuckle configuration. ## Pro -There are no explicitly marked breaking changes on the PRO side in this release scope. However, check the following if they apply to your application. +This version contains the following changes on the PRO side: ### OpenIddict Generate Access Token UI @@ -227,11 +229,14 @@ There are no explicitly marked breaking changes on the PRO side in this release **Who is affected** - Applications using the AI Management module with document indexing enabled. +- Applications that replace or customize `IDocumentChunkRepository`. **What changed** -- Indexing is more resilient under memory pressure. +- Indexing is more resilient under memory pressure by coordinating work in bounded batches. +- `IDocumentChunkRepository` includes a new paged datasource query overload used by bounded batch indexing. **What to do** - Re-test document indexing on large datasets or memory-constrained environments after upgrading. +- If your application implements `IDocumentChunkRepository` directly, add the new overload and return chunks for the datasource ordered by `ChunkIndex`, starting at `startChunkIndex`, limited to `maxResultCount`. diff --git a/docs/en/release-info/release-notes.md b/docs/en/release-info/release-notes.md index 1dc34341f0..ddf893a60a 100644 --- a/docs/en/release-info/release-notes.md +++ b/docs/en/release-info/release-notes.md @@ -14,7 +14,7 @@ Also see the following notes about ABP releases: - [ABP Studio release notes](../studio/release-notes.md) - [Change logs for ABP pro packages](https://abp.io/pro-releases) -## 10.6 (2026-07-07) +## 10.6 (2026-07-27) See the detailed **[blog post / announcement](https://abp.io/community/announcements/announcing-abp-10-6-release-candidate-reoq6kzw)** for the v10.6 release.