PWA笔记五:Workbox实战应用

Brandonxiang NOV 5, 2019

引言

网页缓存分为两大类,分别是服务器缓存和客户端缓存。SSR 属于浏览器缓存,service worker 属于浏览器缓存。

在第二次加载的时候,一般有 HTTP 缓存或者客户端缓存,但是在弱网的情况下,HTTP 缓存往往是不够用的。很多 app 会考虑改变网络框架的情况,优先加载本地资源,再去检查资源是否被更新,以此提高静态资源加载效率。PWA 中的 service-worker 可以被看作类似的一个代理,它改变了整个缓存结构。目前,ios11.4 已经支持 ServiceWorker 和 Web App Manifest,支持 PWA 添加到桌面。

Service Worker 的未来是在用户允许的基础上,提供接近 native app 的功能,例如:

web push

服务器可以定期给网页推送消息,区别于其他的传统网页。用户在打开浏览器时,不需要进入特定的网站,就能收到该网站推送而来的消息,例如:新评论,新动态等等。

background sync

background sync 可延迟发送用户行为,直到用户网络连接稳定。这样有助于保证用户想要发送的数据就是实际发送的数据。

这些功能则会涵盖在 workbox 的功能内部。

历史背景

有很多文章把 pwa 技术和小程序技术放在一起比较。谷歌浏览器至于 pwa,微信至于小程序,都是给网页应用提供了离线缓存静态资源文件的功能,动静分离,native 的接口,这些都是给网页应用提供更优质的加载性能。但是小程序并没有 BOM 和 DOM,意味着它对浏览器有着更深入的改造,它并非纯正意义上的网页应用,是对所有 Web 开发资源的一种限制。

相反,pwa 则不一样。

兼容性情况

浏览器的兼容性

考虑到 service worker 是一个新的接口本身,肯定会存在兼容性问题。PWA 的意思在于 Progressive,也就是支持 pwa 的页面则使用 SW 的缓存机制,而不支持的页面使用原来的 HTTP 缓存机制。由于 pwa 是谷歌的“亲儿子”,所以它在新版本安卓的各大浏览器都有非常好的支持。详情我们可以参考lavas 的兼容性报告

重点的重点当然是微信浏览器对 pwa 的支持情况,我们可以看到除了推送信息和支付接口之外基本已经实现支持(支付接口的支持应该是出于安全的考虑,以及和 weixin-js-sdk 重叠的原因,X5 浏览器支持它只是时间的问题)。如今我们更关心的是关于 SW-cache 这一部分,换句话说,我们可以放心在安卓微信上使用 SW-cache 的技术。

安卓微信浏览器的支持情况

ios(苹果)的支持

