v10 升级指南
本文档将帮助你从 ng-zorro-antd
9.x 版本升级到 10.x 版本,如果你是 8.x 或者更老的版本,请先参考之前的升级文档升级到 9.x。
开始之前#
- 首先确保你
Node.js
>=10.13
- 创建新的分支,或者使用其他方式备份当前项目
- 删除项目下 package-lock.json 文件
升级步骤#
1.迁移到二级入口(如果需要)#
// 之前
import { NzButtonModule, NzNoAnimationModule } from 'ng-zorro-antd';
// 之后
import { NzButtonModule } from 'ng-zorro-antd/button';
import { NzNoAnimationModule } from 'ng-zorro-antd/core/no-animation';
我们已经在 v8 中弃用了 NgZorroAntdModule
和一级入口,并保留了 2 个版本后在此版本中移除,你可以使用 NG-ZORRO TSLint 来检查/修复项目中的引入入口。
(1) 安装 NG-ZORRO TSLint#
$ npm i nz-tslint-rules -D
(2) 配置 tslint.json#
{
"rulesDirectory": [
"node_modules/nz-tslint-rules"
],
"rules": {
"nz-secondary-entry-imports": true
}
}
(3) 运行 TSLint 检查项目中的一级入口并修复#
$ tslint --project <tsconfig> --fix
2. 升级相关依赖#
- 前往 https://update.angular.io/ 将项目升级到 Angular10。
- 如果你有单独使用
@angular/cdk
请执行ng update @angular/cdk
- 如果你有单独使用
date-fns@1.x
请先升级到2.x
3.升级 NG-ZORRO#
- 运行
ng update ng-zorro-antd
- 如果控制台出现警告消息请按提示修改对应代码