配置

tsconfig

tsconfig 中增加

  1. "paths": {
  2. "@/*": ["./src/*"],
  3. "@@/*": ["./src/.umi/*"]
  4. }

此举是为了支持 umi@3 的新别名 @@

config.ts

  • lessLoaderOptions 修改为 lessLoader
  • 移除 plugins 字段,umi 已经修改为自动扫描 package.json,无需
  • cssLoaderOptions 修改为 cssLoader
  • IConfig 修改为 defineConfig,从 umi 中直接引入
  • umi-plugin-react 的 dynamicImport,配置提升到第一级。

package.json

移除不需要的依赖

  1. "umi-plugin-antd-icon-config": "^1.0.2",
  2. "umi-plugin-ga": "^1.1.3",
  3. "umi-plugin-pro": "^1.0.3",
  4. "umi-types": "^0.5.9",
  5. "redux": "^4.0.1",
  6. "umi-plugin-antd-icon-config": "^1.0.2",
  7. "umi-plugin-antd-theme": "1.2.0",
  8. "umi-plugin-pro-block": "^1.3.2",
  9. "umi-plugin-react": "^1.14.10",
  10. "dva": "^2.6.0-beta.16",

更多配置层面的改动可以看 迁移到 umi@3

代码改动

connectConnectProps, getLocale, setLocaleformatMessageDispatchLinkFormattedMessageReducerEffectAnyAction 全部修改为从 umi 中导入。统一了导入路径。

原有的 umi-plugin-react/locale 被废弃,所有从 umi-plugin-react/locale 中导出的皆可从 umi 中导入,原有的 router 修改为 history,api 不变。

lint 和 typescript 类型问题

由于 umi@3 使用了运行时类型,所以在依赖安装完成之时 lint 与 typescript 可能报错,这是因为定义文件没有生成导致的,我们可以执行的 npm run lint``yarn run umi g tmp 来生成临时文件。如果觉得比较麻烦,可以在 package.json 的 scripts 中做如下配置。

  1. "postinstall": "umi g tmp"

umi devumi build 执行时会自动生成,不会影响正常开发。

具体可以参见这个 diff