这个工具竟然能自动升级 Element 老项目
共 2265字,需浏览 5分钟
·
2022-03-05 13:16
升级 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 回车即可
经过了 prettier 后,代码都被统一成了一样的格式:
把这个修改提交到 git 上
使用工具把代码从 Vue2 转换成 Vue3
这次我们使用 gogocode-plugin-vue 插件把项目代码从 Vue2 升级到 Vue3:
gogocode -s ./src -t gogocode-plugin-vue -o ./src
这个项目有 258 个文件,转换程序卖力工作中:
转换完成!有 151 个文件发生了改动,这要是用手改头发可能就保不住了。
可以发现一些生命周期已经被转换了:
slot 和 filter 语法也不在话下:
函数式组件已经被改得面目全非了:
挨个文件看一遍,如果没什么大问题就 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 模式转换成了组件模式,组件也被自动的导入
组件自动更名
参数自动更名
属性自动更名
导入自动从 element-ui 变更到 element-plus
手动修改部分
这些只需要一次性、单文件的改动手动去做即可~
package.json
element-ui
换成 element-plus
如果使用了图标,别忘记 ``@element-plus/icons` 也装上
css 引入
import 'element-plus/theme-chalk/index.css'
升级依赖和构建
每个人的构建环境不同,你可以通过下面的命令帮你更新 package.json 里面的 vue 和 vue-cli 的版本号:
gogocode -s ./package.json -t gogocode-plugin-vue -o ./package.json
我这里遇到了 Webpack4 升级到 Webpack5 的一些问题,具体参考了 vue-cli 升级文档 也都一一解决了。
跑起来试试,根据报错进一步修改
运行项目,看看有哪些报错一一修复之,一些是第三方组件带来的,一些是构建带来的,对于这样体量的项目我大概修改了 100 多行的样子:commit
然后就见到了我期待的画面:
希望能得到大家的反馈
希望 GoGoCode 和配套的代码转换工具能帮助大家少做一些千篇一律的工作,早点下班回家
官网:gogocode.io
请你喝杯🍵 记得三连哦~
1.阅读完记得给🌲 酱点个赞哦,有👍 有动力
2.关注公众号前端那些趣事,陪你聊聊前端的趣事
3.文章收录在Github frontendThings 感谢Star✨