用途
Angular Migration 是一个面向 AngularJS(1.x)到 Angular(2+)迁移的工作流技能。它用于在迁移项目中提供结构化的流程指导、代码转换示例和配套参考文件,帮助操作者从评估、策略选择到实施与验证逐步推进。
主要能力
- 迁移策略选择:资料列出三种策略——大爆炸式完整重写(适合小型应用或全新项目)、增量混合方式(AngularJS 与 Angular 并行运行,按功能迁移,使用 ngUpgrade 互操作,适合大型应用与持续交付)、垂直切片(完整迁移单个功能,新功能用 Angular,旧功能保留在 AngularJS,适合中型应用与边界清晰的功能)。
- 混合应用引导:提供 main.ts 与 app.module.ts 中通过 UpgradeModule 同时引导 Angular 与 AngularJS 的示例代码。
- 组件迁移:给出 AngularJS 控制器转 Angular 组件、AngularJS 指令转 Angular 组件的对照示例,含 @Input、@Output、EventEmitter 等用法。
- 服务迁移:展示 AngularJS factory 转 Angular @Injectable 服务,并将 $http 替换为 HttpClient、返回 Observable。
- 依赖注入改造:包含 Angular 服务降级供 AngularJS 使用(downgradeInjectable)以及 AngularJS 服务升级供 Angular 使用(InjectionToken + useFactory + $injector)的示例。
- 路由迁移:展示 $routeProvider 配置迁移到 Angular RouterModule 与 Routes 定义。
- 表单迁移:对比 AngularJS ng-model 表单与 Angular 模板驱动表单、响应式表单(FormBuilder、FormGroup、Validators)。
- 资源与支持文件:资料列出 references/hybrid-mode.md、references/component-migration.md、references/dependency-injection.md、references/routing.md、assets/hybrid-bootstrap.ts、assets/migration-timeline.md、scripts/analyze-angular-app.sh 等参考与脚本路径。
- 工作流步骤:评估代码库与风险、选择策略并定义里程碑、设置 ngUpgrade 并迁移模块/组件/路由、用测试验证并规划安全切换。
使用方式
资料将该技能定位为导入型技能包,执行时建议先确认用户目标与任务范围,再阅读 metadata.json 与 ORIGIN.md 了解来源,然后只加载对当前任务有实质影响的参考、示例或脚本,而非一次性加载全部文件。示例用法包括直接请求上游工作流、基于来源信息进行审查、缩小支持文件范围后执行,以及构建审查包。资料未提供独立的安装命令。
适用场景
- 将 AngularJS 1.x 应用迁移到 Angular 2+。
- 运行 AngularJS 与 Angular 混合应用。
- 将指令转换为组件、现代化依赖注入、迁移路由系统。
- 升级到较新 Angular 版本。
限制与注意事项
- 资料强调避免在没有回滚与预发布验证的情况下进行大爆炸式切换,增量迁移期间应持续进行混合兼容性测试。
- 最佳实践包括优先迁移服务、按功能增量推进、每一步都测试、尽早使用 TypeScript、从第一天遵循 Angular 风格指南、先跑通再优化并记录迁移笔记。
- 资料未提供收费、价格、平台支持范围或具体效果数据。
- 若任务转向调试、架构、设计、安全或发布编排等更专门领域,资料建议通过相关技能章节进行移交。