Browse Source

update: migration guides for the module-based ng applications

pull/25396/head
sumeyye 2 weeks ago
parent
commit
01cc89f3bb
  1. 26
      docs/en/release-info/migration-guides/abp-10-0.md
  2. 14
      docs/en/release-info/migration-guides/abp-10-1.md

26
docs/en/release-info/migration-guides/abp-10-0.md

@ -133,4 +133,28 @@ See the [Add failure retry policy to InboxProcessor](https://github.com/abpframe
Starting from **ABP 10.0**, the [`HideErrors`](../../framework/fundamentals/caching#Available-Options) option of `AbpDistributedCacheOptions` is **disabled by default in the development environment**.
By default, ABP hides and logs cache server errors to keep the application running even when the cache is unavailable.
However, in the **development environment**, errors are no longer hidden so that developers can immediately detect and fix **any cache server issues** (such as connection, configuration, or runtime errors).
However, in the **development environment**, errors are no longer hidden so that developers can immediately detect and fix **any cache server issues** (such as connection, configuration, or runtime errors).
### Angular `LOGO_APP_NAME_TOKEN` May Need Explicit Provider in Module-based Apps
In ABP v10, the logo/app-name binding moved to the `provideLogo(withEnvironmentOptions(...))` API from `@abp/ng.theme.shared`.
For standalone Angular applications, configuring `provideLogo(withEnvironmentOptions(environment))` in `app.config.ts` is enough.
For NgModule-based applications, some setups may still show the literal `ProjectName` text (the default value of `LOGO_APP_NAME_TOKEN`) instead of `environment.application.name`. In that case, provide the token explicitly in your module providers:
```ts
import { LOGO_APP_NAME_TOKEN } from '@abp/ng.theme.shared';
import { environment } from '../environments/environment';
@NgModule({
// ...
providers: [
// ...
{ provide: LOGO_APP_NAME_TOKEN, useValue: environment.application.name },
],
})
export class AppModule {}
```
For logo customization/replacement details, see the [Component Replacement](../../framework/ui/angular/component-replacement.md#how-to-replace-logocomponent) documentation.

14
docs/en/release-info/migration-guides/abp-10-1.md

@ -60,6 +60,20 @@ ABP now targets Angular v21 (up from v20). For existing Angular projects, apply
providers: [provideZoneChangeDetection(), ...appConfig.providers],
}).catch(err => console.error(err));
```
If you are using a module-based structure instead of a standalone one, update the providers in `app.module.ts`:
```ts
@NgModule({
declarations: [AppComponent],
providers: [
//...
provideZoneChangeDetection(),
],
bootstrap: [AppComponent],
})
export class AppModule {}
```
- **tsconfig.json:** Align with the new property formats to avoid build issues:
```json
/* angular/tsconfig.json */

Loading…
Cancel
Save