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

关于vue3+vite兼容低版本的白屏问题的相关资料

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
    }),
  ],
}

打包运行，成功！