震惊!苹果向开发者低头?!!开始支持 Service Worker》一文中讲述了苹果的开发工程师开始完成研发,并且在 2017 年底 safari 桌面技术预览版上已经实现了 service worker 的相关 api,从In development的状态转移到Supported In Preview,这意味着 service worker 极有可能在 IOS12 得到支持(详情https://webkit.org/status),这也就意味着pwa的时代很快就会到来。

苹果safari已开始支持service worker

Sw-precache 和 Workbox

sw-precache是什么? workbox又是什么?

web 前端的各位同学可能或多或少听过 pwa,听过service worker(后面简称为 SW),也知道对应的生命周期。知道了这些 api 后,你还是不知道如何将 pwa 技术投入生产。它不仅仅是个玩具,它是一个“神器”,是用来拉近 native 和 web app 之间的差距。当我们做 spa 项目越做越大的时候,JS bundle 会越来越大,单页面不能承载那么多的逻辑,我们可能会选择多个单页面(也就是多页面)。每次加载都会存在空白加载的情景,虽然性能优化上,我们能把这个时间减少到很少很少,但是没法完全把它“干掉”。pwa 的 service-worker 技术很好地弥补这片“空白”。“app-shell”也就是 web app 中的应用壳将会缓存在浏览器端,让它的加载速度更加快速。而可变的内容则是异步加载。

对比

我们知道 vue-cli 打造出来的 pwa 模版,使用的是sw-precache,而workbox是它的取代品。它们各自有一个 webpack 版的插件,分别是sw-precache-webpack-pluginworkbox-webpack-plugin

结合Vue 笔记八:多页面打包框架的多页面打包框架,我添加上 precache 的功能(以后计划替换成为 workbox),实现多页面的 service worker 框架,github 的地址是https://github.com/brandonxiang/mpa-pwa 我写了一个关于 workbox 在 vue-webpack 框架的脚手架,github 的地址是https://github.com/brandonxiang/example-vue-workbox,大家可以参考一下。

它们之间的区别如下,可以说非常相似:

中文说明 workbox 中文说明 sw-precache
缓存的目录 globDirectory 缓存前缀 stripPrefix
缓存的静态文件类型 globPatterns 缓存的静态文件类型 staticFileGlobs
sw 文件路径 swDest sw 文件名 filename
让 sw 立即接管网页 clientsClaim (相同) clientsClaim
激活的等待 skipWaiting (相同) skipWaiting
动态请求 runtimeCaching (相同) runtimeCaching

sw-precache 的主要开发者 jeffposnick 也是 workbox 的主要开发者,这说明了它们之间的关系,sw-precache 是为了满足 service worker 的 cache API 中的静态资源文件的注册作用。而 workbox 是为了满足所有 pwa 的资源内容,可以看作一个“平台”。

workbox file structure

Workbox是 GoogleChrome 团队推出的一套 Web App 静态资源本地存储的解决方案,该解决方案包含一些 Js 库和构建工具,在 Chrome Submit 2017 上首次隆重面世,它已经支持很多方面的内容,当然,还有很多内容有待开发。而在它背后则是 Service Worker 和 Cache API 等技术和标准在驱动。在此之前,GoogleChrome 团队较早时间推出过 sw-precache 和 sw-toolbox 库,但是在 GoogleChrome 工程师们看来,Workbox 才是真正能方便统一的处理离线能力的更完美的方案,并停止了对 sw-precache 和 sw-toolbox 的维护,所以,将项目的的 SW 的打包控制插件升级到 WorkBox 是非常重要。该文主要提出以 vue 官方的pwa 模版为基础,sw-precache 升级成为 workbox。整个升级的过程参考了lavas

pwa 的框架配置升级侵入性较少,基本上只需要改框架内容,不需要修改代码的内容,详情参考mpa-pwa。在实战应用中,往往不直接访问 service worker 的生命周期,基于 webpack 插件去控制缓存。

缓存机制

Service Worker的出现很大程度,改变了 web app 的格局,HTTP cache 和 SW cache 有着天壤之别。这样的 HTTP 缓存机制没法弥补网页跳转带来的白屏间隙,SW cache 由于优先缓存静态资源以及接口的机制,大大减少了网络状况差(甚至断网)带来的白屏现象。优先更新本地的同时,service worker 会和后端进行一次通信,这次通信会告知静态资源是否被更改,在下次刷新的时候更改内容。

动态接口方面则会采用 runtimeCaching 进行交互,这部分也会进行动态内容的缓存,sw-toolbox的代码将会被引入你的 sw.js 中,它会利用正则表达式匹配到你请求的接口,进行接口缓存,当该接口出现内容变化时,SW 会和后端进行一次通讯保证下一次加载的数据是最新数据,这样的更新机制分为 5 个类型。

networkFirst 是显示完成后,SW 优先和后端通讯,看接口是否更新,下一次刷新则是采用最新数据内容。cacheFirst 则是优先考虑缓存,如果缓存没有命中,才会去请求接口拿新数据,这个选型适合那种不经常更改的内容或者有别的更新机制。fastest 则是两个同时进行,哪个快执行哪个。cacheOnly 和 networkOnly 比较不常用。

项目中引入插件

在已有的项目的webpack.prod.conf.js中引入两个 webpack 插件,其中,workbox-webpack-plugin 是 workbox 的官方插件,处理项目中静态文件的缓存及更新。只有在打包至测试环境和生产环境使用上 service worker,但是在开发环境,无缓存和热更新的调试会大大提高我们开发效率。

{
	plugins: [new workboxPlugin(config.sw.workbox), new SwRegisterWebpackPlugin(config.sw.register)];
}

config.sw.workbox指的是对应的配置参数。它会配置在config文件夹的sw.js中,用于控制 workbox。

const path = require('path');
const dist = './dist';

module.exports = {
	workbox: {
		globDirectory: dist,
		globPatterns: ['**/*.{html,js,css}'],
		swDest: path.join(dist, 'module/service-worker.js'),
		clientsClaim: true,
		skipWaiting: true
	},
	register: {
		filePath: path.resolve(__dirname, '../src/module/sw-register.js'),
		prefix: '..',
		output: 'module/sw-register.js',
		excludes: [
			/activitytemplate\.html/,
			/addMember\.html/,
			/detail\.html/,
			/ecommand\.html/,
			/infoDetail\.html/,
			/insuredetail\.html/,
			/invite\.html/,
			/onlineBooking\.html/,
			/productDetail\.html/,
			/weappClientDetail\.html/
		]
	}
};

参数说明

workbox-webpack-plugin 参数

sw-register-webpack-plugin 参数

自定义更新 sw-register.js

sw-register-webpack-plugin是百度处理更新 service worker 的一个方案,参考lavas。它会在 html 行内注入sw-register.js,并加入时间戳,保证每次都能获取到最新的 sw 文件,保障其他静态文件更新。

<script>
	window.onload = function () {
		var script = document.createElement('script');
		var firstScript = document.getElementsByTagName('script')[0];
		script.type = 'text/javascript';
		script.async = true;
		script.src = '../module/sw-register.js?v=' + Date.now();
		firstScript.parentNode.insertBefore(script, firstScript);
	};
</script>

在配置文件中,自定义的sw-register.js会写在module文件夹中。它的作用主要是 sw 线程和主线程通讯,主要通过 postMessage,sw 的线程钩子是没法在界面中显示的。可能当静态文件更新的时候,界面需要有所变化,或是提示,或是强制更新。都可以用自定义sw-register.js来完成。

navigator.serviceWorker &&
	navigator.serviceWorker.register('./service-worker.js').then(() => {
		navigator.serviceWorker.addEventListener('message', (e) => {
			// service-worker.js 如果更新成功会 postMessage 给页面,内容为 'sw.update'
			if (e.data === 'sw.update') {
				let dom = document.createElement('div');
				let themeColor = document.querySelector('meta[name=theme-color]');

				themeColor && (themeColor.content = '#000');

				dom.innerHTML = `
              <style>
                  .app-refresh{background:#000;height:0;line-height:52px;overflow:hidden;position:fixed;top:0;left:0;right:0;z-index:10001;padding:0 18px;transition:all .3s ease;-webkit-transition:all .3s ease;-moz-transition:all .3s ease;-o-transition:all .3s ease;}
                  .app-refresh-wrap{display:flex;color:#fff;font-size:15px;}
                  .app-refresh-wrap label{flex:1;}
                  .app-refresh-show{height:52px;}
              </style>
              <div class="app-refresh" id="app-refresh">
                  <div class="app-refresh-wrap" onclick="location.reload()">
                      <label>已更新最新版本</label>
                      <span>点击刷新</span>
                  </div>
              </div>
          `;
				document.body.appendChild(dom);
				setTimeout(
					() => (document.getElementById('app-refresh').className += ' app-refresh-show'),
					16
				);
			}
		});
	});

参考

安全性