vue3打包后在低版本浏览器或webview中出现白屏,原因就是因为语法兼容问题。根据vite官方文档描述,build.target默认支持 Chrome >=87、Firefox >=78、Safari >=14、Edge >=88 传送,所以需要我们手动兼容低版本。

本篇以vite2、安卓7/ios11为例。

如何兼容ios11

兼容ios11只需要指定语法转译的最低版本即可解决。

// vite.config.js
build: {
   target: ['ios11']
}

如何兼容安卓7

target 里写'android7'是没有用的,所以我们要先知道当前安卓版本的浏览器或webview的Chrome版本是多少,查看UA头就行,安卓7的对应版本是Chrome 64。

那是不是这么写就完事了呢?

build: {
   target: ['ios11', 'Chrome 64']
}

一打包一运行,发现依然白屏,这是怎么回事呢?来看看官方描述。

请注意,默认情况下 Vite 只处理语法转译,且 默认不包含任何 polyfill。 传统浏览器可以通过插件 @vitejs/plugin-legacy 来支持,它将自动生成传统版本的 chunk 及与其相对应 ES 语言特性方面的 polyfill。兼容版的 chunk 只会在不支持原生 ESM 的浏览器中进行按需加载。

意思就是Chrome 64版本不是现代浏览器,vite默认不支持呀!需要我们引入polyfill。

如何使用@vitejs/plugin-legacy

默认是不支持Chrome 64的,也是需要指定最低版本。

// vite.config.js
import legacy from '@vitejs/plugin-legacy'

export default {
  plugins: [
    legacy({
      targets: ['Chrome 64'],
      modernPolyfills: true
    }),
  ],
}

打包运行,成功!

补充知识:vue打包项目以后白屏和图片加载不出来问题解决方法

vue打包项目以后部署访问白屏。查看控制台是404.这是由于打包的时候没有设置对静态资源路径。原文件是绝对路径,需要改成相对路径。

1.白屏修改config/index.js

vue3+vite兼容低版本的白屏问题详解(安卓7/ios11)

2.图片加载不出来,修改build/utils.js

vue3+vite兼容低版本的白屏问题详解(安卓7/ios11)

总结

原文地址:https://juejin.cn/post/7180011804150464549

相关文章: