昨天下午瞅了一眼文档才发现Aurelia更新了,我那个老项目还在用v1,新版都v3.2了,这哪行!赶紧撸起袖子开干,顺手把升级过程记下来。
第一步:备份项目
先把整个项目文件夹复制了一份扔桌面,生怕升级翻车。上次手贱搞坏node_modules,花了两小时重装依赖,这回学乖了。
第二步:查版本兼容
打开*看依赖,好家伙,aurelia-cli还停在7.x。官方文档明说v3必须配套cli 9.x以上,直接在命令行敲:
小编温馨提醒:本站只提供游戏介绍,下载游戏推荐89游戏,89游戏提供真人恋爱/绅士游戏/3A单机游戏大全,点我立即前往》》》绅士游戏下载专区
- npm uninstall aurelia-cli
- npm install aurelia-cli@9.1.0
第三步:改配置文件
*里有个build块要动刀,把"name": "vendor-bundle"改成了"name": "app-bundle"。新版要求不能叫vendor,这命名规则改得真折腾。
第四步:替换路由配置
老版本路由用*搞的,现在得全换语法:
- 删掉*(config)
- 改写成configureRouter(config)
中间还手抖漏了个括号,控制台报错红得跟过年似的。
第五步:处理样式冲突
升级完启动时.css文件全报错,原来是css-loader版本不匹配。打开*,把test:/\.css$/那块换成新版写法: use:['style-loader','css-loader'],才算消停。
第六步:解决控制台警告
项目跑起来后满屏黄色警告,都是"aurelia-templating-resources"过期。挨个文件搜import语句,把动画库换成"aurelia-animator-css",光这个就折腾半小时。
第七步:功能验证
所有页面点一遍测试:
- 下拉菜单动画✔️
- 异步加载组件✔️
- 路由跳转时突然发现404✖️
发现baseHref忘改,*里加了个才救活。
搞完天都黑了,整个过程比预想多花两小时,主要卡在第五步和第六步。不过新版路由加载速度确实快了不少,动画也更顺滑。建议大伙升级前备好咖啡和零食,保不准哪步就踩坑。
