入门教程,升级指南

React 同构应用 PWA 进级指南

2018/05/25 · JavaScript · PWA, React

最早的小说出处: 林东洲   

渐进式Web应用(PWA)入门教程(下)

2018/05/25 · 基本功技巧 · PWA

初稿出处: Craig Buckler   译文出处:葡萄干城控件   

上篇小说大家对渐进式Web应用(PWA)做了有的主导的介绍。

渐进式Web应用(PWA)入门教程(上)

在这一节中,大家将介绍PWA的准则是哪些,它是什么样起头职业的。

前言

近些年在给作者的博客网址 PWA 晋级,顺便就记录下 React 同构应用在采用 PWA 时蒙受的难点,这里不会从头开首介绍如何是 PWA,若是你想上学 PWA 相关文化,能够看下上边作者收藏的有的稿子:

  • 您的第一个 Progressive Web App
  • 【ServiceWorker】生命周期那个事情
  • 【PWA学习与实施】(1) 2018,开首你的PWA学习之旅
  • Progressive Web Apps (PWA) 中文版

第一步:使用HTTPS

渐进式Web应用程序需求动用HTTPS连接。尽管使用HTTPS会让你服务器的成本变多,但利用HTTPS可以让你的网址变得更安全,HTTPS网址在Google上的排行也会更靠前。

由于Chrome浏览器会暗中认可将localhost以及127.x.x.x地址视为测量试验地方,所以在本示例中你并无需开启HTTPS。其余,出于调节和测量检验指标,您可以在开发银行Chrome浏览器的时候使用以下参数来关闭其对网址HTTPS的检查:

  • –user-data-dir
  • –unsafety-treat-insecure-origin-as-secure

PWA 特性

PWA 不是不过的某项技艺,而是一批本事的集聚,举个例子:ServiceWorker,manifest 增添到桌面,push、notification api 等。

而就在近些日子光阴,IOS 11.3 刚刚补助 瑟维斯 worker 和周边 manifest 增加到桌面包车型地铁特点,所以本次 PWA 退换器重还是促成这两片段功效,至于别的的特色,等 iphone 补助了再升级吗。

第二步:创设叁个应用程序清单(Manifest)

应用程序清单提供了和当前渐进式Web应用的有关信息,如:

  • 应用程序名
  • 描述
  • 装有图片(包罗主荧屏Logo,启动荧屏页面和用的图形可能网页上用的图样)

本质上讲,程序清单是页面上用到的Logo和宗旨等能源的元数据。

程序清单是一个坐落您使用根目录的JSON文件。该JSON文件重返时必需抬高Content-Type: application/manifest+json 或者 Content-Type: application/jsonHTTP头消息。程序清单的文件名不限,在本文的身体力行代码中为manifest.json

{ "name" : "PWA Website", "short_name" : "PWA", "description" : "An example PWA website", "start_url" : "/", "display" : "standalone", "orientation" : "any", "background_color" : "#ACE", "theme_color" : "#ACE", "icons": [ { "src" : "/images/logo/logo072.png", "sizes" : "72x72", "type" : "image/png" }, { "src" : "/images/logo/logo152.png", "sizes" : "152x152", "type" : "image/png" }, { "src" : "/images/logo/logo192.png", "sizes" : "192x192", "type" : "image/png" }, { "src" : "/images/logo/logo256.png", "sizes" : "256x256", "type" : "image/png" }, { "src" : "/images/logo/logo512.png", "sizes" : "512x512", "type" : "image/png" } ] }

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
29
30
31
32
33
34
35
36
37
{
  "name"              : "PWA Website",
  "short_name"        : "PWA",
  "description"       : "An example PWA website",
  "start_url"         : "/",
  "display"           : "standalone",
  "orientation"       : "any",
  "background_color"  : "#ACE",
  "theme_color"       : "#ACE",
  "icons": [
    {
      "src"           : "/images/logo/logo072.png",
      "sizes"         : "72x72",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo152.png",
      "sizes"         : "152x152",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo192.png",
      "sizes"         : "192x192",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo256.png",
      "sizes"         : "256x256",
      "type"          : "image/png"
    },
    {
      "src"           : "/images/logo/logo512.png",
      "sizes"         : "512x512",
      "type"          : "image/png"
    }
  ]
}

程序清单文件建设构造完未来,你供给在每一种页面上援用该公文:

<link rel="manifest" href="/manifest.json">

1
<link rel="manifest" href="/manifest.json">

以下属性在程序清单中时时使用,介绍表明如下:

  • name: 客户看到的采纳名称
  • short_name: 应用短名称。当突显应用名称的地方非常不足时,将应用该名称。
  • description: 行使描述。
  • start_url: 选取初步路线,绝对路线,暗中认可为/。
  • scope: UTucsonL范围。举个例子:如若您将“/app/”设置为UENVISIONL范围时,那么些动用就能间接在那一个目录中。
  • background_color: 款待页面的背景颜色和浏览器的背景颜色(可选)
  • theme_color: 接纳的大旨颜色,一般都会和背景颜色同样。这些装置决定了运用怎么样体现。
  • orientation: 预先旋转方向,可选的值有:any, natural, landscape, landscape-primary, landscape-secondary, portrait, portrait-primary, and portrait-secondary
  • display: 展现格局——fullscreen(无Chrome),standalone(和原生应用同样),minimal-ui(最小的一套UI控件集)或许browser(最古老的选择浏览器标签展现)
  • icons: 叁个包括全体图片的数组。该数组中每一个成分包蕴了图片的U凯雷德L,大小和档期的顺序。

