Browse Source

Merge pull request #25396 from abpframework/issue/25395

Angular - Updating the migration guides for the module-based ng applications
pull/25405/head
Fahri Gedik 5 months ago
committed by GitHub
parent
commit
64b36ff588
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  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**. 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. 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], providers: [provideZoneChangeDetection(), ...appConfig.providers],
}).catch(err => console.error(err)); }).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: - **tsconfig.json:** Align with the new property formats to avoid build issues:
```json ```json
/* angular/tsconfig.json */ /* angular/tsconfig.json */

Loading…
Cancel
Save