当前位置: 首页 > article >正文

UniApp 从Vue2升级为Vue3需要注意哪些方面

Vue官方已经发布了Vue3,Vue2不再维护,也在建议大家都迁移到Vue3,所以Vue2终会被淘汰。

那么UniApp 从Vue2升级为Vue3需要注意哪些方面:

1、main.js

下面请看创建应用实例Vue2与Vue3的不同:

Vue2的写法:

// 之前 - Vue 2
import Vue from 'vue'
import App from './App'
Vue.config.productionTip = false    // vue3 不再需要
App.mpType = 'app'    // vue3 不再需要
const app = new Vue({
...App
})
app.$mount()

Vue3的写法:

import App from './App'
import { createSSRApp } from 'vue'
// 不能修改导出的 createApp 方法名,不能修改从 Vue 中导入的 createSSRApp。
export function createApp() {
  const app = createSSRApp(App)
  return {
      app
  }
}

2、环境变量

Vue2的写法:

// 配置环境变量
// 根目录.env文件 必须 VUE_APP_ 开头
VUE_APP_SOME_KEY = 123

// 获取环境变量
process.env.NODE_ENV         // 应用运行的模式
process.env.VUE_APP_SOME_KEY // 123

Vue3的写法:

// 配置环境变量
// 根目录.env文件 必须 VITE_ 开头
VITE_SOME_KEY = 123

// 获取环境变量
process.env.NODE_ENV          // 应用运行的模式
import.meta.env.VITE_SOME_KEY // 123

注意“VITE”,Vue3用的编译器是vite,Vue2用的编译器是webpack,这只是部分举例,具体看UniApp的官方文档。

3、全局属性

以全局网络请求为例

Vue2的写法:

// 之前 - Vue 2
Vue.prototype.$http = () => {};

 Vue3的写法:

// 之后 - Vue 3
const app = createApp({});
app.config.globalProperties.$http = () => {};

 4、插件使用

以使用 vuex 的 store为例

Vue2的写法:

// 之前 - Vue 2
import store from "./store";
Vue.prototype.$store = store;

 Vue3的写法:

// 之后 - Vue 3
import store from "./store";
const app = createApp(App);
app.use(store);

 5、只支持使用 ES6 模块规范

commonJS 需改为 ES6 模块规范,下面举例说明:

5.1 以模块导入为例

Vue2的写法:

// 之前 - Vue 2, 使用 commonJS
var utils = require("../../../common/util.js");

Vue3的写法:

// 之后 - Vue 3, 只支持 ES6 模块
import utils from "../../../common/util.js";

5.2 以模块导出为例

Vue2的写法:

// 之前 - Vue 2, 依赖如使用 commonJS 方式导出
module.exports.X = X;

Vue3的写法:

// 之后 - Vue 3, 只支持 ES6 模块
export default { X };

6、vuex 用法

Vue2的写法:

import Vue from "vue";
import Vuex from "vuex";
Vue.use(Vuex);
const store = new Vuex.Store({
  state: {},
});
export default store;

Vue3的写法:

import { createStore } from "vuex";
const store = createStore({
  state: {},
});
export default store;

7、避免在同一元素上同时使用 v-if 与 v-for

8、生命周期的适配

 在 Vue3 中组件卸载的生命周期被重新命名

  • destroyed 修改为 unmounted 
  • beforeDestroy 修改为 beforeUnmount

注:如上变化应该是适应Vue3的,统一掉,没有必要各一套的

注意created 和 onLoad 生命周期执行顺序:

created为组件生命周期,onLoad为页面生命周期。因此created执行先于onLoad更合理。

Vue3 在实现时 created 先于 onLoad 执行;Vue2 项目由于历史包袱较重不便修改,仅在使用组合式API时与Vue3对齐。

在编写代码时不应依赖 created 和 onLoad 生命周期执行顺序

9、事件的适配

Vue3 现在提供了一个emits选项,类似于现有props选项。此选项可用于定义组件可以向其父对象发出的事件。

强烈建议使用emits记录每个组件发出的所有事件。

这一点特别重要,因为去除了.native修饰符。emits 现在在未使用声明的事件的所有侦听器都将包含在组件的中$attrs,默认情况下,该侦听器将绑定到组件的根节点。

演示如下:

<template>
  <button @click="onClick">OK</button>
</template>
<script>
  export default {
    emits: ["click"],
    methods: {
      onClick() {
        this.$emit("click", "OK");
      },
    },
  };
</script>

10、Vue3 项目部分小程序端事件延迟或调用失败

 可在执行事件的元素上添加 data-eventsync="true" 属性以解决此问题,如:

<template>
  <button @click="onClick" data-eventsync="true">OK</button>
</template>

11、v-model 的适配

Vue3 的 v-model 相对 Vue2 来说 ,有了较大的改变。可以使用多 model,相应语法也有变化。 

