uni-app 项目小程序端支持 vue3 介绍
简介
随着 vue3
的发布,uni-app
也逐步支持 vue3
。
目前小程序平台已支持,h5、App 平台暂不支持。
除支持 vue3
语法特性外,uni-app
特有的生命周期钩子支持 Composition API
,如 onLaunch
,onShow
,onLoad
...
下面介绍创建支持 vue3 的 uni-app 项目的流程,以及使用中的一些注意事项。vue3 相关问题请关注vue官方文档 vue3 中文文档。
创建支持 vue3 的 uni-app 项目流程
目前仅支持 cli
方式创建支持 vue3
默认模板项目。
如果你之前没有使用过 vue-cli
方式创建过项目,需要先安装 vue-cli
,若已安装则跳过步骤 1。
步骤 1: 全局安装vue-cli
npm install -g @vue/cli
步骤 2: 用如下的命令创建vue3工程
vue create -p dcloudio/uni-preset-vue#vue3 my-vue3-project
步骤 3: 创建好工程后,进入对应目录
cd my-vue3-project
步骤 4: 将项目跑到微信平台
npm run dev:mp-weixin
需要将编译后的文件dist/dev/mp-weixin
导入微信开发者工具运行,也可将项目拖入 HbuildX 中运行,方便运行到各个平台。
注意事项
- vue3的组件写法与vue2有区别,这导致插件市场众多插件,包括uni ui,目前都无法用于vue3版本。
- vue3 响应式基于 Proxy 实现,不支持iOS9和ie11。
- 暂不支持新增的 Teleport,Suspense 组件。
- 暂不支持 template 下存在多个根节点。
欢迎开发者反馈使用该版本遇到的问题,我们将积极收集意见。
后续:
DCloud之所以不支持vue3的h5和app版,主要是因为vue3的组件中很多语法的写法发生变化,这导致uni-app的h5版基础组件库和app版基础组件库的写法与vue3不兼容。
当然除了基础组件,插件市场的所有插件(包括uni ui),都不支持vue3。即便是uni-app已经推出的vue3的小程序版,也不支持插件市场的插件。
考虑到生态兼容的重要性,vue官方(尤雨溪)计划2021年4月中下旬推出新版,对vue2的语法做兼容,届时uni-app的h5版和app版将同时推出,并且插件市场的众多插件也将自动适配vue3版的uni-app。