From f986f14aeb98ef064cdfd23061a7b0f6aa55c085 Mon Sep 17 00:00:00 2001 From: enisn Date: Thu, 10 Mar 2022 11:18:00 +0300 Subject: [PATCH 1/2] Add 5.2 Migration Guide --- docs/en/Migration-Guides/Abp-5_2.md | 45 ++++++++++++++++++++++++++++- docs/en/Migration-Guides/Index.md | 1 + 2 files changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/en/Migration-Guides/Abp-5_2.md b/docs/en/Migration-Guides/Abp-5_2.md index 3a98e948ae..f0c7a4eaac 100644 --- a/docs/en/Migration-Guides/Abp-5_2.md +++ b/docs/en/Migration-Guides/Abp-5_2.md @@ -1,3 +1,46 @@ # ABP Version 5.2 Migration Guide -TODO \ No newline at end of file +This document is a guide for upgrading ABP 5.1 solutions to ABP 5.2. Please read them all since 5.2 has some important breaking changes. + + +## Blazor UI +If you use Blazor WASM or Blazor Server UI, you should follow this section. + +### Blazorise 1.0 +We've upgraded to Blazorise 1.0 stable version. So there is some breaking changes that you have to apply in your project. + +Also You can review that pull request [#11649 - Blazorise 1.0 Migration](https://github.com/abpframework/abp/pull/11649) + +- `NumericEdit` is now made around the native `input type="number"` so a lot of its formating features are moved to the new `NumericPicker` component. Replace NumericEdit with NumericPicker. +- Rename `DecimalsSeparator` to `DecimalSeparator` on the `DataGridColumn` and `NumericPicker`. +- Rename `MaxMessageSize` to `MaxChunkSize`. +- Remove `Fullscreen` parameter on `` and replace it with `Size="ModalSize.Fullscreen"` parameter. +- Remove `NotificationType`, `Message`, and `Title` parameter from `` component. +- Move `RightAligned` parameter from `` to `` component. +- Rename any usage of the `ChangeTextOnKeyPress` parameter into `Immediate`. +- Rename any usage of `DelayTextOnKeyPress` parameter into `Debounce` and `DelayTextOnKeyPressInterval` into DebounceInterval. +- Replace all `Left` and `Right` enums with `Start` and `End` for the following enum types: `Direction`, `Float`, `Placement`, `NotificationLocation`, `Side`, `SnackbarLocation`, `SnackbarStackLocation`, `TabPosition`, and `TextAlignment`. +- Replace all `FromLeft`, `FromRight`, `RoundedLeft`, and `RoundedRight` enums with `FromStart`, `FromEnd`, `RoundedStart`, and `RoundedEnd` for the `Border` utilities. +- Replace all `FromLeft` and `FromRight` with `FromStart`, `FromEnd` for the Margin and `Padding` utilities. +- Replace all `AddLabel` with `AddLabels` method on chart instance. +- Change enum value from `None` to `Default` for the following enum types: `Color`, `Background`, `TextColor`, `Alignment`, `BorderRadius`, `BorderSize`, `Direction`, `DisplayDirection`, `FigureSize`, `IconSize`, `JustifyContent`, `OverflowType`, `SnackbarColor`, `Target`, `TextAlignment`, `TextOverflow`, `TextTransform`, `TextWeight`, `VerticalAlignment`, `Visibility`, `Size`, and `SnackbarLocation`. +- Obsolete typography parameters `Alignment`, `Color`, `Transform`, and `Weight` are removed in favor of `TextAlignment`, `TextColor`, `TextTransform`, and `TextWeight`. +- Remove any use of an obsolete component ``. +- The Datagrid's obsolete `Direction` parameter has now been removed. Instead, please use the `SortDirection` parameter if you weren't already.. +- Rename `` `Mode` parameter into `RenderMode`. + +> _Check out [Blazorise Release Notes](https://preview.blazorise.com/news/release-notes/100) for more information._ + +--- + +## MVC - Razor Pages UI + +If you use MVC Razor Pages UI, you should follow this section. + +### Client libraries +The `libs` folder no longer exists in templates after v5.2. That change greatly reduced the size of templates and brought some other advantages. + +You can use `abp install-libs` command for installing or updating client libraries. You should run this command after updating v5.2. + +> If you're creating a new project, you don't have to be concerned about it, ABP CLI installs client libraries after automatically. + diff --git a/docs/en/Migration-Guides/Index.md b/docs/en/Migration-Guides/Index.md index 909f6c0998..e2647d8b0e 100644 --- a/docs/en/Migration-Guides/Index.md +++ b/docs/en/Migration-Guides/Index.md @@ -1,5 +1,6 @@ # ABP Framework Migration Guides +- [5.1 to 5.2](Abp-5_2.md) - [4.x to 5.0](Abp-5_0.md) - [4.2 to 4.3](Abp-4_3.md) - [4.x to 4.2](Abp-4_2.md) From dd49ea69917d5f18a3a21d3752ef94cc5d546953 Mon Sep 17 00:00:00 2001 From: enisn Date: Thu, 10 Mar 2022 11:31:52 +0300 Subject: [PATCH 2/2] Add IMongoDbRepositoryFilterer breaking-change --- docs/en/Migration-Guides/Abp-5_2.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/en/Migration-Guides/Abp-5_2.md b/docs/en/Migration-Guides/Abp-5_2.md index f0c7a4eaac..fbd49df21f 100644 --- a/docs/en/Migration-Guides/Abp-5_2.md +++ b/docs/en/Migration-Guides/Abp-5_2.md @@ -3,6 +3,10 @@ This document is a guide for upgrading ABP 5.1 solutions to ABP 5.2. Please read them all since 5.2 has some important breaking changes. +## MongoDB + +- `IMongoDbRepositoryFilterer.AddGlobalFilters()` method is replaced with async one `IMongoDbRepositoryFilterer.AddGlobalFiltersAsync()` + ## Blazor UI If you use Blazor WASM or Blazor Server UI, you should follow this section.