mirror of
https://github.com/Alfresco/alfresco-content-app.git
synced 2026-09-09 18:02:54 +00:00
111 lines
5.1 KiB
Markdown
111 lines
5.1 KiB
Markdown
---
|
|
Title: Upgrading from ACA v5.0.1 to v5.1.1
|
|
---
|
|
|
|
# Upgrading from ACA v5.0.1 to v5.1.1
|
|
|
|
This guide provides instructions on how to upgrade your Alfresco Content Application (ACA) v5.0.1 project to
|
|
v5.1.1 (there was no 5.1.0 release).
|
|
|
|
This is a small release on the ADF 7.0 alpha line: it moves **ADF 7.0.0-alpha.2 → 7.0.0-alpha.3** and
|
|
`@alfresco/js-api` 8.0.0-alpha.2 → 8.0.0-alpha.3. Angular (15.2), TypeScript (4.9), rxjs, Nx, zone.js and Node are
|
|
all **unchanged**. The work is adapting to the ADF alpha.3 **auth + js-api relocation** changes, plus adopting the
|
|
new **Knowledge Retrieval** feature. The relevant ADF guide is the **7.0.0-alpha.3** section of:
|
|
|
|
- [ADF — Upgrading from v6.9 to v7.0](https://github.com/Alfresco/alfresco-ng2-components/blob/develop/docs/upgrade-guide/upgrade69-70.md) (see the **7.0.0-alpha.3** section)
|
|
|
|
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. Node 18
|
|
(`.nvmrc`) and the Angular 15 platform are unchanged from 5.0.1.
|
|
|
|
## Contents
|
|
|
|
- [Library updates](#library-updates)
|
|
- [Aligning with ADF 7.0-alpha.3](#aligning-with-adf-70-alpha3)
|
|
- [AlfrescoApiService moved to adf-content-services](#alfrescoapiservice-moved-to-adf-content-services)
|
|
- [Functional route guards](#functional-route-guards)
|
|
- [Breaking changes](#breaking-changes)
|
|
- [aca-playwright-shared is now a published library](#aca-playwright-shared-is-now-a-published-library)
|
|
- [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": "7.0.0-alpha.3",
|
|
"@alfresco/adf-content-services": "7.0.0-alpha.3",
|
|
"@alfresco/adf-extensions": "7.0.0-alpha.3",
|
|
"@alfresco/js-api": "8.0.0-alpha.3"
|
|
}
|
|
}
|
|
```
|
|
|
|
`@alfresco/adf-cli` moves to `7.0.0-alpha.3` too. Angular (`15.2.10`), `@angular/material` (`15.2.9`), TypeScript
|
|
(`4.9.5`), rxjs (`6.6.6`), Nx (`17.3.1`), zone.js (`0.11.8`) and Node (`.nvmrc` `18`) are unchanged. Clean
|
|
`node_modules` and the lockfile, then reinstall.
|
|
|
|
## Aligning with ADF 7.0-alpha.3
|
|
|
|
See the **7.0.0-alpha.3** section of the ADF
|
|
[6.9 → 7.0 guide](https://github.com/Alfresco/alfresco-ng2-components/blob/develop/docs/upgrade-guide/upgrade69-70.md)
|
|
("Auth and js-api relocation") for the underlying changes.
|
|
|
|
### AlfrescoApiService moved to adf-content-services
|
|
|
|
ADF alpha.3 moved `AlfrescoApiService` (and `AlfrescoApiServiceMock`) from `@alfresco/adf-core` to
|
|
`@alfresco/adf-content-services`. ACA updated all its imports accordingly:
|
|
|
|
```ts
|
|
// Before
|
|
import { AlfrescoApiService } from '@alfresco/adf-core';
|
|
|
|
// After
|
|
import { AlfrescoApiService } from '@alfresco/adf-content-services';
|
|
```
|
|
|
|
Update this import wherever your fork or extensions use it. (See ADF 7.0.0-alpha.3 → "`AlfrescoApiService` moved
|
|
from `@alfresco/adf-core` to `@alfresco/adf-content-services`".)
|
|
|
|
### Functional route guards
|
|
|
|
Following ADF's move to functional route guards (the `AuthGuardBase` class was deleted and the guards became
|
|
`CanActivateFn` values), ACA converted its own guards to the functional pattern
|
|
(`view-profile.guard`, `plugin-enabled.guard`, `shared.guard`, and the `extensions-data-loader.guard`). If your
|
|
fork subclasses ACA guards or references them as injectable classes, migrate to the functional form. (See ADF
|
|
7.0.0-alpha.3 → "Auth route guards are now functional `CanActivateFn` values".)
|
|
|
|
## Breaking changes
|
|
|
|
ACA's `@alfresco/aca-shared` and `@alfresco/aca-content` root public APIs are unchanged in this release (no exports
|
|
removed or renamed). The consumer-facing changes are the ADF import move above and the test-library packaging
|
|
change below.
|
|
|
|
### aca-playwright-shared is now a published library
|
|
|
|
`projects/aca-playwright-shared` became a **buildable, publishable Angular library** (it gained `ng-package.json`
|
|
and `package.json` and is exported for consumers). If you wrote Playwright e2e tests against ACA, you can now
|
|
import the shared Playwright helpers from the published `@alfresco/aca-playwright-shared` package instead of a
|
|
relative source path.
|
|
|
|
## New components and features
|
|
|
|
- **Knowledge Retrieval (AI)** — a new feature that returns an AI response for one or more selected files, adopting
|
|
ADF alpha.3's Knowledge Retrieval / `AgentService` / `SearchAiService`. It adds an `agents-button` and a
|
|
`search-ai-input-container` component, and can be **toggled in the Docker image** via a runtime env var.
|
|
|
|
## Behavioural changes
|
|
|
|
| Area | Change |
|
|
| ------------- | ------------------------------------------------------------------------ |
|
|
| Document list | The list refreshes after a file version is restored. |
|
|
| Selection | An error page is shown when an action is invoked with no nodes selected. |
|
|
| Extensions | Visibility rules now accept arrays (documented). |
|
|
| Search | The current location is passed as a query parameter. |
|