PWA (Progressive Web Apps)

webapp用户体验差(不能离线访问),用户粘性低(无法保存入口),pwa就是为了解决这一系列问题(Progressive Web Apps),让webapp具有快速,可靠,安全等特点.

PWA一系列用到的技术

  • Web App Manifest
  • Service Worker
  • Push Api & Notification Api
  • App Shell & App Skeleton
  • ...

一.Web App Manifest

将网站添加到桌面、更类似native的体验

Web App Manifest设置

<link rel="manifest" href="/manifest.json">
1
{
    "name": "PWA效果展示",  // 应用名称 
    "short_name": "PWA", // 桌面应用的名称  ✓
    "display": "standalone", // fullScreen (standalone) minimal-ui browser ✓
    "start_url": "/", // 打开时的网址  ✓
    "icons": [{ // 设置桌面图片 icon图标
        "src": "/icon.png",
        "sizes": "144x144",
        "type": "image/png"
    }],
    "background_color": "#aaa", // 启动画面颜色
    "theme_color": "#aaa" // 状态栏的颜色
}
1
2
3
4
5
6
7
8
9
10
11
12
13

ios 不支持 manifest文件,可以通过 meta/link 私有属性进行设置

<!-- 图标icon -->
<link rel="apple-touch-icon" href="/icon.png"/>
<!-- 添加到主屏后的标题 和 short_name一致 -->
<meta name="apple-mobile-web-app-title" content="标题"> 
<!-- 隐藏safari地址栏 standalone模式下默认隐藏 -->
<meta name="apple-mobile-web-app-capable" content="yes" /> 
<!-- 设置状态栏颜色 -->
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" /> 
1
2
3
4
5
6
7
8

二.Service Worker

Service Worker特点:

  • 不能访问/操作dom
  • 会自动休眠,不会随浏览器关闭所失效(必须手动卸载)
  • 离线缓存内容开发者可控
  • 必须在https或者localhost下使用
  • 所有的api都基于promise

生命周期

  • 安装( installing ):这个状态发生在 Service Worker 注册之后,表示开始安装,触发 install 事件回调指定一些静态资源进行离线缓存。
  • 安装后( installed ):Service Worker 已经完成了安装,并且等待其他的 Service Worker 线程被关闭。
  • 激活( activating ):在这个状态下没有被其他的 Service Worker 控制的客户端,允许当前的 worker 完成安装,并且清除了其他的 worker 以及关联缓存的旧缓存资源,等待新的 Service Worker 线程被激活。
  • 激活后( activated ):在这个状态会处理 activate 事件回调 (提供了更新缓存策略的机会)。并可以处理功能性的事件 fetch (请求)、sync (后台同步)、push (推送)。
  • 废弃状态 ( redundant ):这个状态表示一个 Service Worker 的生命周期结束。

关键方法

  • self.skipWaiting():表示强制当前处在 waiting 状态的 Service Worker 进入 activate 状态
  • event.waitUntil():传入一个 Promise 为参数,等到该 Promise 为 resolve 状态为止。
  • self.clients.claim():在 activate 事件回调中执行该方法表示取得页面的控制权, 这样之后打开页面都会使用版本更新的缓存。旧的 Service Worker 脚本不再控制着页面,之后会被停止。

下载准备好的服务端代码: PWA准备

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <link rel="stylesheet" href="/index.css">
    <link rel="manifest" href="/manifest.json">
</head>
<body>
    <div>
        <h1>PWA 效果展示</h1>
        <ul></ul>
    </div>
    <script src="/main.js"></script>
</body>
</html>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

页面中分别引入 css、js文件 及引入manifest.json

const ul = document.querySelector('ul');
fetch('/api/list').then(res => res.json()).then(data => {
    data.forEach(item => {
        let li = document.createElement('li');
        let img = document.createElement('img');
        img.src = item;
        li.appendChild(img);
        ul.appendChild(li);
    });
})
1
2
3
4
5
6
7
8
9
10

main.js中会调用服务端接口获取数据进行页面渲染。

我们核心要实现:实现离线访问功能、并离线缓存接口数据!

1)注册serviceWorker

window.addEventListener('load', async () => {
    if ('serviceWorker' in navigator) {
        let registration = await navigator.serviceWorker.register('/sw.js');
        console.log(registration); 
    }
});
1
2
3
4
5
6

我们需要等待主线程加载完毕,在注册serviceWorker。由于单开一条线程是有资源消耗的,我们并不希望,serviceWorker的开启影响页面的加载

2)注册监听函数

self.addEventListener('fetch',(e)=>{
    console.log(e.request.url); // 拦截请求
});

self.addEventListener('install',(e)=>{
    e.waitUntil(skipWaiting()); // 跳过等待,直接激活
});

self.addEventListener('activate',(e)=>{
    e.waitUntil(self.clients.claim()); // 让serviceWorker拥有控制权
})
1
2
3
4
5
6
7
8
9
10
11

3)缓存静态资源

安装时将缓存列表进行缓存操作

