Browse Source

Prepare ABP 10.6 release docs

Co-authored-by: Cursor <cursoragent@cursor.com>
pull/25877/head
Engincan VESKE 2 weeks ago
parent
commit
fbb69f46ee
  1. 81
      docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/POST.md
  2. BIN
      docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/upgrade-abp-packages.png
  3. 17
      docs/en/release-info/migration-guides/abp-10-6.md
  4. 1
      docs/en/release-info/migration-guides/index.md

81
docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/POST.md

@ -0,0 +1,81 @@
# 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:
- [Angular 22 State Management: Signals, SignalStore, or NgRx?](https://abp.io/community/articles/angular-22-state-management-signals-signalstore-or-ngrx-yq8zg0nw) by [Sumeyye Kurtulus](https://abp.io/community/members/sumeyye.kurtulus)
- [Working with Dapr Workflows in the ABP Framework](https://abp.io/community/articles/working-with-dapr-workflows-in-the-abp-framework-6476or18) by [Engincan Veske](https://abp.io/community/members/EngincanV)
- [Customizing the ABP Framework: A Developer's Guide to LeptonX Theme Overrides in Angular and the Transition to React UI](https://abp.io/community/articles/customizing-the-abp-framework-a-developers-guide-to-nklweri3) by [Sumeyye Kurtulus](https://abp.io/community/members/sumeyye.kurtulus)
- [Deep Dive on ABP AI Agent: The Complete Series](https://abp.io/community/articles/deep-dive-on-abp-ai-agent-the-complete-series-f7jute7n) by [Berkan Sasmaz](https://abp.io/community/members/berkansasmaz)
- [ABP 10.5.0 Expands Blazor UI Options with MudBlazor Support](https://abp.io/community/articles/abp-10.5.0-expands-blazor-ui-options-with-mudblazor-support-03rzmlpm) by [Liming Ma](https://abp.io/community/members/maliming)
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.

BIN
docs/en/Blog-Posts/2026-07-27 v10_6_Release_Stable/upgrade-abp-packages.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

17
docs/en/release-info/migration-guides/abp-10-6.md

@ -7,7 +7,7 @@
# ABP Version 10.6 Migration Guide # 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. > **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** **Who is affected**
- Applications using the default background job worker and wanting dedicated workers, parallel execution, or successful job retention. - 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. - Applications using the Background Jobs module with EF Core and enabling successful job retention.
**What changed** **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. 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: 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** **Who is affected**
- Applications that pin ABP transitive dependencies directly. - 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** **What changed**
- `Microsoft.*` and `System.*` packages were upgraded to **10.0.9**. - `Microsoft.*` and `System.*` packages were upgraded to **10.0.9**.
- `Microsoft.Data.SqlClient` was upgraded to **7.0.2**. - `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**. - `Swashbuckle.AspNetCore` was upgraded to **10.2.3**.
- ABP Angular packages were upgraded to **Angular 22.0.x**. - 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. - 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`. - 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. - Re-test Swagger/OpenAPI integration if you customized Swashbuckle configuration.
## Pro ## 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 ### 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** **Who is affected**
- Applications using the AI Management module with document indexing enabled. - Applications using the AI Management module with document indexing enabled.
- Applications that replace or customize `IDocumentChunkRepository`.
**What changed** **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** **What to do**
- Re-test document indexing on large datasets or memory-constrained environments after upgrading. - 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`.

1
docs/en/release-info/migration-guides/index.md

@ -10,6 +10,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). 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).
- [10.5 to 10.6](abp-10-6.md) - [10.5 to 10.6](abp-10-6.md)
- [Angular 22 and ABP 10.6 Upgrade Guide](abp-10-6-angular-22.md)
- [10.4 to 10.5](abp-10-5.md) - [10.4 to 10.5](abp-10-5.md)
- [10.3 to 10.4](abp-10-4.md) - [10.3 to 10.4](abp-10-4.md)
- [10.x to 10.3](abp-10-3.md) - [10.x to 10.3](abp-10-3.md)

Loading…
Cancel
Save