mirror of
https://gitee.com/beijing_hongye_huicheng/lilishop-uniapp.git
synced 2026-08-06 02:47:25 +08:00
dc2bef455a
将 lilishop-uniapp 从 Vue2/uView 1.6 迁移到 Vue3/uview-plus，优先支持 H5/微商城与微信小程序；移除 vendored uview-ui，改用 npm 依赖、Vuex4 与迁移脚本/补丁，并补充 VUE3_MIGRATION.md 回归清单。 Co-authored-by: Cursor <cursoragent@cursor.com>
2.1 KiB
2.1 KiB
Vue 3 升级说明
本项目已从 Vue 2 + uView 1.6 升级到 Vue 3 + uView Plus。
环境要求
- HBuilderX 3.8+
- Node.js 16+（用于安装
uview-plus、vuex@4、sass）
安装依赖
npm install
主要变更
| 项 | 变更 |
|---|---|
manifest.json |
增加 "vueVersion": "3" |
main.js |
使用 createSSRApp + export function createApp() |
| UI 库 | uview-ui → uview-plus（npm 依赖） |
| 状态管理 | Vuex 4 createStore |
| 全局 filter | 改为 main.js 全局 mixin methods |
| 小程序分享 | utils/mpShare.js |
| u-cell-item | 改为 u-cell |
| u-verification-code | 改为 u-code |
| u-swipe-action | 内层增加 u-swipe-action-item |
| u-upload | 关闭 auto-upload，使用 @afterRead + utils/uploadHelper.js |
| u-parse | :html 改为 :content，移除 show-with-animation / use-cache |
编译
请使用 HBuilderX 分别运行到 H5、微信小程序、App 进行验证。
回归测试清单
核心交易链路（H5 / 小程序）
- 首页装修模块加载（轮播、商品、优惠券等）
- 分类 / 搜索 / 商品详情
- 加购 / 购物车 / 填写订单
- 支付（H5 微信支付、小程序支付）
- 订单列表 / 订单详情 / 物流
- 售后申请 / 退款 / 评价
- 个人中心 / 地址 / 优惠券 / 积分
微商城专项（H5）
- 微信公众号内 JSSDK 分享
- 网页授权登录（
wechatH5Login） js_sdk/lili-pay/wx-pay.js微信支付- 粘贴板分享链接跳转（
h5-copy） - H5 唤起 App 浮窗（
m-airbtn）
微信小程序专项
- 分包加载正常
onShareAppMessage分享- 定位 / 相册权限
- 海报 / 二维码（u-draw-poster、Sansnn-uQRCode）
App 端（后续阶段）
- 5+ 原生模块：支付 / 分享 / OAuth / 定位 / 地图 / 指纹
- 头像裁剪（
okingtz-cropper） - 启动参数 / 唤起逻辑（
App.vuecheckArguments）
第三方插件
Sansnn-uQRCode：声明支持 Vue3u-draw-poster：声明支持 Vue2/3okingtz-cropper：需在 App 端实测头像裁剪