用途:帮助将应用从 IDS v5(或 v4)迁移到 IDS v6,以及从 OUI(@iress/oui)迁移到 IDS v6;也用于更新导入路径、将 Formik 表单改为 React Hook Form、更新旧测试工具,以及审查迁移 PR。
主要能力:提供迁移路径决策(按当前技术栈给出对应指南与复杂度)、迁移前评估脚本(如 scripts/detect-version.sh、audit-components.sh、find-deprecated-props.sh、find-formik.sh、find-test-utils.sh、setup-playwright-vrt.sh)、包与 CSS 导入变更说明、组件重命名(如 IressBadge→IressPill、IressRichSelect→IressSelect、IressField→IressFormField、IressFilter→IressDropdownMenu)、属性重命名(如 Alert 的 context→status、Modal 的 onHide→onShowChange、IressButton 的 variant→mode、IressModal 的 isOpen→show、title→heading、IressPanel 的 background→bg、IressStack/IressInline 的 gutter→gap)以及表单、测试、样式迁移要点。
使用方式:IDS v6 目前处于 beta,需用 @beta 标签安装:npm install @iress-oss/ids-components@beta;使用 token 时安装 npm install @iress-oss/ids-tokens@beta。应用入口需导入 @iress-oss/ids-components/dist/style.css;使用设计 token 需导入 @iress-oss/ids-tokens/build/css-vars.css。表单迁移采用 IressForm 与 IressFormField 的 render prop 模式,Yup 校验映射为各字段 rules 属性。迁移后可运行 scripts/validate-migration.sh 进行校验,并建议先建立 VRT 基线截图、创建迁移分支以便回滚。
适用场景:IDS/OUI 版本升级、跨版本组件与属性适配、表单架构重构、测试与样式迁移、迁移后校验。
限制:资料仅说明 IDS v6 处于 beta,未提供具体收费或价格信息;部分细节需参考 Storybook 中交互式指南及 node_modules 内生成的迁移指南。