Service Worker

service worker 在笔者眼里,类似于三个跑在浏览器后台的线程,页面第四回加载的时候会加载那个线程,在线程激活之后,通过对 fetch 事件,可以对各类收获的财富实行支配缓存等。

其三步:创立一个 Service Worker

Service Worker 是三个可编制程序的服务器代理,它能够阻止也许响应互连网诉求。Service Worker 是放在应用程序根目录的贰个个的JavaScript文件。

你须求在页面前境遇应的JavaScript文件中注册该ServiceWorker:

if ('serviceWorker' in navigator) { // register service worker navigator.serviceWorker.register('/service-worker.js'); }

1
2
3
4
if ('serviceWorker' in navigator) {
  // register service worker
  navigator.serviceWorker.register('/service-worker.js');
}

一旦你无需离线的相干职能,您能够只开创四个 /service-worker.js文件,那样顾客就足以一贯设置您的Web应用了!

ServiceWorker这几个定义可能相比较难懂,它实质上是五个做事在另外线程中的标准的Worker,它无法访谈页面上的DOM成分,未有页面上的API,然则足以阻止全部页面上的互联网诉求,包含页面导航,哀告能源,Ajax诉求。

地点正是使用全站HTTPS的基本点原因了。假如你没有在您的网址中使用HTTPS,一个第三方的剧本就足以从其余的域名注入他和谐的ServiceWorker,然后篡改全数的伸手——那无疑是充足危急的。

瑟维斯 Worker 会响应三个事件:install,activate和fetch。

猛烈哪些财富须要被缓存?

那么在初叶采用 service worker 从前,首先供给领悟如何财富供给被缓存?

Install事件

该事件就要应用设置到位后触发。我们一般在这里运用Cache API缓存一些要求的文书。

第一,我们须要提供如下配置

  1. 缓存名称(CACHE)以及版本(version)。应用可以有多少个缓存存款和储蓄,不过在动用时只会选择当中二个缓存存款和储蓄。每当缓存存款和储蓄有生成时,新的版本号将会钦点到缓存存款和储蓄中。新的缓存存款和储蓄将会作为当下的缓存存款和储蓄,此前的缓存存款和储蓄将会被作废。
  2. 三个离线的页面地址(offlineU大切诺基L):当客户访谈了从前未曾访谈过的地点时,该页面将会展现。
  3. 贰个包涵了具备必需文件的数组,包罗保持页面经常机能的CSS和JavaScript。在本示例中,笔者还增多了主页和logo。当有两样的UEvoqueL指向同二个能源时,你也足以将那些U途乐L分别写到那些数组中。offlineUPRADOL将会进入到那么些数组中。
  4. 小编们也足以将一些非要求的缓存文件(installFilesDesirable)。那些文件在安装进程中将会被下载,但一旦下载失利,不会触发安装失利。

// 配置文件 const version = '1.0.0', CACHE = version + '::PWAsite', offlineU中华VL = '/offline/', installFilesEssential = [ '/', '/manifest.json', '/css/styles.css', '/js/main.js', '/js/offlinepage.js', '/images/logo/logo152.png' ].concat(offlineURL), installFilesDesirable = [ '/favicon.ico', '/images/logo/logo016.png', '/images/hero/power-pv.jpg', '/images/hero/power-lo.jpg', '/images/hero/power-hi.jpg' ];

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 配置文件
const
  version = '1.0.0',
  CACHE = version + '::PWAsite',
  offlineURL = '/offline/',
  installFilesEssential = [
    '/',
    '/manifest.json',
    '/css/styles.css',
    '/js/main.js',
    '/js/offlinepage.js',
    '/images/logo/logo152.png'
  ].concat(offlineURL),
  installFilesDesirable = [
    '/favicon.ico',
    '/images/logo/logo016.png',
    '/images/hero/power-pv.jpg',
    '/images/hero/power-lo.jpg',
    '/images/hero/power-hi.jpg'
  ];

installStaticFiles() 方法应用基于Promise的措施利用Cache API将文件存款和储蓄到缓存中。

// 安装静态能源 function installStaticFiles() { return caches.open(CACHE) .then(cache => { // 缓存可选文件 cache.addAll(installFilesDesirable); // 缓存必需文件 return cache.addAll(installFilesEssential); }); }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 安装静态资源
function installStaticFiles() {
  return caches.open(CACHE)
    .then(cache => {
      // 缓存可选文件
      cache.addAll(installFilesDesirable);
      // 缓存必须文件
      return cache.addAll(installFilesEssential);
    });
}

末尾,我们抬高二个install的风云监听器。waitUntil方法保险了service worker不会设置直到其有关的代码被实行。这里它会执行installStaticFiles()方法,然后self.skipWaiting()艺术来激活service worker:

// 应用设置 self.add伊芙ntListener('install', event => { console.log('service worker: install'); // 缓存首要文件 event.waitUntil( installStaticFiles() .then(() => self.skipWaiting()) ); });

1
2
3
4
5
6
7
8
9
10
11
12
// 应用安装
self.addEventListener('install', event => {
  console.log('service worker: install');
  // 缓存主要文件
  event.waitUntil(
    installStaticFiles()
    .then(() => self.skipWaiting())
  );
});

缓存静态财富

首先是像 CSS、JS 这个静态能源,因为小编的博客里援引的台本样式都以透过 hash 做悠久化缓存,类似于:main.ac62dexx.js 那样,然后展开强缓存,那样下一次客商下一次再探访小编的网址的时候就无须再行央浼能源。直接从浏览器缓存中读取。对于那有的能源,service worker 没要求再去管理,直接放行让它去读取浏览器缓存就可以。

本身感到假若你的站点加载静态资源的时候小编并未有张开强缓存,並且你只想经过前端去贯彻缓存,而没有须要后端在加入实行调治,那能够使用 service worker 来缓存静态能源,不然就有一点画蛇添足了。

Activate 事件

其一事件会在service worker被激活时爆发。你可能不必要那几个事件,然而在演示代码中,大家在该事件发生时将老的缓存全体清理掉了:

// clear old caches function clearOldCaches() { return caches.keys() .then(keylist => { return Promise.all( keylist .filter(key => key !== CACHE) .map(key => caches.delete(key)) ); }); } // application activated self.addEventListener('activate', event => { console.log('service worker: activate'); // delete old caches event.waitUntil( clearOldCaches() .then(() => self.clients.claim()) ); });

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
// clear old caches
function clearOldCaches() {
  return caches.keys()
    .then(keylist => {
      return Promise.all(
        keylist
          .filter(key => key !== CACHE)
          .map(key => caches.delete(key))
      );
    });
}
// application activated
self.addEventListener('activate', event => {
  console.log('service worker: activate');
    // delete old caches
  event.waitUntil(
    clearOldCaches()
    .then(() => self.clients.claim())
    );
});

注意self.clients.claim()施行时将会把当下service worker作为被激活的worker。

Fetch 事件 该事件将会在互联网初阶央浼时发起。该事件管理函数中,大家得以选拔respondWith()措施来劫持HTTP的GET乞请然后赶回:

  1. 从缓存中取到的财富文件
  2. 一旦第一步战败,财富文件将会从互联网中选取Fetch API来获得(和service worker中的fetch事件毫无干系)。获取到的能源将会投入到缓存中。
  3. 假定第一步和第二步均战败,将会从缓存中回到准确的能源文件。

// application fetch network data self.addEventListener('fetch', event => { // abandon non-GET requests if (event.request.method !== 'GET') return; let url = event.request.url; event.respondWith( caches.open(CACHE) .then(cache => { return cache.match(event.request) .then(response => { if (response) { // return cached file console.log('cache fetch: ' + url); return response; } // make network request return fetch(event.request) .then(newreq => { console.log('network fetch: ' + url); if (newreq.ok) cache.put(event.request, newreq.clone()); return newreq; }) // app is offline .catch(() => offlineAsset(url)); }); }) ); });

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
29
30
31
32
33
34
35
36
37
38
39
40
41
// application fetch network data
self.addEventListener('fetch', event => {
  // abandon non-GET requests
  if (event.request.method !== 'GET') return;
  let url = event.request.url;
  event.respondWith(
    caches.open(CACHE)
      .then(cache => {
        return cache.match(event.request)
          .then(response => {
            if (response) {
              // return cached file
              console.log('cache fetch: ' + url);
              return response;
            }
            // make network request
            return fetch(event.request)
              .then(newreq => {
                console.log('network fetch: ' + url);
                if (newreq.ok) cache.put(event.request, newreq.clone());
                return newreq;
              })
              // app is offline
              .catch(() => offlineAsset(url));
          });
      })
  );
});

offlineAsset(url)办法中使用了有个别helper方法来回到正确的多少:

// 是还是不是为图片地址? let iExt = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp'].map(f => '.' + f); function isImage(url) { return iExt.reduce((ret, ext) => ret || url.endsWith(ext), false); } // return 重返离线能源 function offlineAsset(url) { if (isImage(url)) { // 重回图片 return new Response( '<svg role="img" view博克斯="0 0 400 300" xmlns=" d="M0 0h400v300H0z" fill="#eee" /><text x="200" y="150" text-anchor="middle" dominant-baseline="middle" font-family="sans-serif" font-size="50" fill="#ccc">offline</text></svg>', { headers: { 'Content-Type': 'image/svg+xml', 'Cache-Control': 'no-store' }} ); } else { // return page return caches.match(offlineURL); } }

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
29
30
31
32
// 是否为图片地址?
let iExt = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp'].map(f => '.' + f);
function isImage(url) {
  
  return iExt.reduce((ret, ext) => ret || url.endsWith(ext), false);
  
}
  
  
// return 返回离线资源
function offlineAsset(url) {
  
  if (isImage(url)) {
  
    // 返回图片
    return new Response(
      '<svg role="img" viewBox="0 0 400 300" xmlns="http://www.w3.org/2000/svg"><title>offline</title><path d="M0 0h400v300H0z" fill="#eee" /><text x="200" y="150" text-anchor="middle" dominant-baseline="middle" font-family="sans-serif" font-size="50" fill="#ccc">offline</text></svg>',
      { headers: {
        'Content-Type': 'image/svg+xml',
        'Cache-Control': 'no-store'
      }}
    );
  
  }
  else {
  
    // return page
    return caches.match(offlineURL);
  
  }
  
}

offlineAsset()艺术检查央浼是还是不是为一个图纸,然后重返四个富含“offline”文字的SVG文件。其余央求将会回去 offlineUSportageL 页面。

Chrome开拓者工具中的瑟维斯Worker部分提供了有关当前页面worker的音讯。在那之中会议及展览示worker中生出的失实,还能强制刷新,也得以让浏览器步向离线方式。

Cache Storage 部分例举了当前抱有曾经缓存的能源。你能够在缓存供给创新的时候点击refresh开关。

缓存页面

缓存页面显明是必得的,那是最基本的一部分,当您在离线的情形下加载页面会之后出现:

图片 1

究其原因便是因为您在离线状态下不能加载页面,今后有了 service worker,即便你在没网络的景色下,也可以加载从前缓存好的页面了。

第四步:创立可用的离线页面

离线页面能够是静态的HTML,一般用来提醒顾客最近乞求的页面暂且不能够选择。然则,我们得以提供部分能够阅读的页面链接。

Cache API能够在main.js中应用。然则,该API使用Promise,在不帮衬Promise的浏览器中会失利,全部的JavaScript实践会为此受到震慑。为了防止这种气象,在做客/js/offlinepage.js的时候大家加多了一段代码来检查当前是不是在离线情况中:

/js/offlinepage.js 中以版本号为名称保存了多年来的缓存,获取具备UENCOREL,删除不是页面包车型地铁U中华VL,将这一个U奥德赛L排序然后将全体缓存的U凯雷德L映以往页面上:

// cache name const CACHE = '::PWAsite', offlineURL = '/offline/', list = document.getElementById('cachedpagelist'); // fetch all caches window.caches.keys() .then(cacheList => { // find caches by and order by most recent cacheList = cacheList .filter(cName => cName.includes(CACHE)) .sort((a, b) => a - b); // open first cache caches.open(cacheList[0]) .then(cache => { // fetch cached pages cache.keys() .then(reqList => { let frag = document.createDocumentFragment(); reqList .map(req => req.url) .filter(req => (req.endsWith('/') || req.endsWith('.html')) && !req.endsWith(offlineURL)) .sort() .forEach(req => { let li = document.createElement('li'), a = li.appendChild(document.createElement('a')); a.setAttribute('href', req); a.textContent = a.pathname; frag.appendChild(li); }); if (list) list.appendChild(frag); }); }) });

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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// cache name
const
  CACHE = '::PWAsite',
  offlineURL = '/offline/',
  list = document.getElementById('cachedpagelist');
// fetch all caches
window.caches.keys()
  .then(cacheList => {
    // find caches by and order by most recent
    cacheList = cacheList
      .filter(cName => cName.includes(CACHE))
      .sort((a, b) => a - b);
    // open first cache
    caches.open(cacheList[0])
      .then(cache => {
        // fetch cached pages
        cache.keys()
          .then(reqList => {
            let frag = document.createDocumentFragment();
            reqList
              .map(req => req.url)
              .filter(req => (req.endsWith('/') || req.endsWith('.html')) && !req.endsWith(offlineURL))
              .sort()
              .forEach(req => {
                let
                  li = document.createElement('li'),
                  a = li.appendChild(document.createElement('a'));
                  a.setAttribute('href', req);
                  a.textContent = a.pathname;
                  frag.appendChild(li);
              });
            if (list) list.appendChild(frag);
          });
      })
  });

缓存后端接口数据

缓存接口数据是索要的,但亦非必需经过 service worker 来落到实处,前端存放数据的地点有无数,比方通过 localstorage,indexeddb 来举行仓库储存。这里笔者也是通过 service worker 来贯彻缓存接口数据的,尽管想透过其它方式来落成,只要求注意好 url 路线与数码对应的酷炫关系就可以。

开拓者工具

Chrome浏览器提供了一层层的工具来救助你来调解ServiceWorker,日志也会直接展现在调整台上。

您最佳使用匿超形式来开展付出职业,那样可避防去缓存对开拓的侵扰。

最后,Chrome的Lighthouse扩张也足以为你的渐进式Web应用提供一些改革音信。

缓存战术

明明了哪些能源要求被缓存后,接下去将在研讨缓存计谋了。

渐进式Web应用的核情感想

渐进式Web应用是一种新的本领,所以采用的时候自然要小心。也正是说,渐进式Web应用能够让你的网站在多少个钟头内获取改进,并且在不帮衬渐进式Web应用的浏览器上也不会潜濡默化网站的来得。

可是大家要求思考以下几点:

页面缓存战略

因为是 React 单页同构应用,每一次加载页面包车型地铁时候数据都以动态的,所以本身使用的是:

  1. 互连网优先的诀要,即优先得到互联网上风行的能源。当互联网哀告战败的时候,再去获取 service worker 里以前缓存的能源
  2. 当互联网加载成功未来,就革新 cache 中对应的缓存能源,保证下一次历次加载页面,都以上次探望的新式能源
  3. 只要找不到 service worker 中 url 对应的财富的时候,则去得到 service worker 对应的 /index.html 默许首页

// sw.js self.add伊夫ntListener('fetch', (e) => { console.log('以后正在呼吁:' + e.request.url); const currentUrl = e.request.url; // 相配上页面路线 if (matchHtml(currentUrl)) { const requestToCache = e.request.clone(); e.respondWith( // 加载网络上的财富fetch(requestToCache).then((response) => { // 加载败北 if (!response || response.status !== 200) { throw Error('response error'); } // 加载成功,更新缓存 const responseToCache = response.clone(); caches.open(cacheName).then((cache) => { cache.put(requestToCache, responseToCache); }); console.log(response); return response; }).catch(function() { // 获取对应缓存中的数据,获取不到则退步到收获暗中同意首页 return caches.match(e.request).then((response) => { return response || caches.match('/index.html'); }); }) ); } });

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
29
30
// sw.js
self.addEventListener('fetch', (e) => {
  console.log('现在正在请求:' + e.request.url);
  const currentUrl = e.request.url;
  // 匹配上页面路径
  if (matchHtml(currentUrl)) {
    const requestToCache = e.request.clone();
    e.respondWith(
      // 加载网络上的资源
      fetch(requestToCache).then((response) => {
        // 加载失败
        if (!response || response.status !== 200) {
          throw Error('response error');
        }
        // 加载成功,更新缓存
        const responseToCache = response.clone();
        caches.open(cacheName).then((cache) => {
          cache.put(requestToCache, responseToCache);
        });
        console.log(response);
        return response;
      }).catch(function() {
        // 获取对应缓存中的数据,获取不到则退化到获取默认首页
        return caches.match(e.request).then((response) => {
           return response || caches.match('/index.html');
        });
      })
    );
  }
});

怎么存在命中持续缓存页面的意况?

  1. 首先必要精晓的是,顾客在首先次加载你的站点的时候,加载页面后才会去运维sw,所以首先次加载不只怕由此 fetch 事件去缓存页面
  2. 本人的博客是单页应用,但是客商并不一定会透过首页步入,有相当大希望会因而任何页面路线步向到本身的网址,那就导致自家在 install 事件中一贯不能够钦赐供给缓存那个页面
  3. 最后落实的作用是:用户率先次展开页面,即刻断掉网络,还是得以离线访问笔者的站点

结缘方面三点,作者的议程是:第贰次加载的时候会缓存 /index.html 这些能源,而且缓存页面上的多寡,假如客商及时离线加载的话,那时候并未缓存对应的路径,比如 /archives 能源访谈不到,那重返 /index.html 走异步加载页面包车型地铁逻辑。

在 install 事件缓存 /index.html,保障了 service worker 第三次加载的时候缓存暗中认可页面,留下退路。

import constants from './constants'; const cacheName = constants.cacheName; const apiCacheName = constants.apiCacheName; const cacheFileList = ['/index.html']; self.addEventListener('install', (e) => { console.log('Service Worker 状态: install'); const cacheOpenPromise = caches.open(cacheName).then((cache) => { return cache.addAll(cacheFileList); }); e.waitUntil(cacheOpenPromise); });

1
2
3
4
5
6
7
8
9
10
11
12
import constants from './constants';
const cacheName = constants.cacheName;
const apiCacheName = constants.apiCacheName;
const cacheFileList = ['/index.html'];
 
self.addEventListener('install', (e) => {
  console.log('Service Worker 状态: install');
  const cacheOpenPromise = caches.open(cacheName).then((cache) => {
    return cache.addAll(cacheFileList);
  });
  e.waitUntil(cacheOpenPromise);
});

在页面加载完后,在 React 组件中马上缓存数据:

// cache.js import constants from '../constants'; const apiCacheName = constants.apiCacheName; export const saveAPIData = (url, data) => { if ('caches' in window) { // 伪造 request/response 数据 caches.open(apiCacheName).then((cache) => { cache.put(url, new Response(JSON.stringify(data), { status: 200 })); }); } }; // React 组件 import constants from '../constants'; export default class extends PureComponent { componentDidMount() { const { state, data } = this.props; // 异步加载数据 if (state === constants.INITIAL_STATE || state === constants.FAILURE_STATE) { this.props.fetchData(); } else { // 服务端渲染成功,保存页面数据 saveAPIData(url, data); } } }

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
// cache.js
import constants from '../constants';
const apiCacheName = constants.apiCacheName;
 
export const saveAPIData = (url, data) => {
  if ('caches' in window) {
    // 伪造 request/response 数据
    caches.open(apiCacheName).then((cache) => {
      cache.put(url, new Response(JSON.stringify(data), { status: 200 }));
    });
  }
};
 
// React 组件
import constants from '../constants';
export default class extends PureComponent {
  componentDidMount() {
    const { state, data } = this.props;
    // 异步加载数据
    if (state === constants.INITIAL_STATE || state === constants.FAILURE_STATE) {
      this.props.fetchData();
    } else {
        // 服务端渲染成功,保存页面数据
      saveAPIData(url, data);
    }
  }
}

如此就确认保障了客商率先次加载页面,立即离线访谈站点后,纵然不大概像第三遍同样能够服务端渲染数据,可是随后能经过获取页面,异步加载数据的办法创设离线应用。

图片 2

客商率先次访谈站点,要是在不刷新页面包车型地铁处境切换路由到任何页面,则会异步获取到的数据,当后一次探望对应的路由的时候,则失利到异步获取数据。

图片 3

当客商第一次加载页面包车型大巴时候,因为 service worker 已经调节了站点,已经颇具了缓存页面包车型地铁本领,之后在拜望的页面都将会被缓存只怕更新缓存,当客户离线访谈的的时候,也能访谈到服务端渲染的页面了。

图片 4

URL隐藏

当你的利用就是二个单UPRADOL的应用程序时(比方游戏),小编提议你遮掩地址栏。除却的情景作者并不建议你掩盖地址栏。在Manifest中,display: minimal-ui 或者 display: browser对此大多数情景的话足够用了。

接口缓存攻略

谈完页面缓存,再来说讲接口缓存,接口缓存就跟页面缓存很类似了,独一的例外在于:页面第一遍加载的时候不自然有缓存,不过会有接口缓存的存在(因为伪造了 cache 中的数据),所以缓存攻略跟页面缓存类似:

  1. 网络优先的法子,即优先得到互连网上接口数据。当互连网诉求失利的时候,再去获取 service worker 里在此以前缓存的接口数据
  2. 当互联网加载成功之后,就立异 cache 中对应的缓存接口数据,保险后一次每一遍加载页面,都以上次寻访的最新接口数据

由此代码就如那样(代码类似,不再赘述):

self.addEventListener('fetch', (e) => { console.log('现在正在呼吁:'

  • e.request.url); const currentUrl = e.request.url; if (matchHtml(currentUrl)) { // ... } else if (matchApi(currentUrl)) { const requestToCache = e.request.clone(); e.respondWith( fetch(requestToCache).then((response) => { if (!response || response.status !== 200) { return response; } const responseToCache = response.clone(); caches.open(apiCacheName).then((cache) => { cache.put(requestToCache, responseToCache); }); return response; }).catch(function() { 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
self.addEventListener('fetch', (e) => {
  console.log('现在正在请求:' + e.request.url);
  const currentUrl = e.request.url;
  if (matchHtml(currentUrl)) {
    // ...
  } else if (matchApi(currentUrl)) {
    const requestToCache = e.request.clone();
    e.respondWith(
      fetch(requestToCache).then((response) => {
        if (!response || response.status !== 200) {
          return response;
        }
        const responseToCache = response.clone();
        caches.open(apiCacheName).then((cache) => {
          cache.put(requestToCache, responseToCache);
        });
        return response;
      }).catch(function() {
        return caches.match(e.request);
      })
    );
  }
});

那边实在能够再打开优化的,举个例子在获取数据接口的时候,能够先读取缓存中的接口数据开展渲染,当真正的互联网接口数据再次来到之后再进行替换,那样也能使得压缩客户的首屏渲染时间。当然那或许会产生页面闪烁的效应,能够增进一些卡通来展开过渡。

缓存过大

你不能够将您网址中的全部剧情缓存下来。对于小一些的网址以来缓存全数剧情并不是三个主题素材,可是只要六个网址包蕴了上千个页面吗?很分明不是全体人对网址中的全部剧情都感兴趣。存款和储蓄是有限制的,假设您将兼具访问过的页面都缓存下来的话,缓存大小会拉长额非常的慢。

你能够那样制定你的缓存战略:

  • 只缓存首要的页面,譬喻主页,联系人页面和目前浏览作品的页面。
  • 无须缓存任何图片,录制和大文件
  • 定期清理旧的缓存
  • 提供三个“离线阅读”按键,这样客户就足以挑选要求缓存哪些内容了。

别的难点

到今天长逝,已经大概能够兑现 service worker 离线缓存应用的功能了,不过还也许有仍旧存在有的标题:

缓存刷新

示范代码中在提倡呼吁以前会先查询缓存。当客户处于离线状态时,那很好,不过一旦顾客处于在线状态,那她只会浏览到相比老旧的页面。

种种能源譬如图片和录像不会改换,所以一般都把那些静态能源设置为深刻缓存。这几个财富能够直接缓存一年(31,536,000秒)。在HTTP Header中,正是:

Cache-Control: max-age=31536000

1
Cache-Control: max-age=31536000

页面,CSS黄岩乱弹本文件大概变动的更频仍一些,所以您能够设置一个不大的缓存超时时间(24钟头),并确定保证在顾客网络连接苏醒时再一次从服务器央求:

Cache-Control: must-revalidate, max-age=86400

1
Cache-Control: must-revalidate, max-age=86400

您也能够在历次网址公布时,通过更名的法子强制浏览重视新央求财富。

迅猛激活 service worker

私下认可情状下,页面包车型地铁伏乞(fetch)不会通过 sw,除非它自身是通过 sw 获取的,也正是说,在装置 sw 之后,供给刷新页面才具有效能。sw 在设置成功并激活以前,不会响应 fetch或push等事件。

因为站点是单页面应用,那就形成了您在切换路由(未有刷新页面)的时候未有缓存接口数据,因为此时 service worker 还向来不从头工作,所以在加载 service worker 的时候须要火速地激活它。代码如下:

self.addEventListener('activate', (e) => { console.log('Service Worker 状态: activate'); const cachePromise = caches.keys().then((keys) => { return Promise.all(keys.map((key) => { if (key !== cacheName && key !== apiCacheName) { return caches.delete(key); } return null; })); }); e.waitUntil(cachePromise); // 飞速激活 sw,使其能够响应 fetch 事件 return self.clients.claim(); });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
self.addEventListener('activate', (e) => {
  console.log('Service Worker 状态: activate');
  const cachePromise = caches.keys().then((keys) => {
    return Promise.all(keys.map((key) => {
      if (key !== cacheName && key !== apiCacheName) {
        return caches.delete(key);
      }
      return null;
    }));
  });
  e.waitUntil(cachePromise);
  // 快速激活 sw,使其能够响应 fetch 事件
  return self.clients.claim();
});

一对小说说还亟需在 install 事件中加多 self.skipWaiting(); 来跳过等待时间,可是自个儿在奉行中发掘即使不增多也得以不荒谬激活 service worker,原因不详,有读者知道的话能够调换下。

明天当您首先次加载页面,跳转路由,马上离线访谈的页面,也得以顺遂地加载页面了。

小结

从这之后,相信您只要遵照本文一步一步操作下来,你也得以高速把温馨的Web应用转为PWA。在转为了PWA后,借使有利用满足PWA 模型的前端控件的急需,你能够推行纯前端表格控件SpreadJS,适用于 .NET、Java 和移动端等楼台的报表控件一定不会让你失望的。

原稿链接:

1 赞 1 收藏 评论

图片 5

不要强缓存 sw.js

客商每一遍访问页面包车型客车时候都会去重新获得sw.js,依据文件内容跟在此之前的版本是或不是一样来判别 service worker 是不是有立异。所以倘诺您对 sw.js 开启强缓存的话,就将深陷死循环,因为每一趟页面得到到的 sw.js 没什么区别,那样就无法晋级你的 service worker。

别的对 sw.js 开启强缓存也是不须求的:

  1. 自小编 sw.js 文件本身就一点都不大,浪费不了多少带宽,感觉浪费能够行使公约缓存,但附加增支担当
  2. sw.js 是在页面空闲的时候才去加载的,并不会影响客户首屏渲染速度

防止改换 sw 的 ULX570L

在 sw 中如此做是“最差实行”,要在原地方上修改 sw。

举个例证来声明为什么:

  1. index.html 注册了 sw-v1.js 作为 sw
  2. sw-v1.js 对 index.html 做了缓存,也正是缓存优先(offline-first)
  3. 你更新了 index.html 重新登记了在新鸿基土地资产方的 sw sw-v2.js

若果您像上面那么做,客户永久也拿不到 sw-v2.js,因为 index.html 在 sw-v1.js 缓存中,那样的话,借使您想翻新为 sw-v2.js,还索要改换原来的 sw-v1.js。

测试

而后,大家已经到位了选用 service worker 对页面进行离线缓存的功用,假若想体验效果的话,访谈作者的博客:

随便浏览任性的页面,然后关掉互联网,再一次访谈,以前你浏览过的页面都得以在离线的气象下进展探望了。

IOS 必要 11.3 的版本才支撑,使用 Safari 进行拜谒,Android 请选取匡助service worker 的浏览器

manifest 桌面应用

后面讲完了怎么行使 service worker 来离线缓存你的同构应用,不过 PWA 不仅只限于此,你还是可以利用安装 manifest 文件来将您的站点增多到活动端的桌面上,从而到达趋近于原生应用的体会。

使用 webpack-pwa-manifest 插件

本人的博客站点是经过 webpack 来营造前端代码的,所以本人在社区里找到 webpack-pwa-manifest 插件用来生成 manifest.json。

率先安装好 webpack-pwa-manifest 插件,然后在你的 webpack 配置文件中加上:

// webpack.config.prod.js const WebpackPwaManifest = require('webpack-pwa-manifest'); module.exports = webpackMerge(baseConfig, { plugins: [ new WebpackPwaManifest({ name: 'Lindz's Blog', short_name: 'Blog', description: 'An isomorphic progressive web blog built by React & Node', background_color: '#333', theme_color: '#333', filename: 'manifest.[hash:8].json', publicPath: '/', icons: [ { src: path.resolve(constants.publicPath, 'icon.png'), sizes: [96, 128, 192, 256, 384, 512], // multiple sizes destination: path.join('icons') } ], ios: { 'apple-mobile-web-app-title': 'Lindz's Blog', 'apple-mobile-web-app-status-bar-style': '#000', 'apple-mobile-web-app-capable': 'yes', 'apple-touch-icon': '//xxx.com/icon.png', }, }) ] })

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
// webpack.config.prod.js
const WebpackPwaManifest = require('webpack-pwa-manifest');
module.exports = webpackMerge(baseConfig, {
  plugins: [
    new WebpackPwaManifest({
      name: 'Lindz's Blog',
      short_name: 'Blog',
      description: 'An isomorphic progressive web blog built by React & Node',
      background_color: '#333',
      theme_color: '#333',
      filename: 'manifest.[hash:8].json',
      publicPath: '/',
      icons: [
        {
          src: path.resolve(constants.publicPath, 'icon.png'),
          sizes: [96, 128, 192, 256, 384, 512], // multiple sizes
          destination: path.join('icons')
        }
      ],
      ios: {
        'apple-mobile-web-app-title': 'Lindz's Blog',
        'apple-mobile-web-app-status-bar-style': '#000',
        'apple-mobile-web-app-capable': 'yes',
        'apple-touch-icon': '//xxx.com/icon.png',
      },
    })
  ]
})

简言之地论述下布署新闻:

  1. name: 应用名称,便是Logo下边的显得名称
  2. short_name: 应用名称,但 name 无法体现完全时候则浮现那么些
  3. background_color、theme_color:看名称就会想到其意义,相应的颜色
  4. publicPath: 设置 cdn 路径,跟 webpack 里的 publicPath 一样
  5. icons: 设置Logo,插件会自行帮您转移分化 size 的图纸,不过图片大小必须超过最大 sizes
  6. ios: 设置在 safari 中什么去增多桌面应用

安装完未来,webpack 会在营造进度中生成对应的 manifest 文件,并在 html 文件中引用,上面正是生成 manifest 文件:

{ "icons": [ { "src": "/icons/icon_512x512.79ddc5874efb8b481d9a3d06133b6213.png", "sizes": "512x512", "type": "image/png" }, { "src": "/icons/icon_384x384.09826bd1a5d143e05062571f0e0e86e7.png", "sizes": "384x384", "type": "image/png" }, { "src": "/icons/icon_256x256.d641a3644ce20c06855db39cfb2f7b40.png", "sizes": "256x256", "type": "image/png" }, { "src": "/icons/icon_192x192.8f11e077242cccd9c42c0cbbecd5149c.png", "sizes": "192x192", "type": "image/png" }, { "src": "/icons/icon_128x128.cc0714ab18fa6ee6de42ef3d5ca8fd09.png", "sizes": "128x128", "type": "image/png" }, { "src": "/icons/icon_96x96.dbfccb1a5cef8093a77c079f761b2d63.png", "sizes": "96x96", "type": "image/png" } ], "name": "Lindz's Blog", "short_name": "Blog", "orientation": "portrait", "display": "standalone", "start_url": ".", "description": "An isomorphic progressive web blog built by React & Node", "background_color": "#333", "theme_color": "#333" }

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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
  "icons": [
    {
      "src": "/icons/icon_512x512.79ddc5874efb8b481d9a3d06133b6213.png",
      "sizes": "512x512",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_384x384.09826bd1a5d143e05062571f0e0e86e7.png",
      "sizes": "384x384",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_256x256.d641a3644ce20c06855db39cfb2f7b40.png",
      "sizes": "256x256",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_192x192.8f11e077242cccd9c42c0cbbecd5149c.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_128x128.cc0714ab18fa6ee6de42ef3d5ca8fd09.png",
      "sizes": "128x128",
      "type": "image/png"
    },
    {
      "src": "/icons/icon_96x96.dbfccb1a5cef8093a77c079f761b2d63.png",
      "sizes": "96x96",
      "type": "image/png"
    }
  ],
  "name": "Lindz's Blog",
  "short_name": "Blog",
  "orientation": "portrait",
  "display": "standalone",
  "start_url": ".",
  "description": "An isomorphic progressive web blog built by React & Node",
  "background_color": "#333",
  "theme_color": "#333"
}

html 中会援引这一个文件,并且增加对 ios 增多桌面应用的支撑,如同这么。

<!DOCTYPE html> <html lang=en> <head> <meta name=apple-mobile-web-app-title content="Lindz's Blog"> <meta name=apple-mobile-web-app-capable content=yes> <meta name=apple-mobile-web-app-status-bar-style content=#838a88> <link rel=apple-touch-icon href=xxxxx> <link rel=manifest href=/manifest.21d63735.json> </head> </html>

1
2
3
4
5
6
7
8
9
10
<!DOCTYPE html>
<html lang=en>
<head>
  <meta name=apple-mobile-web-app-title content="Lindz's Blog">
  <meta name=apple-mobile-web-app-capable content=yes>
  <meta name=apple-mobile-web-app-status-bar-style content=#838a88>
  <link rel=apple-touch-icon href=xxxxx>
  <link rel=manifest href=/manifest.21d63735.json>
</head>
</html>

就这么简单,你就足以应用 webpack 来增添你的桌面应用了。

测试

增多完之后您能够经过 chrome 开采者工具 Application – Manifest 来查阅你的 mainfest 文件是不是见效:

图片 6

这么表达你的布置生效了,安卓时机自动识别你的配置文件,并问询顾客是还是不是丰裕。

结尾

讲到那大约就完了,等现在 IOS 支持 PWA 的其他功效的时候,到时候作者也会相应地去试行其余 PWA 的表征的。未来 IOS 11.3 也唯有协助 PWA 中的 service worker 和 app manifest 的意义,可是相信在不久的前天,其余的法力也会相应获得帮助,到时候相信 PWA 将会在移动端怒放异彩的。

1 赞 收藏 评论

图片 7

本文由华夏彩票发布于前端技术,转载请注明出处:入门教程,升级指南

您可能还会对下面的文章感兴趣: