diff --git a/docs/en/Migration-Guides/Abp-7_0.md b/docs/en/Migration-Guides/Abp-7_0.md index b4c4d14b02..895e892d14 100644 --- a/docs/en/Migration-Guides/Abp-7_0.md +++ b/docs/en/Migration-Guides/Abp-7_0.md @@ -2,6 +2,14 @@ This document is a guide for upgrading ABP v6.0 solutions to ABP v7.0. There is a change in this version that may affect your applications, please read it carefully and apply the necessary changes to your application. +## `FormTenantResolveContributor` Removed from the `AbpTenantResolveOptions` + +`FormTenantResolveContributor` has been removed from the `AbpTenantResolveOptions`. Thus, if you need to get tenant info from `HTTP Request From`, please add a custom `TenantResolveContributor` to implement it. + +## `IHybridServiceScopeFactory` Removed + +`IHybridServiceScopeFactory` has been removed. Please use the `IServiceScopeFactory` instead. + ## Hybrid JSON was removed. Since [System.Text.Json](https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/overview) library supports more custom features in NET 7, ABP no longer need the hybrid Json feature. @@ -34,3 +42,60 @@ Check the docs to see the more info: https://github.com/abpframework/abp/blob/de Check the docs to see how to customize a JSON contract: https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/custom-contracts +## "Manage Host Features" Moved to the Settings Page + +"Manage Host Features" button has been moved from Tenants page to Settings page. + +See https://github.com/abpframework/abp/pull/13359 for more info. + +## Removed the `setter` from the Auditing Interfaces + +`AuditedEntity` and other base entity classes will continue to have public setters. If you want to make them private, don't derive from these base classes, but implement the interfaces yourself. + +See https://github.com/abpframework/abp/issues/12229#issuecomment-1191384798 for more info. + +## Added Abp prefix to DbProperties Classes + +Please update the database migration and related connection string names. + +## `EntityCreatingEventData`, `EntityUpdatingEventData`, `EntityDeletingEventData` and `EntityChangingEventData` has been removed. + +They are deprecated don't use them anymore. + +## LayoutHookInfo.cs, LayoutHookViewModel.cs, LayoutHooks.cs, AbpLayoutHookOptions.cs classes have been moved under the Volo.Abp.Ui.LayoutHooks namespace. + +See https://github.com/abpframework/abp/pull/13903 for more info. + +## Removed `abp.auth.policies` + +`abp.auth.polices` has been removed, use `abp.auth.grantedPolicies` instead. + +## Static C# Proxy Generation + +The `abp generate-proxy -t csharp ..` command will generate all the `classes/enums/other types` in the client side (including application service interfaces) behalf of you. + +If you have reference to the target contracts package, then you can pass a parameter `--without-contracts (shortcut: -c)`. + +See https://github.com/abpframework/abp/issues/13613#issue-1333088953 for more info. + +## Dynamic Permissions + +* `IPermissionDefinitionManager` methods are converted to asynchronous, and renamed (added Async postfix). +* Removed `MultiTenancySides` from permission groups. +* Inherit `MultiTenancySides` enum from byte (default was int). +* Needs to add migration for new entities in the Permission Management module. + +See https://github.com/abpframework/abp/pull/13644 for more info. + +## External Localization Infrastructure + +* Introduced `LocalizationResourceBase` that is base for localization resources. `LocalizationResource` inherits from it for typed (static) localization resources (like before). Also introduced `NonTypedLocalizationResource` that inherits from `LocalizationResourceBase` for dynamic/external localization resources. We are using `LocalizationResourceBase` for most of the places where we were using `LocalizationResource` before and that can be a breaking change for some applications. +* All layouts in all MVC UI themes should add this line just before the **ApplicationConfigurationString** line: + +```html + +``` + +We've already done this for our themes. + +See https://github.com/abpframework/abp/pull/13845 for more info.