如何在升级时像更新完整Angular项目一样自动更新Angular库？

我完全懂你的困扰——在Angular应用项目里运行ng update时，CLI会贴心地自动修改代码以适配新版本的API，但轮到自己开发的Angular库时，同样的命令只会列出一堆可更新的依赖包，完全不会帮你升级库本身的代码。这背后的原因其实很明确：ng update的自动代码迁移逻辑只针对官方Angular包，或者实现了Angular更新schematic的第三方库，你的自定义库默认没有这套机制。

下面是具体的解决步骤：

1. 先更新库的依赖版本 #

首先按照命令行给出的提示，把那些支持ng update的依赖包先升级到最新版本：

ng update @angular/cdk @angular/cli @angular/core @angular/material
ng update ng-zorro-antd

对于那些没有ng update能力的依赖包，直接用包管理器命令更新：

npm update

更新完成后，记得检查库的package.json，确保dependencies和peerDependencies的版本都和目标Angular版本匹配（比如这次的14.1.0）。

2. 为自定义库添加自动迁移schematic（可选） #

如果你希望你的库也能像官方包一样，让用户跑ng update时自动修改代码，那你需要自己编写Angular schematic：

• 确保你的库是用ng generate library命令生成的，这样会自带schematic的基础目录结构
• 在库的schematics目录下创建迁移配置文件（比如migrations.json），在里面定义针对版本升级的代码修改逻辑——比如替换废弃的API、调整组件装饰器参数、更新模块导入方式等
• 在库的package.json中添加"schematics"字段，指向你的迁移配置文件，让Angular CLI能识别到
• 完成后，下次在包含该库的项目中运行ng update时，CLI就会执行你定义的迁移逻辑，自动修改代码

3. 手动适配代码变更（最直接的方式） #

如果不想折腾schematic，那就手动处理代码适配：

• 查看Angular官方的版本更新日志（比如Angular 14.1的breaking changes），检查你的库有没有用到被废弃或修改的API
• 运行ng build your-library-name编译库，根据编译错误逐个修复代码问题
• 执行库的单元测试和集成测试，确保所有功能在新版本下正常运行

额外注意事项 #

• 升级前最好备份代码，或者用Git新建一个分支来做升级操作，避免破坏原有稳定代码
• 更新后要调整peerDependencies的版本范围，比如把@angular/core设为^14.1.0，这样使用你库的用户能正确匹配依赖版本

内容的提问来源于stack exchange，提问作者Munchkin