一、项目背景
Angular8+ng-zorro8,升级到15
二、官方升级指南
主要参考官方文档:
1.angular
https://angular.dev/update-guide?v=8.1-15.0&l=1
2.ng-zorro
https://ng.ant.design/version/15.1.x/docs/migration-v15/zh
3.angular、node、ts、rxjs对应版本
4.ng-zorro更新日志
https://ng.ant.design/version/9.3.x/docs/changelog/zh
三、注意事项
1.建议一级一级升,能快速定位问题
具体方法:先升级到angular9,然后升级ng-zorro9,运行项目解决报错;接着升级angular10,ng-zorro10,依次往下....
2.ng-zorro有一些废弃的写法,可以在更新日志中全局搜索,有对应说明。
四、升级bug记录
1.scheduleLike is not assignable to parameter of type...
解决:全局搜索到一句未使用的引用:"import ......./rxjs/src",删掉(rxjs版本也可以检查一下)
2."export 'ɵ_sanitizeStyle' was not found in '@angular/core'
解决:把对应的@angular/platform-browser等模块也升级到对应版本
ng update @angular/platform-browser@9
3. ERROR in ./node_modules/ng-zorro-antd/__ivy_ngcc__/fesm2015/ng-zorro-antd-modal.js
解决: 在tsconfig.json中禁用ivy
"angularCompilerOptions": {
"enableIvy": false
}
4. Can't bind to 'nzSortkey" since it isn't a knomn property of 'th'
解决:查看ng-zorro更新日志 nzSortKey被废弃了