inteligr8/alfresco-ng2-components
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-ng2-components.git synced 2025-05-12 17:04:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

[ADF-5532] ADF Upgrade guide(upgrade411-50.md) (#8516)

Browse Source
This commit is contained in:
Raviraj Bahirsheth 2023-05-26 14:44:39 +05:30 committed by GitHub
parent 2429bb4266
commit 2f8b7b2bd3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 79 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/upgrade-guide/README.md
View File

@ -7,6 +7,7 @@ Title: Upgrade guides
Below are links to the upgrade guides notes for all released versions of ADF back to v2.6.0
- [Upgrading from ADF v5.0 to v6.0](upgrade50-60.md)
- [Upgrading from ADF v4.11 to v5.0](upgrade411-50.md)
- [Upgrading from ADF v4.6 to v4.7](upgrade46-47.md)
- [Upgrading from ADF v4.5 to v4.6](upgrade45-46.md)
- [Upgrading from ADF v4.4 to v4.5](upgrade44-45.md)

78
docs/upgrade-guide/upgrade411-50.md Normal file
View File

@ -0,0 +1,78 @@
---
Title: Upgrading from ADF v4.11 to v5.0
---
# Upgrading from ADF v4.11 to v5.0
This guide explains how to upgrade your ADF v4.11 project to work with v5.0.
Do not skip this task, if you want your application to be updated to a most recent version of ADF.
Upgrades of multiple versions of ADF cannot be done in one step only, but should follow the chain of sequential updates.
**Note:** the steps described below might involve making changes
to your code. If you are working with a versioning system then you should
commit any changes you are currently working on. If you aren't using versioning
then be sure to make a backup copy of your project before going ahead with the
upgrade.
### Manual update
1. Update the `package.json` file with the latest library versions:
```json
"dependencies": {
"@alfresco/adf-core": "5.0.0",
"@alfresco/adf-content-services": "5.0.0",
"@alfresco/adf-process-services-cloud": "5.0.0",
"@alfresco/adf-insights": "5.0.0",
"@alfresco/js-api": "5.0.0",
}
```
2. Clean your old distribution and dependencies by deleting `node_modules` and `package-lock.json`.
3. This is a major release of the Alfresco Application Development Framework containing upgrade to Angular 14.
With the current upgrade of the Angular framework, the suggested stack has also being updated:
| Name | Version |
| --- | --- |
| Node | 14.15.0 |
| npm | 6.14.8 |
| Angular | 14 |
| Typescript | 4.6 |
For a complete list of changes, supported browsers and new feature please refer to the official documentation
| Angular version | link |
| --- | --- |
| v11 | [Changes & Deprecations](https://v11.angular.io/guide/updating-to-version-11)|
| v12 | [Changes & Deprecations](https://v12.angular.io/guide/updating-to-version-12)|
| v13 | [Changes & Deprecations](https://v13.angular.io/guide/update-to-latest-version)|
| v14 | [Changes & Deprecations](https://angular.io/guide/update-to-latest-version) |
## Upgrade
To migrate custom code and application to Angular 14, please refer to the [offcial documentation](https://angular.io/).
**Note:**: Consider the possibility of leveraging [ADF v5.0.0-angular.13.2](https://www.npmjs.com/package/@alfresco/adf-core/v/5.0.0-angular.13.2),
a version of ADF compatible with Angular 13 that is meant to be used as intermediate step towards ADF v5. with angular v14.
4. A breaking change worth mentioning is related to style import. with ADF v5.0.0 an extra `/lib` is required.
**example**:
previous versions of ADF : `@import '~@alfresco/adf-core/prebuilt-themes/adf-blue-orange.css';`
starting ADF 5.0.0 : `@import '~@alfresco/adf-core/lib/prebuilt-themes/adf-blue-orange.css';`
5. Reinstall your dependencies
```sh
npm install
```
6. Run the application
```sh
npm start
```