Vue-cli3 項目在安卓低版本系統和 IE 上白屏問題解決

最近遇到一個問題，用 Vue 開發的項目在最近兩年新出的安卓手機上沒問題，在三四年前的舊手機上出現白屏問題。分析一下應該是安卓系統版本的緣由，目前已知的是Android 6.0 以上都 OK，6.0 如下就不行了。

低版本安卓系統內置的 webview 不支持 ES6 語法等一些新特性，因此報錯。但在手機上調試不方便，受一篇文章的啓發， IE 瀏覽器也是一樣的問題，因此能夠在 IE 上調試，一個調好了兩個就都好了。忽然發現萬惡的 IE 仍是有點用的…

網上的文章大部分是 Vue-cli 2.x 版本的解決方案，但 Vue-cli 3 跟以前的版本仍是有很大差別的，多是我比較菜，看了 n 篇文章仍是不知道怎麼配置。通過努力，終於梳理出了基於 Vue-cli 3 的項目如何作兼容性配置的步驟：

1. 根目錄下新建 .babelrc 文件

在項目根目錄下新建 .babelrc 文件，跟 package.json 同級。 將如下代碼複製到 .babelrc 文件中

{
  "presets": ["@babel/preset-env"],
  "plugins": [
    "@babel/plugin-transform-runtime"
  ]
}
複製代碼

2. 修改 babel.config.js

將如下代碼複製到 babel.config.js 文件中，其中最上面四行是打包時刪除 console 的配置，如不須要能夠刪除。

const plugins = [];
if (['production', 'prod'].includes(process.env.NODE_ENV)) {
  plugins.push("transform-remove-console")
}

module.exports = {
  presets: [
    [
      "@vue/app",
      {
        "useBuiltIns": "entry",
        polyfills: [
          'es6.promise',
          'es6.symbol'
        ]
      }
    ]
  ],
  plugins: plugins
};
複製代碼

3. 修改 vue.config.js

用 vue-cli 3 新建項目時，默認是沒有這個配置文件的，沒有則在項目根目錄下新建一個 vue.config.js ，也是跟 package.json 同級。

解決白屏問題須要添加的代碼：

module.exports = {
  transpileDependencies: ['webpack-dev-server/client'],
	chainWebpack: config => {
    config.entry.app = ['babel-polyfill', './src/main.js'];
	}
}
複製代碼

4. 修改 main.js 文件

找到 項目根目錄/src/main.js ，添加如下代碼

import 'babel-polyfill'
import Es6Promise from 'es6-promise'
Es6Promise.polyfill()
複製代碼

5. 安裝依賴

在根目錄下執行如下語句。若是在第二步不須要配置生產環境刪除 console 能夠不要最後一個 babel-plugin-transform-remove-console。

npm install --save-dev @babel/core @babel/plugin-transform-runtime @babel/preset-env es6-promise babel-polyfill babel-plugin-transform-remove-console
複製代碼

以上五步配置完就能夠解決 Vue 項目在低版本安卓系統和 IE 瀏覽器下顯示空白的問題了。

附完整的 vue.config.js

const path = require('path')
const resolve = dir => path.resolve(__dirname, dir)
const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV)
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;
const CompressionWebpackPlugin = require('compression-webpack-plugin');
const productionGzipExtensions = /\.(js|css|json|txt|html|ico|svg)(\?.*)?$/i;

module.exports = {
  transpileDependencies: ['webpack-dev-server/client'],

  // 基本路徑
  // baseUrl: './',
  publicPath: './',
  // 輸出文件目錄
  outputDir: 'dist',
  // eslint-loader 是否在保存的時候檢查
  lintOnSave: false,
  assetsDir: '', // 相對於outputDir的靜態資源(js、css、img、fonts)目錄
  runtimeCompiler: true, // 是否使用包含運行時編譯器的 Vue 構建版本
  // 生產環境是否生成 sourceMap 文件
  productionSourceMap: false,

  chainWebpack: config => {
    config.entry.app = ['babel-polyfill', './src/main.js'];
    // 修復HMR
    config.resolve.symlinks(true);
    //修復 Lazy loading routes Error
    config.plugin('html').tap(args => {
      args[0].chunksSortMode = 'none';
      return args;
    });
    // 添加別名
    config.resolve.alias
      .set('@', resolve('src'))
      .set('assets', resolve('src/assets'))
      .set('components', resolve('src/components'))
      .set('layout', resolve('src/layout'))
      .set('base', resolve('src/base'))
      .set('static', resolve('src/static'));
    //壓縮圖片
    config.module
      .rule("images")
      .use("image-webpack-loader")
      .loader("image-webpack-loader")
      .options({
        mozjpeg: {progressive: true, quality: 65},
        optipng: {enabled: false},
        pngquant: {quality: "65-90", speed: 4},
        gifsicle: {interlaced: false},
        webp: {quality: 75}
      });

    // 打包分析
    if (process.env.IS_ANALYZ) {
      config.plugin('webpack-report')
        .use(BundleAnalyzerPlugin, [{
          analyzerMode: 'static',
        }]);
    }
  },

  configureWebpack: config => {
    if (IS_PROD) {
      const plugins = [];
      //開啓 gzip 壓縮
      plugins.push(
        new CompressionWebpackPlugin({
          filename: '[path].gz[query]',
          algorithm: 'gzip',
          test: productionGzipExtensions,
          threshold: 10240,
          minRatio: 0.8
        })
      );

      config.plugins = [
        ...config.plugins,
        ...plugins
      ];
    }
  },
  // css相關配置
  css: {
    extract: true,
    sourceMap: false,
    loaderOptions: {},
    modules: false

  },
  parallel: require('os').cpus().length > 1,
  pwa: {},
  devServer: {
    open: process.platform === 'darwin',
    host: '0.0.0.0',
    port: 8080,
    https: false,
    hotOnly: false,
    proxy: null, // 設置代理
    before: app => {
    }
  },

  // 第三方插件配置
  pluginOptions: {}

};
複製代碼

運行如下命令安裝依賴

npm install --save-dev webpack-bundle-analyzer compression-webpack-plugin
npm install --save image-webpack-loader
複製代碼