12、修改 modelValue

用于自定义组件时,Vue3 v-model prop 和事件默认名称已更改 props.value 修改为 props.modelValue ,event.value 修改为 update:modelValue

代码如下:

export default {
  props: {
    // value:String,
    // 替换 value 为 modelValue
    modelValue: String,
  },
};

13、事件返回

将之前的 this.$emit('input') 修改为 this.$emit('update:modelValue') ,vue3 中将省略这一步骤

自定义组件上的 v-model 相当于传递了 modelValue prop 并接收抛出的 update:modelValue 事件:

<ChildComponent v-model="pageTitle" />

<!-- 是以下的简写: -->

<ChildComponent
  :modelValue="pageTitle"
  @update:modelValue="pageTitle = $event"
/>

若需要更改 model 名称,作为组件内 model 选项的替代,现在我们可以将一个 argument 传递给 v-model:

<ChildComponent v-model:title="pageTitle" />

<!-- 是以下的简写: -->

<ChildComponent :title="pageTitle" @update:title="pageTitle = $event" />

 14、插槽的适配

Vue3 将不支持 slot="xxx" 的用法 ,请使用 v-slot:xxx 用法。

Vue2的写法:

<!--  Vue2 支持的用法 -->
<uni-nav-bar>
  <view slot="left" class="city">
    <!-- ... -->
  </view>
</uni-nav-bar>

Vue3的写法:

<!--  Vue3 支持的用法 -->
<uni-nav-bar>
  <template v-slot:left>
    <view class="city">
      <!-- ... -->
    </view>
  </template>
</uni-nav-bar>

15、不再支持过滤器

从 Vue 3.0 开始,过滤器已删除,不再支持,建议用方法调用或计算属性替换它们。

16、API Promise 化 调用结果的方式:

在 Vue3 中,处理 API Promise 化 调用结果的方式不同于 Vue2。

  • Vue3 中,调用成功会进入 then 方法,调用失败会进入 catch 方法
  • Vue2 中,调用无论成功还是失败,都会进入 then 方法,返回数据的第一个参数是错误对象,第二个参数是返回数据

具体转换方法如下

Vue 2 转 Vue 3

// Vue 2 转 Vue 3, 在 main.js 中写入以下代码即可
function isPromise(obj) {
  return (
    !!obj &&
    (typeof obj === "object" || typeof obj === "function") &&
    typeof obj.then === "function"
  );
}

uni.addInterceptor({
  returnValue(res) {
    if (!isPromise(res)) {
      return res;
    }
    return new Promise((resolve, reject) => {
      res.then((res) => {
        if (!res) {
          resolve(res)
          return;
        }
        if (res[0]) {
          reject(res[0]);
        } else {
          resolve(res[1]);
        }
      });
    });
  },
});

16、生命周期钩子的组合式 API 使用方式

在 Vue3 组合式 API 中,也需要遵循 uni-app 生命周期钩子规范, 如 onLaunch 等应用生命周期仅可在 App.vue 中监听,使用中请注意生命周期钩子的适用范围。

只能在 <script setup> 单文件语法糖或 setup() 方法中使用生命周期钩子,以 A 页面跳转 B 页面传递参数为例:

方法1:

// 从 A 页面跳转 B 页面时传递参数 ?id=1&name=uniapp,xxx 为跳转的页面路径
//uni.navigateTo({
//  url: 'xxx?id=1&name=uniapp'
//})

// 方法一:在 B 页面 <script setup> 中
<script setup>
  import {
    onLoad,
    onShow
  } from "@dcloudio/uni-app";

  // onLoad 接受 A 页面传递的参数
  onLoad((option) => {
    console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'}
  });

  onShow(() => {
    console.log("B 页面 onShow");
  });
</script>

方法二:

// 方法二:在 B 页面 setup() 中
<script>
  import {
    onLoad,
    onShow,
  } from "@dcloudio/uni-app";

  export default {
    setup() {
      // onLoad 接受 A 页面传递的参数
      onLoad((option) => {
        console.log("B 页面 onLoad:", option); //B 页面 onLoad: {id: '1', name: 'uniapp'}
      });

      onShow(() => {
        console.log("B 页面 onShow");
      });
    }
  }
</script>

17、$mp 调整为 $scope

在 Vue3 中,this 对象下的 $mp 调整为 $scope

18、在 nvue 使用 Vuex

在 Vue3 中,如果 nvue 使用了 Vuex 的相关 API,需要在 main.js 的 createApp 的返回值中 return 一下 Vuex 示例:

import Vuex from "vuex";
export function createApp() {
  const app = createSSRApp(App);
  app.use(store);
  return {
    app,
    Vuex, // 如果 nvue 使用 vuex 的各种map工具方法时,必须 return Vuex
  };
}

