mirror of
https://github.com/Alfresco/alfresco-content-app.git
synced 2026-09-09 18:02:54 +00:00
[ACS-12451] Add missing upgrade guides in ACA (#5345)
* [ACS-12451] Add missing upgrade guides in ACA * [ACS-12451] CR fix
This commit is contained in:
Michal Kinas
@@ -0,0 +1,107 @@
|
||||
---
|
||||
Title: Upgrading from ACA v7.4.1 to v7.5.0
|
||||
---
|
||||
|
||||
# Upgrading from ACA v7.4.1 to v7.5.0
|
||||
|
||||
This guide provides instructions on how to upgrade your Alfresco Content Application (ACA) v7.4.1 project to
|
||||
v7.5.0.
|
||||
|
||||
This is a minor release on the Angular 19 / ADF 8 line: it moves **ADF 8.4.1 → 8.5.0** and `@alfresco/js-api`
|
||||
9.4.1 → 9.5.0. Angular (19.2), Node (`.nvmrc` 24.13.0), TypeScript, zone.js and NgRx are all **unchanged**. The
|
||||
headline is the **Material Design 3 (MD3) migration** — the biggest source of visual change in this release — plus
|
||||
a new **Link document** capability and multivalued-property support in folder rules. The corresponding ADF guide
|
||||
is:
|
||||
|
||||
- [ADF — Upgrading from v8.4.1 to v8.5.0](https://github.com/Alfresco/alfresco-ng2-components/blob/develop/docs/upgrade-guide/upgrade841-850.md)
|
||||
|
||||
Because of the MD3 migration, budget time to re-audit any custom theme or Material style overrides. Read the
|
||||
[breaking changes](#breaking-changes).
|
||||
|
||||
## Before you begin
|
||||
|
||||
Always perform upgrades on a "clean" project state, back up your changes or make a project backup. The Angular 19 /
|
||||
TypeScript 5.8 platform and Node 24 (`.nvmrc`) are unchanged from 7.4.1. Budget time to re-theme (MD3) and re-test.
|
||||
|
||||
## Contents
|
||||
|
||||
- [Library updates](#library-updates)
|
||||
- [Aligning with ADF 8.5](#aligning-with-adf-85)
|
||||
- [Breaking changes](#breaking-changes)
|
||||
- [Material Design 3 (MD3) migration](#material-design-3-md3-migration)
|
||||
- [minimatch-browser dependency removed](#minimatch-browser-dependency-removed)
|
||||
- [Library public API](#library-public-api)
|
||||
- [New components and features](#new-components-and-features)
|
||||
- [Behavioural changes](#behavioural-changes)
|
||||
|
||||
## Library updates
|
||||
|
||||
Update the `package.json` file with the latest library versions:
|
||||
|
||||
```json
|
||||
{
|
||||
"dependencies": {
|
||||
"@alfresco/adf-core": "8.5.0",
|
||||
"@alfresco/adf-content-services": "8.5.0",
|
||||
"@alfresco/adf-extensions": "8.5.0",
|
||||
"@alfresco/js-api": "9.5.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`@alfresco/adf-cli` and `@alfresco/eslint-plugin-eslint-angular` move to `8.5.0` too, and `mermaid` moves
|
||||
`11.12 → 11.15`. The **`minimatch-browser`** runtime dependency was removed. Angular (`19.2.20`),
|
||||
`@angular/material` (`19.2`), TypeScript (`5.8.2`), `@ngrx/*` (`19.2.1`), zone.js (`0.15.0`) and Node
|
||||
(`.nvmrc` `24.13.0`) are unchanged. Clean `node_modules` and the lockfile, then reinstall.
|
||||
|
||||
## Aligning with ADF 8.5
|
||||
|
||||
See the ADF [8.4.1 → 8.5.0 guide](https://github.com/Alfresco/alfresco-ng2-components/blob/develop/docs/upgrade-guide/upgrade841-850.md)
|
||||
for the underlying library changes. Beyond adopting ADF `8.5.0` / js-api `9.5.0`, the ADF-aligned work in ACA is
|
||||
the Material Design 3 theming migration below.
|
||||
|
||||
## Breaking changes
|
||||
|
||||
### Material Design 3 (MD3) migration
|
||||
|
||||
ACA (and ADW / ACC) migrated their theming to **Angular Material 3 (MD3)** — ACS-10449. This reworked the theme
|
||||
across roughly 70 files: `theme.scss`, `custom-theme.scss`, `variables.scss`, the ADF override partials
|
||||
(`adf-style-fixes.theme.scss`, `adf-variables.scss`, `adf-pagination.theme.scss`, …), new `mixins.scss` /
|
||||
`mat-selectors.scss`, and many component SCSS files. MD3 changes Material's design tokens, component styling and
|
||||
CSS custom properties.
|
||||
|
||||
**If your fork defines a custom theme or overrides Material component styles, you must re-audit them against MD3.**
|
||||
This is the largest source of visual breakage in this upgrade.
|
||||
|
||||
### minimatch-browser dependency removed
|
||||
|
||||
The `minimatch-browser` runtime dependency was removed from `package.json`. If your fork imported it transitively
|
||||
through ACA, add it to your own dependencies.
|
||||
|
||||
### Library public API
|
||||
|
||||
The published API is **additive** — `@alfresco/aca-content` now exports the **`NodeActionsService`** (ACS-9765),
|
||||
which also gained *copy/move/link* support (see [New components and features](#new-components-and-features)). No
|
||||
exports were removed or renamed.
|
||||
|
||||
> **Non-change (informational):** a change to how sharable links handle redirects to the login page (ACS-11861)
|
||||
> was merged and then **reverted** before 7.5.0, so that behaviour is unchanged. No action is needed — this is only
|
||||
> noted in case you diff the intermediate commits.
|
||||
|
||||
## New components and features
|
||||
|
||||
- **Link document** (MNT-25522) — you can now create a **link** to a document in another location. This adds a new
|
||||
node store action and extends the now-public `NodeActionsService`; linked nodes display `N/A` for size and number
|
||||
of files in the Information dialog.
|
||||
- **`NodeActionsService`** (`@alfresco/aca-content`) — the copy / move / link service is now part of the public API
|
||||
(`copyNodes()`, `moveNodes()`, and the new link action), so extensions can drive those actions directly.
|
||||
- **Folder rules — multivalued properties** (MNT-25149 / MNT-25558) — folder-rule property conditions and actions
|
||||
now support multivalued properties.
|
||||
|
||||
## Behavioural changes
|
||||
|
||||
| Area | Change |
|
||||
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Accessibility | Focus is handled correctly after collapsing the sidenav menu (ACS-11350), and the info-drawer tabs show a proper focus indicator during keyboard navigation (ACS-11980). |
|
||||
| Styling | General style updates accompanied the MD3 migration (ACS-11158). |
|
||||
| Info dialog | Links display `N/A` for size and number of files (MNT-25522). |
|
||||
Reference in New Issue
Block a user