diff --git a/docs/en/Blog-Posts/2022-03-08 v5_2_Preview/POST.md b/docs/en/Blog-Posts/2022-03-08 v5_2_Preview/POST.md index 5699328d89..b78e3235a2 100644 --- a/docs/en/Blog-Posts/2022-03-08 v5_2_Preview/POST.md +++ b/docs/en/Blog-Posts/2022-03-08 v5_2_Preview/POST.md @@ -34,6 +34,13 @@ See the [ABP CLI documentation](https://docs.abp.io/en/abp/latest/CLI) for all t You can use any IDE that supports .NET 6.x, like **[Visual Studio 2022](https://visualstudio.microsoft.com/downloads/)**. +## Migration Guides + +Please see the migration guides if you are upgrading from 5.x versions: + +* [ABP Framework 5.x to 5.2 migration guide](https://docs.abp.io/en/abp/5.2/Migration-Guides/Abp-5_2) +* [ABP Commercial 5.x to 5.2 migration guide](https://docs.abp.io/en/commercial/5.2/migration-guides/index) + ## What's New with ABP Framework 5.2? In this section, I will introduce some major features released with this version. Here, a brief list of titles explained in the next sections: @@ -45,7 +52,7 @@ In this section, I will introduce some major features released with this version * Custom Global CSS and JavaScript for the CMS Kit module * Other news -Let's begin with the first section: +Let's begin with the first section. ### Single-layer Solution Template @@ -171,7 +178,7 @@ With this new feature, you can automatically generate advanced user interfaces w ## Community News -We organized the 3rd live [ABP Community Talks](https://community.abp.io/talks) event on February 23rd. ABP community has a good interest in these events and we will continue to organize such a live event in every month. March's event will be announced in a few days. [Follow us on twitter](https://twitter.com/abpframework). +We organized the 3rd live [ABP Community Talks](https://community.abp.io/events) event on February 23rd. ABP community has a good interest in these events and we will continue to organize such a live event in every month. March's event will be announced in a few days. [Follow us on twitter](https://twitter.com/abpframework). [ABP Community](https://community.abp.io/) website is being a huge resource of articles and video tutorials on the ABP Framework and .NET. There have been 93 articles/tutorials submitted so far. Here's a list of a few contents posted in the last weeks: diff --git a/docs/en/Migration-Guides/Abp-5_2.md b/docs/en/Migration-Guides/Abp-5_2.md index 3a98e948ae..d0cbf80aad 100644 --- a/docs/en/Migration-Guides/Abp-5_2.md +++ b/docs/en/Migration-Guides/Abp-5_2.md @@ -1,3 +1,52 @@ # ABP Version 5.2 Migration Guide -TODO \ No newline at end of file +This document is a guide for upgrading ABP v5.x solutions to ABP v5.2. Please read them all since v5.2 has some changes you should take care. + + +## 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. + +### 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. + +## See Also + +* [Official blog post for the 5.2 release](https://blog.abp.io/abp/ABP.IO-Platform-5-2-RC-Has-Been-Published) + 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)