From d463596e14b2ef2a47a2de6536664c736a2b04f7 Mon Sep 17 00:00:00 2001 From: sumeyye Date: Fri, 6 Nov 2026 09:09:45 +0300 Subject: [PATCH] add: 11.0.0.rc-1 blog post --- .../2026-11-06 v11_0_Preview/POST.md | 159 ++++++++++++++++++ .../studio-switch-to-preview.png | Bin 0 -> 34935 bytes .../release-info/migration-guides/abp-11-0.md | 63 +++++++ 3 files changed, 222 insertions(+) create mode 100644 docs/en/Blog-Posts/2026-11-06 v11_0_Preview/POST.md create mode 100644 docs/en/Blog-Posts/2026-11-06 v11_0_Preview/studio-switch-to-preview.png diff --git a/docs/en/Blog-Posts/2026-11-06 v11_0_Preview/POST.md b/docs/en/Blog-Posts/2026-11-06 v11_0_Preview/POST.md new file mode 100644 index 0000000000..77d932aed7 --- /dev/null +++ b/docs/en/Blog-Posts/2026-11-06 v11_0_Preview/POST.md @@ -0,0 +1,159 @@ +# ABP Platform 11.0 RC Has Been Released + +We are happy to release [ABP](https://abp.io) version **11.0 RC** (Release Candidate). This blog post introduces the new features and important changes in this version. + +Try this version and provide feedback to help us deliver a more stable ABP v11.0 release. Thanks in advance! + +## Get Started with the 11.0 RC + +You can check the [Get Started page](https://abp.io/get-started) to see how to get started with ABP. You can either download [ABP Studio](https://abp.io/get-started#abp-studio-tab) (**recommended**, if you prefer a user-friendly GUI application - desktop application) or use the [ABP CLI](https://abp.io/docs/latest/cli). + +By default, ABP Studio uses stable versions to create solutions. Therefore, if you want to create a solution with a preview version, first you need to create a solution and then switch your solution to the preview version from the ABP Studio UI: + +![studio-switch-to-preview](https://raw.githubusercontent.com/abpframework/abp/refs/heads/dev/docs/en/Blog-Posts/2026-11-06%20v11_0_Preview/studio-switch-to-preview.png) + +## Migration Guide + +This version has breaking changes that can affect an existing solution. Read the [ABP Version 11.0 Migration Guide](https://abp.io/docs/11.0/release-info/migration-guides/abp-11-0) before upgrading from v10.x. It covers the move to .NET 11, the MySQL and Oracle EF Core providers, the removed Polly reference, the Docs module PDF and Elasticsearch clients, the MVC UI library replacements, batch permission updates, C# client proxy generation, and the Blogging module's image library. + +## What's New with ABP v11.0? + +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: + +- Upgraded to .NET 11 +- Query Projection for Read-Only Application Services +- FluentValidation Rules in the API Definition +- MVC UI Library Replacements +- Docs Module PDF and Full-Text Search +- C# Client Proxies +- Commercial Module Updates +- Dependency Updates +- Other Improvements and Enhancements + +### Upgraded to .NET 11 + +ABP v11.0 targets .NET 11. Move your solution to .NET 11 if you want to use this version. ABP 11.0 RC references the .NET 11 RC 3 packages (`11.0.0-rc.3`). .NET 11 is a Standard Term Support release, and general availability is planned for November 10, 2026. We will update ABP to the stable .NET 11 SDK after that release. + +The Blazor startup templates use the new `BasePath` component. ABP still converts `float` and `double` extra-property values to `decimal`, which is the .NET 10 behavior. + +The MySQL and Oracle EF Core providers do not work with EF Core 11 in this RC. `MySql.EntityFrameworkCore` 10.0.9, `Oracle.EntityFrameworkCore`, and `Devart.Data.Oracle.EFCore` fail when the `DbContext` is created. Keep applications that use those providers on ABP v10.x until a compatible provider build is available. PostgreSQL, SQL Server, and SQLite are updated with the .NET 11 RC 3 packages. + +> See the [migration guide](https://abp.io/docs/11.0/release-info/migration-guides/abp-11-0) and [#26147](https://github.com/abpframework/abp/pull/26147). + +### Query Projection for Read-Only Application Services + +`GetAsync` and `GetListAsync` on the read-only application services load the entity and then map it to the DTO. You can now project that query to the DTO, so the database returns only the columns the DTO needs. + +Implement `IQueryProjector`. ABP registers it by convention. Nothing changes when no projector is registered. + +```csharp +public class BookProjector : IQueryProjector +{ + public IQueryable ProjectTo(IQueryable source) + { + return source.Select(book => new BookDto + { + Id = book.Id, + Name = book.Name + }); + } +} +``` + +Filters, sorting, and paging still run on the entity query before the projection. A projection has to return one row per entity. Override `CreateGetOutputDtoQueryOrNullAsync` or `CreateGetListOutputDtoQueryOrNullAsync` when the projection has to join another aggregate. Override `GetOutputDtoQueryProjector` or `GetListOutputDtoQueryProjector` and return `null` to keep the in-memory mapping for one application service. + +> See the [application services](https://abp.io/docs/11.0/framework/architecture/domain-driven-design/application-services) document and [#26016](https://github.com/abpframework/abp/pull/26016). + + + +### FluentValidation Rules in the API Definition + +The API definition is built from data annotation attributes. A DTO that is validated only with FluentValidation had no constraints in that model, so the client proxy generators could not see them. + +The new `Volo.Abp.Http.FluentValidation` package publishes FluentValidation rules on the API definition and merges them with the attribute rules. Mapped rules include `NotNull` / `NotEmpty`, length, `Matches`, numeric bounds, and between. Conditional rules, non-default rule sets, `RuleForEach`, and comparisons against another property are not published, because they do not apply to every instance of the DTO. + +Add the package to the project that hosts the HTTP API: + +```bash +abp add-package Volo.Abp.Http.FluentValidation +``` + +> See the [FluentValidation](https://abp.io/docs/11.0/framework/fundamentals/fluent-validation) document and [#26112](https://github.com/abpframework/abp/pull/26112). + +### MVC UI Library Replacements + +Several unmaintained MVC UI libraries are replaced or removed: + +- Owl Carousel is replaced by Swiper (`@abp/swiper`, `SwiperScriptContributor`, and `SwiperStyleContributor`). +- The malihu custom scrollbar plugin is removed. The docs, feature management, and permission management pages use the browser scrollbar. +- `@abp/timeago` now depends on `timeago.js` 4.x instead of the `timeago` 1.x package. +- The unused `jquery-form` and `toastr` npm packages are no longer brought in by ABP packages. ABP toast notifications stay on ABP's own implementation. + +Applications that call these libraries directly need a small follow-up. The steps are in the migration guide. + +> See [#26005](https://github.com/abpframework/abp/pull/26005), [#26000](https://github.com/abpframework/abp/pull/26000), [#26001](https://github.com/abpframework/abp/pull/26001), and [#26002](https://github.com/abpframework/abp/pull/26002). + +### Docs Module PDF and Full-Text Search + +The Docs module no longer uses the AGPL-licensed iText packages to render PDF files. `PdfSharpHtmlToPdfRenderer` is the new `IHtmlToPdfRenderer`, based on HtmlRenderer.PdfSharp and PDFsharp. It uses the fonts installed on the server. Linux hosts need a font package such as `fonts-dejavu-core` or `fonts-liberation`, and Chinese, Japanese, and Korean documents need a TrueType font listed first in `HtmlStyle`. + +Full-text search uses `Elastic.Clients.Elasticsearch` 8.x instead of the deprecated NEST 7 client. The new client works with Elasticsearch 8.x and 9.x. The index name, mapping, and stored documents are unchanged. Elasticsearch 7.x servers need to be upgraded, and custom `IElasticClientProvider` implementations need to use the new client types. + +> See the [Docs module](https://abp.io/docs/11.0/modules/docs) document and [#26216](https://github.com/abpframework/abp/pull/26216). + +### C# Client Proxies + +The C# client proxy generator now generates only the contract types that are reachable from application service signatures. Types that the client project already references are not generated again. Nested, generic, and same-named types that appear in a signature are still generated. + +Regenerate the proxies after upgrading. If your application compiled against a generated type that is not part of a service signature, reference that contract from its package instead. + +> See [#26205](https://github.com/abpframework/abp/pull/26205). + +### Commercial Module Updates + +- **Localization:** Korean (`ko`) resources are added for the commercial modules, and Portuguese (`pt`) is added for the Account module ([#26115](https://github.com/abpframework/abp/pull/26115)). +- **Account:** Password fields have an accessible show/hide control. +- **CMS Kit Pro:** The Blazor page editor can publish a page and save it as a draft. +- **AI Management:** An MCP session is recovered after it expires, after the workspace configuration changes, and after the application shuts down. +- **ABP Suite:** Generated test classes are `partial`, so additional tests can live in a separate file. + + + +### Dependency Updates + +ABP v11.0 RC also includes these dependency changes: + +- Polly is no longer referenced by the framework or by Language Management and Text Template Management. ABP retries with `Volo.Abp.Threading.RetryHelper`. Reference the `Polly` package yourself if your code uses it. ABP referenced Polly 8.6.3 up to v10.7. +- `MongoDB.Driver` is upgraded to **3.13.0**. +- The Blogging module detects image formats with SkiaSharp and no longer references ImageSharp. +- Commercial Angular packages in this RC pick up Angular 22.1. + +> Check the [Package Version Changes](https://abp.io/docs/11.0/package-version-changes) document for the full list. + +### Other Improvements and Enhancements + +- **Permissions:** `IPermissionManager` can update many permissions in one call. The permission management UI uses that overload, so a custom manager has to implement it. See [#26126](https://github.com/abpframework/abp/pull/26126). +- **Feature management:** MongoDB no longer raises an entity-updated event when the stored feature value is already the requested value. +- **Client proxies:** Path values are encoded, and the API version parameter is passed correctly in the Angular and jQuery proxies. +- **Identity:** Revoked sessions are rejected when remote dynamic claims are refreshed. + +## Community News + +### New ABP Community Articles + +As always, exciting articles have been contributed by the ABP community. I will highlight some of them here: + +- [.NET 11 in Practice: FullJoin, Async Validation, Cache Metrics, Tracing Rules](https://abp.io/community/articles/net11-in-practice-fulljoin-async-validation-cache-tracing-57ve6uql) by [Ahmet Çelik](https://github.com/ahmetcelik05) +- [EF Core 11 Query Improvements: GroupBy, FullJoin, MaxBy, and MinBy](https://abp.io/community/articles/ef-core-11-query-improvements-groupby-fulljoin-maxby-and-minby-ldyi3n03) by [Zeynep Gizem Fırat](https://github.com/gizemfirat) +- [C# 15 Union Types and Closed Hierarchies in .NET 11](https://abp.io/community/articles/c-15-union-types-and-closed-hierarchies-in-.net-11-ixs91te3) by [Engincan Veske](https://github.com/EngincanV) + +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. + +## Conclusion + +This version moves ABP to .NET 11 and includes new framework features together with dependency and UI library changes. You can see the [Road Map](https://abp.io/docs/11.0/release-info/road-map) documentation to learn about the release schedule and planned features for the next releases. Please try ABP v11.0 RC and provide feedback to help us release a more stable version. + +For the complete list of changes, see the [ABP 11.0.0-rc.1 release notes](https://github.com/abpframework/abp/releases/tag/11.0.0-rc.1). + +Thanks for being a part of this community! diff --git a/docs/en/Blog-Posts/2026-11-06 v11_0_Preview/studio-switch-to-preview.png b/docs/en/Blog-Posts/2026-11-06 v11_0_Preview/studio-switch-to-preview.png new file mode 100644 index 0000000000000000000000000000000000000000..ad738778341cc29e420bed73600b67211a3075a4 GIT binary patch literal 34935 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 literal 0 HcmV?d00001 diff --git a/docs/en/release-info/migration-guides/abp-11-0.md b/docs/en/release-info/migration-guides/abp-11-0.md index 2c347bc1e2..a0f473f260 100644 --- a/docs/en/release-info/migration-guides/abp-11-0.md +++ b/docs/en/release-info/migration-guides/abp-11-0.md @@ -15,6 +15,69 @@ This document is a guide for upgrading ABP v10.x solutions to ABP v11.0. There a This version contains the following changes on the open-source side: +### Upgrade to .NET 11 + +ABP v11.0 targets .NET 11. Move your solution to .NET 11 before upgrading the ABP packages. ABP 11.0.0-rc.1 references the .NET 11 RC 3 packages (`11.0.0-rc.3`). .NET 11 is a Standard Term Support release. General availability is planned for November 10, 2026, so this RC follows the .NET 11 release candidate rather than the stable SDK. + +See [What's new in .NET 11](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-11/overview) while you update the target framework and the ASP.NET Core, EF Core, and related package versions. The Blazor startup templates adopt the `BasePath` component, and ABP keeps the .NET 10 conversion of `float` and `double` extra-property values to `decimal`. + +### MVC UI Libraries + +**Who is affected** + +- Applications that reference `@abp/owl.carousel`, `OwlCarouselScriptContributor`, or `OwlCarouselStyleContributor`. +- Applications that reference `@abp/malihu-custom-scrollbar-plugin` or the Malihu scrollbar bundle contributors. +- Applications that call the `timeago` 1.x jQuery API directly. `@abp/timeago` now depends on `timeago.js` 4.x, and the bundled file is `/libs/timeago/timeago.full.min.js`. +- Applications that imported the `jquery-form` or `toastr` npm packages through an ABP package and do not reference them themselves. + +**What changed** + +- Owl Carousel is replaced by [Swiper](https://swiperjs.com/). The new packages are `@abp/swiper`, `SwiperScriptContributor`, and `SwiperStyleContributor`. `@abp/owl.carousel` and the Owl Carousel contributors are removed. +- The malihu custom scrollbar plugin is removed. The docs, feature management, and permission management pages use the browser scrollbar. +- `@abp/timeago` still contributes `TimeagoScriptContributor` and `abp.timeago.js`, and it loads `timeago.js` instead of the unmaintained `timeago` 1.x package. +- The unused `jquery-form` and `toastr` npm packages are no longer brought in by ABP. ABP toast notifications stay on ABP's own implementation. + +**What to do** + +- Replace Owl Carousel markup and initialization with Swiper if your pages called the Owl Carousel API. +- Remove malihu scrollbar initialization and any bundle contributor references. +- Review custom `timeago` calls against the [timeago.js](https://github.com/hustcc/timeago.js) 4.x API. +- Add your own `jquery-form` or `toastr` package reference if your pages still load those libraries. + +> See [#26005](https://github.com/abpframework/abp/pull/26005), [#26000](https://github.com/abpframework/abp/pull/26000), [#26001](https://github.com/abpframework/abp/pull/26001), and [#26002](https://github.com/abpframework/abp/pull/26002). + +### C# Client Proxies Generate Only Used Types + +**Who is affected** + +- Applications that regenerate C# client proxies and compile against generated contract types that are not reachable from an application service signature. + +**What changed** + +`CSharpServiceProxyGenerator` generates only the contract types reachable from service signatures. Types that are already referenced from the client project's assets are not generated again. Nested, generic, and same-named types that appear in signatures are still generated. + +**What to do** + +Reference the contract package, or keep a local type, for any DTO you use that the generator no longer emits. Regenerate the proxies after upgrading. + +> See [#26205](https://github.com/abpframework/abp/pull/26205) for details. + +### Blogging Module Uses SkiaSharp + +**Who is affected** + +- Applications that use SixLabors.ImageSharp in their own code without referencing it themselves, and get it through the Blogging module. + +**What changed** + +The Blogging module detects uploaded image formats with SkiaSharp (`SKCodec`) and no longer references `SixLabors.ImageSharp`. + +**What to do** + +Reference `SixLabors.ImageSharp` in the projects that use it. + +> See [#26264](https://github.com/abpframework/abp/pull/26264) for details. + ### Batch Permission Update **Who is affected**