angular-archwizard与Angular16+兼容性问题及替代方案咨询

一、临时兼容（仅适用于Angular16早期版本，不推荐长期使用） #

Angular16虽已移除ViewEngine，但部分场景下可尝试在项目angular.json中添加以下配置，强制兼容旧库：

{
  "projects": {
    "your-project-name": {
      "architect": {
        "build": {
          "options": {
            "allowedDeprecatedNgxLibs": ["angular-archwizard"]
          }
        }
      }
    }
  }
}

注意：该配置在Angular17已完全失效，仅作为过渡方案使用。

二、自行适配angular-archwizard到Ivy（针对fork后的改造） #

若要让fork的仓库支持Angular16+，需完成以下关键改造：

• 升级依赖版本：将package.json中@angular/*的依赖和peerDependencies全部升级至16.x或17.x，同步更新typescript、rxjs等配套依赖到对应兼容版本。
• 移除ViewEngine专属代码：删除所有entryComponents配置（Angular9+ Ivy不再需要），替换已废弃API（如Renderer换为Renderer2），移除ɵɵdefineInjectable等ViewEngine特有的编译产物代码。
• 启用Ivy编译：修改库的tsconfig.lib.json，确保compilerOptions中添加"enableIvy": true，同时在库的angular.json构建配置中启用Ivy编译。
• 修复组件逻辑与模板：检查所有组件模板语法，确保符合Angular16+规范，比如移除过时管道语法、调整输入输出绑定方式等；若适配Angular17，需重点排查是否使用了Angular17废弃的API（如NgModule旧用法），参考官方升级指南逐步调整。

三、替代库推荐 #

若改造成本过高，推荐以下支持Ivy、兼容Angular16+的向导/步进组件库：

• Angular Material Stepper：若项目已使用Angular Material，直接用内置Stepper组件，功能完善，支持线性/非线性步进、表单集成，完全适配最新Angular版本。
• ngx-form-wizard：轻量级表单向导组件，支持自定义步骤模板、校验逻辑，适配Angular16+。
• ng-wizard：高度可定制的向导组件，支持步骤导航、动画效果，文档完善，兼容最新Angular版本。

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