This guide applies to the current version ng-alain >= 19;
If you encounter problems during the upgrade process, feel free to comment here.
If you find any errors in this guide, please point out
Or you have encountered a new problem and solved it, welcome to comment here.

Before upgrade

1. Make sure Node.js >= 20.19.0.
2. Create a new branch, or use other methods to back up the current project.
3. Delete the package-lock.json or yarn.lock file.

1.Upgrade dependencies

• Upgrade Angular to 20.x version, Run ng update @angular/core@20 @angular/cli@20 angular-eslint@20 ng-zorro-antd@20 ng-alain@20.
• Run ng update @angular/cdk@20, if you have used @angular/cdk.

NG-ALAIN scaffolding upgrade all change files, please refer to: #2565.

2. ng-zorro-antd BREAKING CHANGES

Please note that NG-ZORRO has BREAKING CHANGES; please refer to
https://github.com/NG-ZORRO/ng-zorro-antd/releases/tag/20.0.0 for details.

中文版

本指南适用于当前版本 ng-alain >= 19 ;
如果在升级过程中遇到问题，欢迎提出。提问前请阅读 如何向开源社区提问题
如果发现本指南存在遗漏/错误，请指出!
或者你遇到了新的问题并解决了，欢迎补充!

开始之前

1. 首先确保你 Node.js >= 20.19.0
2. 创建新的分支，或者使用其他方式备份当前项目
3. 删除项目下 package-lock.json 或 yarn.lock 文件

升级步骤

升级相关依赖

• 将项目升级到 Angular 20 运行 ng update @angular/core@20 @angular/cli@20 angular-eslint@20 ng-zorro-antd@20 ng-alain@20。
• 如果你有单独使用 @angular/cdk 请执行 ng update @angular/cdk@20

NG-ALAIN脚手架升级全部变更文件，请参考：#2565。

2. ng-zorro-antd BREAKING CHANGES

需要注意 NG-ZORRO 有存在 BREAKING CHANGES；细节请参考
https://github.com/NG-ZORRO/ng-zorro-antd/releases/tag/20.0.0