Element Plus 正式发布,快试试这个工具自动升级你的 Element 老项目

升级 Vue3 的最后一块拼图

这里是阿里妈妈前端技术部,之前我们发布了基于代码转换工具 GoGoCode 的 Vue 转换插件(阿里妈妈又做了新工具,帮你把 Vue2 代码改成 Vue3 的),它能够帮你把项目里的 Vue2 的代码升级成 Vue3 的,但我们也收到很多朋友的反馈:我用了基于 Vue2 的 ElementUI,它还没有支持 Vue3,我把我的业务代码升级上去也没法跑起来。

如今 ElementUI 的 Vue3 版本 Element Plus 已经正式发布了,它大部分兼容了 ElementUI 的 API,但也存在着一些 breaking change,在两个团队的合作下,我们给大家带来 gogocode-element-plugin,它可以自动化地修改你的项目代码来适应所有的 breaking change,大大减少你的升级工作量。

最后一块拼图已经拼上!

一个大项目的升级实战

为了保证我们的转换规则能适配复杂场景,我们挑选了社区上火热的 Vue2 + ElementUI 项目 vue-element-admin,它覆盖了大多数 Vue2 和 Element 的用法,我们来试试通过转换插件把它转换成 Vue3 + Element Plus 的!

做好版本控制,使用一个新的分支

为了方便对比,我们接下来的命令会让转换工具覆写你原来的代码,建议你切换到一个新的分支操作,如果你的代码没有被 git 托管,请不要输出在同一目录。

git checkout -b to-vue3
复制代码

安装 gogocode-cli

npm install gogocode-cli -g
复制代码

格式化源代码,方便对比代码更改

因为代码经过工具的 AST 修改后可能会发生格式的变化,所以建议预先把所有的源码用 prettier 格式化一遍,再和转换后的作对比就一目了然了。

gogocode -s ./src -t gogocode-plugin-prettier  -o ./src
复制代码

在提示是否覆盖源代码的时输入 y 回车即可

image.png

经过了 prettier 后,代码都被统一成了一样的格式:

image.png

把这个修改提交到 git 上

使用工具把代码从 Vue2 转换成 Vue3

这次我们使用 gogocode-plugin-vue 插件把项目代码从 Vue2 升级到 Vue3:

gogocode -s ./src -t gogocode-plugin-vue  -o ./src
复制代码

这个项目有 258 个文件,转换程序卖力工作中:

image.png

转换完成!有 151 个文件发生了改动,这要是用手改头发可能就保不住了。

image.png

可以发现一些生命周期已经被转换了:

image.png

slot 和 filter 语法也不在话下:

image.png

函数式组件已经被改得面目全非了:

image.png

挨个文件看一遍,如果没什么大问题就 commit 并进入下一步!

一些可能需要手动修改的地方可以参考这个:需要关注的地方,不过建议你在最后能跑起来的时候再关心这些细节。

使用工具把代码从 ElementUI 转换成 Element Plus

我们使用 gogocode-element-plugin 插件把项目代码从 ElementUI 升级到 Element Plus:

gogocode -s ./src -t gogocode-plugin-element  -o ./src
复制代码

这里是官方总结的:Element Plus 不兼容变化gogocode-element-plugin 插件覆盖了几乎所有的规则。

插件自动帮你搞定的转换

  • icon 从 class 模式转换成了组件模式,组件也被自动的导入

image.png

image.png

  • 组件自动更名

image.png

  • 参数自动更名

image.png

  • 属性自动更名

image.png

  • 导入自动从 element-ui 变更到 element-plus

image.png

手动修改部分

这些只需要一次性、单文件的改动手动去做即可~

package.json

element-ui 换成 element-plus

如果使用了图标,别忘记 @element-plus/icons 也装上

css 引入
import 'element-plus/theme-chalk/index.css'
复制代码

升级依赖和构建

每个人的构建环境不同,你可以通过下面的命令帮你更新 package.json 里面的 vue 和 vue-cli 的版本号:

gogocode -s ./src -t gogocode-plugin-vue  -o ./src
复制代码

image.png

我这里遇到了 Webpack4 升级到 Webpack5 的一些问题,具体参考了 vue-cli 升级文档 也都一一解决了。

跑起来试试,根据报错进一步修改

运行项目,看看有哪些报错一一修复之,一些是第三方组件带来的,一些是构建带来的,对于这样体量的项目我大概修改了 100 多行的样子:commit

然后就见到了我期待的画面:

image.png

image.png

image.png

希望能得到大家的反馈

希望 GoGoCode 和配套的代码转换工具能帮助大家少做一些千篇一律的工作,早点下班回家,如果你在使用中遇到什么问题,欢迎通过以下方式联系我们:

issues: github.com/thx/gogocod…

钉钉群:34266233

最后:求 star 支持!

Github:github.com/thx/gogocod…(本项目在 packages/gogocode-plugin-ekenebt/ 目录下)

官网:gogocode.io

猜你喜欢

转载自juejin.im/post/7068556246781001765