const CACHE_NAME = 'cache_v' + 1;
const CACHE_LIST = [
    '/',
    '/index.css',
    '/main.js',
    '/api/list',
    '/index.html',
];
async function preCache(){
    let cache = await caches.open(CACHE_NAME);
    await cache.addAll(CACHE_LIST);
    await self.skipWaiting();
}
self.addEventListener('install',(e)=>{
    e.waitUntil(preCache()); // 跳过等待,直接激活
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

激活后删除无用的缓存

async function clearCache(){
    self.clients.claim();
    let keys = await caches.keys();
    await Promise.all(keys.map(key=>{
        if(key !== CACHE_NAME){
            return caches.delete(key);
        }
    }));
}

self.addEventListener('activate',(e)=>{
    e.waitUntil(clearCache()); // 让serviceWorker拥有控制权
});
1
2
3
4
5
6
7
8
9
10
11
12
13

4)离线使用缓存

self.addEventListener('fetch',(e)=>{
    let url = new URL(e.request.url);
    if(url.origin !== self.origin){ // 静态资源走浏览器缓存
        return;
    }
    e.respondWith(
        fetch(e.request).catch(err=>{
            return caches.match(e.request);
        })
    )
});
1
2
3
4
5
6
7
8
9
10
11

5)缓存策略

基于workbox 缓存类型

  • cachefirst 缓存优先
  • cacheonly 仅缓存
  • networkfirst 网络优先
  • networkonly 仅网络
  • StaleWhileRevalidate 从缓存取,用网络数据更新缓存
function fetchAndSave(req){
    return fetch(req).then(res=>{
        let cloneRes = res.clone();
        caches.open(CACHE_NAME).then(cache=>cache.put(req,cloneRes));
        return res;
    })
}
self.addEventListener('fetch',(e)=>{
    let url = new URL(e.request.url);
    if(url.origin !== self.origin){
        return;
    }
	// 从缓存取,用网络数据更新缓存
    if(e.request.url.includes('/api')){
        return e.respondWith(
            fetchAndSave(e.request).catch(err=>{
                return caches.match(e.request);
            })
        )
    }

    e.respondWith(
        fetch(e.request).catch(err=>{
            return caches.match(e.request);
        })
    )
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

serviceWorker文件发生变化,会自动重新注册

三.Push Api

Web Push Protocol

 +-------+           +--------------+       +-------------+
 |  UA   |           | Push Service |       | Application |
 +-------+           +--------------+       |   Server    |
     |                      |               +-------------+
     |      Subscribe       |                      |
     |--------------------->|                      |
     |       Monitor        |                      |
     |<====================>|                      |
     |                      |                      |
     |          Distribute Push Resource           |
     |-------------------------------------------->|
     |                      |                      |
     :                      :                      :
     |                      |     Push Message     |
     |    Push Message      |<---------------------|
     |<---------------------|                      |
     |                      |                      |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

1)核心实现流程

  • Subscribe: 向Push Service发起订阅,获取PushSubscription

  • Monitor: 实现浏览器和PushService通信 (用户离线,PushSevice会维护消息列表)

  • Distribute Push Resource: 将PushSubscription 交给服务器,用于通信

  • Push Message: 服务端将消息推送给 Push ServicePush Service在推送给对应的客户端

2)实现服务端推送

function urlBase64ToUint8Array(base64String) {
    const padding = '='.repeat((4 - base64String.length % 4) % 4);
    const base64 = (base64String + padding)
        .replace(/-/g, '+')
        .replace(/_/g, '/');

    const rawData = window.atob(base64);
    const outputArray = new Uint8Array(rawData.length);

    for (let i = 0; i < rawData.length; ++i) {
        outputArray[i] = rawData.charCodeAt(i);
    }
    return outputArray;
}
const publicKey = 'BKn9WZWSFKaRlWfxwg32xV5M_IYr_nUFRQnS8tb_fR_1X1Ga_xP2TGfObHtKZzDeVBSJfoNasD_-N5qnYyg5enc';
const convertedVapidKey = urlBase64ToUint8Array(publicKey); // 通过公钥通信确保安全, 类型要求是ArrayBuffer
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
window.addEventListener('load', async () => {
    if ('serviceWorker' in navigator) {
        let registration = await navigator.serviceWorker.register('/sw.js');
        // 等待serviceWorker激活后
        await navigator.serviceWorker.ready;
        let pushSubsription = await registration.pushManager.subscribe({
            userVisibleOnly: true,
            applicationServerKey: convertedVapidKey
        });
        // 服务器这是我的通信对象
        fetch('/add-sub', {
            headers: {
                "Content-Type": 'application/json'
            },
            method: 'post',
            body: JSON.stringify(pushSubsription)
        })
    }
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

服务端获取对象后,可以直接给我们的客户端推送消息了

四.Notification

ServieWorker中监听服务端推送的消息

self.addEventListener('push', function (e) {
    var data = e.data;
    if (e.data) {
        self.registration.showNotification(data.text());        
    }  else {
        console.log('push没有任何数据');
    }
});
1
2
3
4
5
6
7
8

可以实现APP中信息推送的功能,当然可以直接使用Notification API ,但是大部分情况,我们还是会配合Push Api进行使用