Skip to content

Commit

Permalink
Added sections to the 5.0 migration guide.
Browse files Browse the repository at this point in the history
  • Loading branch information
hikalkan committed Oct 25, 2021
1 parent 767c69b commit 94f5e8a
Show file tree
Hide file tree
Showing 5 changed files with 36 additions and 12 deletions.
1 change: 1 addition & 0 deletions docs/en/Blog-Posts/2021-10-05 v5_0_Beta1/POST.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ This is a major version and there are some breaking changes and upgrade steps. H
* `IRepository` doesn't inherit from `IQueryable` anymore. It was already made obsolete in 4.2.
* Removed NGXS and states from the Angular UI.
* Removed gulp dependency from the MVC / Razor Pages UI in favor of `abp install-libs` command of ABP CLI.
* Deprecated EntityCreatingEventData, EntityUpdatingEventData, EntityDeletingEventData and EntityChangingEventData classes. See [#9897](https://github.com/abpframework/abp/issues/9897).

Please see the [migration document](https://docs.abp.io/en/abp/5.0/Migration-Guides/Abp-5_0) for all the details. You can also see all [the closed issues and pull request](https://github.com/abpframework/abp/releases/tag/5.0.0-beta.1) on GitHub.

Expand Down
2 changes: 1 addition & 1 deletion docs/en/Migration-Guides/Abp-5-0-Blazor.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# ABP Blazor UI v4.x to v5.0 Migration Guide

This document is for the ABP MVC / Razor Pages UI. See also [the main migration guide](Abp-5_0.md).
> This document is for the ABP MVC / Razor Pages UI. See also [the main migration guide](Abp-5_0.md).
## Upgrading to the latest Blazorise

Expand Down
9 changes: 7 additions & 2 deletions docs/en/Migration-Guides/Abp-5-0-MVC.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
# ABP MVC / Razor Pages UI v4.x to v5.0 Migration Guide

This document is for the ABP MVC / Razor Pages UI. See also [the main migration guide](Abp-5_0.md).
> This document is for the ABP MVC / Razor Pages UI. See also [the main migration guide](Abp-5_0.md).
## Use install-libs by default

Removed the Gulp dependency from the MVC / Razor Pages UI projects in favor of `abp install-libs` command ([see](https://docs.abp.io/en/abp/5.0/UI/AspNetCore/Client-Side-Package-Management#install-libs-command)) of the ABP CLI. You should run this command whenever you change/upgrade your client-side package dependencies via `package.json`.
Removed the Gulp dependency from the MVC / Razor Pages UI projects in favor of `abp install-libs` command ([see](https://docs.abp.io/en/abp/5.0/UI/AspNetCore/Client-Side-Package-Management#install-libs-command)) of the ABP CLI. You should run this command whenever you change/upgrade your client-side package dependencies via `package.json`.

## Switched to SweetAlert2

Switched from SweetAlert to SweetAlert2. Run the `abp install-libs` command (in the root directory of the web project) after upgrading your solution. See [#9607](https://github.com/abpframework/abp/pull/9607).

18 changes: 9 additions & 9 deletions docs/en/Migration-Guides/Abp-5_0-Angular.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Angular UI v4.x to v5.0 Migration Guide

## Breaking Changes
This document is for the ABP MVC / Razor Pages UI. See also [the main migration guide](Abp-5_0.md).

### Overall
## Overall

See the overall list of breaking changes:

Expand All @@ -16,15 +16,15 @@ See the overall list of breaking changes:
- Update all dependency versions to the latest [#9806](https://github.com/abpframework/abp/issues/9806)
- Chart.js big include with CommonJS warning [#7472](https://github.com/abpframework/abp/issues/7472)

### Angular v12
## Angular v12

The new ABP Angular UI is based on Angular v12. We started to compile Angular UI packages with the Ivy compilation. Therefore, **new packages only work with Angular v12**. If you are still on the older version of Angular v12, you have to update to Angular v12. The update is usually very easy. See [Angular Update Guide](https://update.angular.io/?l=2&v=11.0-12.0) for further information.

### Bootstrap 5
## Bootstrap 5

TODO

### NGXS has been removed
## NGXS has been removed

We aim to make the ABP Framework free of any state-management solutions. ABP developers should be able to use the ABP Framework with any library/framework of their choice. So, we decided to remove NGXS from ABP packages.

Expand All @@ -42,7 +42,7 @@ NGXS states and actions, some namespaces have been removed. See [this issue](htt

If you don't want to use the NGXS, you should remove all NGXS related imports, injections, etc., from your project.

### @angular/localize package
## @angular/localize package

[`@angular/localize`](https://angular.io/api/localize) dependency has been removed from `@abp/ng.core` package. The package must be installed in your app. Run the following command to install:

Expand All @@ -56,7 +56,7 @@ yarn add @angular/localize

> ABP Angular UI packages are not dependent on the `@angular/localize` package. However, some packages (like `@ng-bootstrap/ng-bootstrap`) depend on the package. Thus, this package needs to be installed in your project.
### Proxy endpoints
## Proxy endpoints

New endpoints named proxy have been created, related proxies have moved.
For example; before v5.0, `IdentityUserService` could be imported from `@abp/ng.identity`. As of v5.0, the service can be imported from `@abp/ng.identity/proxy`. See an example:
Expand All @@ -79,11 +79,11 @@ Following proxies have been affected:
- `@abp/ng.tenant-management` to `@abp/ng.tenant-management/proxy`
- **ProfileService** is deleted from `@abp/ng.core`. Instead, you can import it from `@abp/ng.identity/proxy`

### SettingTabsService
## SettingTabsService

**SettingTabsService** has moved from `@abp/ng.core` to `@abp/ng.setting-management/config`.

### ChartComponent
## ChartComponent

[`ChartComponent`](../UI/Angular/Chart-Component.md) has moved from `@abp/ng.theme.shared` to `@abp/ng.components/chart.js`. To use the component, you need to import the `ChartModule` to your module as follows:

Expand Down
18 changes: 18 additions & 0 deletions docs/en/Migration-Guides/Abp-5_0.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,18 @@ If you want to revert back this feature, set `UseAbpClockHandleDateTime = false`
services.Configure<AbpMongoDbOptions>(x => x.UseAbpClockHandleDateTime = false);
```

### Publishing Auto-Events in the Same Unit of Work

Local and distributed auto-events are handled in the same unit of work now. That means the event handles are executed in the same database transaction and they can rollback the transaction if they throw any exception. See [#9896](https://github.com/abpframework/abp/issues/9896) for more.

### Deprecated EntityCreatingEventData, EntityUpdatingEventData, EntityDeletingEventData and EntityChangingEventData

`EntityCreatingEventData`, `EntityUpdatingEventData`, `EntityDeletingEventData` and `EntityChangingEventData` is not necessary now, because `EntityCreatedEventData`, `EntityUpdatedEventData`, `EntityDeletedEventData` and `EntityChangedEventData` is already taken into the current unit of work. Please switch to `EntityCreatedEventData`, `EntityUpdatedEventData`, `EntityDeletedEventData` and `EntityChangedEventData` if you've used the deprecated events. See [#9897](https://github.com/abpframework/abp/issues/9897) to learn more.

### Removed ModelBuilderConfigurationOptions classes

If you've used these classes, please remove their usages and use the static properties to customize the module's database mappings. See [#8887](https://github.com/abpframework/abp/issues/8887) for more.

### Removed Obsolete APIs

* `IRepository` doesn't inherit from `IQueryable` anymore. It was [made obsolete in 4.2](https://docs.abp.io/en/abp/latest/Migration-Guides/Abp-4_2#irepository-getqueryableasync).
Expand All @@ -40,6 +52,8 @@ This section contains breaking and important changes in the application modules.

### Identity

#### User Active/Passive

An `IsActive` (`bool`) property is added to the `IdentityUser` entity. This flag will be checked during the authentication of the users. EF Core developers need to add a new database migration and update their databases.

**After the database migration, set this property to `true` for the existing users: `UPDATE AbpUsers SET IsActive=1`**. Otherwise, none of the users can login to the application.
Expand Down Expand Up @@ -71,6 +85,10 @@ public partial class AddIsActiveToIdentityUser : Migration

For MongoDB, you need to manually update the `IsActive` field for the existing users.

#### Identity -> Account API Changes

`IProfileAppService` (and the implementation and the related DTOs) are moved to the Account module from the Identity module (done with [this PR](https://github.com/abpframework/abp/pull/10370/files)).

### IdentityServer

`IApiScopeRepository.GetByNameAsync` method renamed as `FindByNameAsync`.
Expand Down

0 comments on commit 94f5e8a

Please sign in to comment.