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: {} }; 複製程式碼
這裡引了幾個依賴,如果執行報錯則根據提示安裝相應依賴即可。