19、需主动开启 sourcemap

App,小程序端源码调试,需要在 vite.config.js 中主动开启 sourcemap,代码如下:

import { defineConfig } from "vite";
import uni from "@dcloudio/vite-plugin-uni";

/**
 * @type {import('vite').UserConfig}
 */

export default defineConfig({
  build: {
    sourcemap: true,
  },

  plugins: [uni()],
});

20、小程序平台

20.1 监听原生的点击事件

在 vue3 的小程序平台中,监听原生的点击事件可以先使用 tap。 在 vue3 中,移除了.native 修饰符,所以编译器无法预知 click 是要触发原生事件,还是组件的自定义事件,故并未转换成小程序的 tap 事件。

20.2 style

vue3 出于性能考虑,style 中暂不支持 div、p 等 HTML 标签选择器,推荐使用 class 选择器,template 中的 HTML 标签仍会进行转换。

20.3 真机调试

  • vue3 微信开发者工具真机调试页面空白
  • vue3 微信小程序真机调试

均可以通过在 manifest.json 的 mp-weixin 中配置 minified 为 true 来解决,代码如下:

{
  "mp-weixin": {
    "setting": {
      // ...其他配置
      "minified": true
    }
  }
}

21、vue3 支持的手机版本最低到多少?

vue3 支持的范围是:Android > 4.4(具体因系统 webview 版本而异,原生安卓系统升级过系统 webview 一般 5.0 即可,国产安卓系统未使用 x5 内核时一般需 7.0 以上), ios >= 10。

Android < 4.4,配置 X5 内核支持,首次需要联网下载,可以配置下载 X5 内核成功后启动应用。

22、vue3 nvue 暂不支持 recycle-list 组件

23、h5 平台发行时,会默认启动摇树

vue3 在 h5 平台发行时,为了优化包体积大小,会默认启动摇树,仅打包明确使用的 api, 如果要关闭摇树,可以在 manifest.json 中配置:

"h5": {
    "optimization": {
        "treeShaking": {
            "enable": false
        }
    }
}

24、通过 props 来获取页面参数

vue3 全平台新增:通过 props 来获取页面参数的使用方式,代码如下:

<script setup>
  // 页面可以通过定义 props 来直接接收 url 传入的参数
  // 如:uni.navigateTo({ url: '/pages/index/index?id=10' })
  const props = defineProps({
    id: String,
  });
  console.log("id=" + props.id); // id=10
</script>
<script>
  // 页面可以通过定义 props 来直接接收 url 传入的参数
  // 如:uni.navigateTo({ url: '/pages/index/index?id=10' })
  export default {
    props: {
      id: {
        type: String,
      },
    },
    setup(props) {
      console.log("id=" + props.id); // id=10
    },
  };
</script>

25、小程序和App端不支持插值方式定义国际化

因运行平台限制,目前在小程序和 App 端不支持插值方式定义国际化,需要使用 Messages Functions 定义国际化信息,

示例:

const messages = {
  en: {
    greeting: ({ named }) => `hello, ${named('name')}!`
  }
}

 

<template>
  {{$t('index', {num: 123})}}
</template>

26、总结

推荐去UniApp官方文档上看,那里的文档是最新的,技术是不断发展的,相应的也会变化,官方文档也会相应更新。最好是去Vue的官方看下Vue3,因为UniApp的Vue3也是基于Vue3的,看原汁原味才能了然于胸。


http://www.kler.cn/a/304794.html

相关文章:

  • SPIRE: Semantic Prompt-Driven Image Restoration 论文阅读笔记
  • Linux进程信号(信号的产生)
  • 容器化技术入门:Docker详解
  • 解方程(C语言)
  • C语言中的 printf( ) 与 scanf( )
  • 参数估计理论
  • 微服务-- Sentinel的使用
  • 个人电脑可以当服务器用吗?
  • 服务器基础知识拓展( Linux 网络操作系统 03)
  • 京东广告投放平台整洁架构演进之路
  • 边缘计算智能网关的功能应用与优势-天拓四方
  • ZAB协议(算法)
  • linux配置远程ssh服务
  • Docker基本使用(持续更新中)
  • Spring IOC的应用
  • Vue 3 中 useRouter 与 useRoute 的深度解析
  • 悟空crm客户管理系统二次开发 单独新增表格字段
  • Kafka客户端核心参数详解
  • Java面试篇基础部分-Java注解详解
  • Visual Studio Code 高效开发 C/C++ 插件推荐
  • 开发游戏的学习规划
  • 基于扣子(Coze)打造第一个智能体——个性化对话机器人
  • 智能语音技术在人机交互中的应用与发展
  • 中国农业银行——轻量式云原生应用平台(轻云平台)
  • swiftUI结构体数组修改属性UI没更新
  • Go协程及并发锁应用指南