漸進式Web應用(PWA)入門教程(下)

来源:https://www.cnblogs.com/powertoolsteam/archive/2018/05/23/ProgressiveWebApps_2.html
-Advertisement-
Play Games

上篇文章我們對漸進式Web應用(PWA)做了一些基本的介紹。 漸進式Web應用(PWA)入門教程(上) 在這一節中,我們將介紹PWA的原理是什麼,它是如何開始工作的。 第一步:使用HTTPS 漸進式Web應用程式需要使用HTTPS連接。雖然使用HTTPS會讓您伺服器的開銷變多,但使用HTTPS可以讓 ...


上篇文章我們對漸進式Web應用(PWA)做了一些基本的介紹。

漸進式Web應用(PWA)入門教程(上)

在這一節中,我們將介紹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

第二步:創建一個應用程式清單(Manifest)

應用程式清單提供了和當前漸進式Web應用的相關信息,如:

  • 應用程式名
  • 描述
  • 所有圖片(包括主屏幕圖標,啟動屏幕頁面和用的圖片或者網頁上用的圖片)

本質上講,程式清單是頁面上用到的圖標和主題等資源的元數據。

程式清單是一個位於您應用根目錄的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"
    }
  ]
}

  

程式清單文件建立完之後,你需要在每個頁面上引用該文件:

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

以下屬性在程式清單中經常使用,介紹說明如下:

  • name: 用戶看到的應用名稱
  • short_name: 應用短名稱。當顯示應用名稱的地方不夠時,將使用該名稱。
  • description: 應用描述。
  • start_url: 應用起始路徑,相對路徑,預設為/。
  • scope: URL範圍。比如:如果您將“/app/”設置為URL範圍時,這個應用就會一直在這個目錄中。
  • 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: 一個包含所有圖片的數組。該數組中每個元素包含了圖片的URL,大小和類型。

第三步:創建一個 Service Worker

Service Worker 是一個可編程的伺服器代理,它可以攔截或者響應網路請求。Service Worker 是位於應用程式根目錄的一個個的JavaScript文件。

您需要在頁面對應的JavaScript文件中註冊該ServiceWorker:

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

如果您不需要離線的相關功能,您可以只創建一個 /service-worker.js文件,這樣用戶就可以直接安裝您的Web應用了!

Service Worker這個概念可能比較難懂,它其實是一個工作在其他線程中的標準的Worker,它不可以訪問頁面上的DOM元素,沒有頁面上的API,但是可以攔截所有頁面上的網路請求,包括頁面導航,請求資源,Ajax請求。

上面就是使用全站HTTPS的主要原因了。假設您沒有在您的網站中使用HTTPS,一個第三方的腳本就可以從其他的功能變數名稱註入他自己的ServiceWorker,然後篡改所有的請求——這無疑是非常危險的。

Service Worker 會響應三個事件:install,activate和fetch。

Install事件

該事件將在應用安裝完成後觸發。我們一般在這裡使用Cache API緩存一些必要的文件。

首先,我們需要提供如下配置

  1. 緩存名稱(CACHE)以及版本(version)。應用可以有多個緩存存儲,但是在使用時只會使用其中一個緩存存儲。每當緩存存儲有變化時,新的版本號將會指定到緩存存儲中。新的緩存存儲將會作為當前的緩存存儲,之前的緩存存儲將會被作廢。
  2. 一個離線的頁面地址(offlineURL):當用戶訪問了之前沒有訪問過的地址時,該頁面將會顯示。
  3. 一個包含了所有必須文件的數組,包括保障頁面正常功能的CSS和JavaScript。在本示例中,我還添加了主頁和logo。當有不同的URL指向同一個資源時,你也可以將這些URL分別寫到這個數組中。offlineURL將會加入到這個數組中。
  4. 我們也可以將一些非必要的緩存文件(installFilesDesirable)。這些文件在安裝過程中將會被下載,但如果下載失敗,不會觸發安裝失敗。
// 配置文件
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);
 
    });
 
}

最後,我們添加一個install的事件監聽器。waitUntil方法保證了service worker不會安裝直到其相關的代碼被執行。這裡它會執行installStaticFiles()方法,然後self.skipWaiting()方法來激活service worker:

// 應用安裝
self.addEventListener('install', event => {
 
  console.log('service worker: install');
 
  // 緩存主要文件
  event.waitUntil(
    installStaticFiles()
    .then(() => self.skipWaiting())
  );
 
});

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())
    );
 
});

註意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));
 
          });
 
      })
 
  );
 
});

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" 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文件。其他請求將會返回 offlineURL 頁面。

Chrome開發者工具中的ServiceWorker部分提供了關於當前頁面worker的信息。其中會顯示worker中發生的錯誤,還可以強制刷新,也可以讓瀏覽器進入離線模式。

Cache Storage 部分例舉了當前所有已經緩存的資源。你可以在緩存需要更新的時候點擊refresh按鈕。

第四步:創建可用的離線頁面

離線頁面可以是靜態的HTML,一般用於提醒用戶當前請求的頁面暫時無法使用。然而,我們可以提供一些可以閱讀的頁面鏈接。

Cache API可以在main.js中使用。然而,該API使用Promise,在不支持Promise的瀏覽器中會失敗,所有的JavaScript執行會因此受到影響。為了避免這種情況,在訪問/js/offlinepage.js的時候我們添加了一段代碼來檢查當前是否在離線環境中:

/js/offlinepage.js 中以版本號為名稱保存了最近的緩存,獲取所有URL,刪除不是頁面的URL,將這些URL排序然後將所有緩存的URL展示在頁面上:

// 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);
 
          });
 
      })
 
  });

開發者工具

Chrome瀏覽器提供了一系列的工具來幫助您來調試Service Worker,日誌也會直接顯示在控制臺上。

您最好使用匿名模式來進行開發工作,這樣可以排除緩存對開發的干擾。

最後,Chrome的Lighthouse擴展也可以為您的漸進式Web應用提供一些改進信息。

漸進式Web應用的要點

漸進式Web應用是一種新的技術,所以使用的時候一定要小心。也就是說,漸進式Web應用可以讓您的網站在幾個小時內得到改善,並且在不支持漸進式Web應用的瀏覽器上也不會影響網站的顯示。

但是我們需要考慮以下幾點:

URL隱藏

當您的應用就是一個單URL的應用程式時(比如游戲),我建議您隱藏地址欄。除此之外的情況我並不建議您隱藏地址欄。在Manifest中,display: minimal-ui 或者 display: browser對於大多數情況來說足夠用了。

緩存過大

你不能將您網站中的所有內容緩存下來。對於小一些的網站來說緩存所有內容並不是一個問題,但是如果一個網站包含了上千個頁面呢?很明顯不是所有人對網站中的所有內容都感興趣。存儲是有限制的,如果您將所有訪問過的頁面都緩存下來的話,緩存大小會增長額很快。

你可以這樣制定你的緩存策略:

  • 只緩存重要的頁面,比如主頁,聯繫人頁面和最近瀏覽文章的頁面。
  • 不要緩存任何圖片,視頻和大文件
  • 定時清理舊的緩存
  • 提供一個“離線閱讀”按鈕,這樣用戶就可以選擇需要緩存哪些內容了。

緩存刷新

示例代碼中在發起請求之前會先查詢緩存。當用戶處於離線狀態時,這很好,但是如果用戶處於線上狀態,那他只會瀏覽到比較老舊的頁面。

各種資源比如圖片和視頻不會改變,所以一般都把這些靜態資源設置為長期緩存。這些資源可以直接緩存一年(31,536,000秒)。在HTTP Header中,就是:

Cache-Control: max-age=31536000

頁面,CSS和腳本文件可能變化的更頻繁一些,所以你可以設置一個比較小的緩存超時時間(24小時),並確保在用戶網路連接恢復時再次從伺服器請求:

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

你也可以在每次網站發佈時,通過改名的方式強制瀏覽器重新請求資源。

小結

至此,相信你如果按照本文一步一步操作下來,你也可以很快把自己的Web應用轉為PWA。在轉為了PWA後,如果有使用滿足 PWA 模型的前端控制項的需求,你可以試試純前端表格控制項SpreadJS,適用於 .NET、Java 和移動端等平臺的表格控制項一定不會令你失望的。

原文鏈接:https://www.sitepoint.com/retrofit-your-website-as-a-progressive-web-app/


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 一、 HTTP協議簡介 二、 HTTP協議之請求Request 三、 HTTP協議之響應Response 四、 HTTP協議完整工作流程 五、 HTTP協議關鍵性總結 六、自定義套接字分析HTTP協議 一、 HTTP協議簡介 作為學習前端開發的開始,我們必須搞明白以下幾件事 1、什麼是互聯網 互聯網 ...
  • 涉及到offset等有關獲取各種尺寸問題下 次總結 ...
  • 1、頁面內跳轉 當<a>元素用於頁面內的錨點跳轉時,應該先為該頁面設置一些錨點,而定義錨點有兩種辦法: 通過<a>元素的name屬性來定義,如:<a name="anchor-name">name屬性的值就是錨點的名稱<a> 通過其他元素的id屬性來定義,如:<div id="anchor-name ...
  • jQuery UI 其建立在 jQuery JavaScript 庫上。大致涉及三方面:用戶界面交互(與滑鼠交互相關的內容)、特效(提供豐富的動畫)、小部件(主要是一些界面的擴展)及主題 先來看一個用jQuery UI實現一個簡單的選擇題 Interactions主要包括(droppable,res ...
  • HTML5拖放 拖放(Drag和drop)是H5標準的組成部分 此處需具備js基礎知識及其H5拖拽部分相關方法 下麵來看幾個例子 第一:本地拖放 第二:H5拖放 ...
  • 前面的話 CSS不能算是嚴格意義的編程語言,但是在前端體系中卻不能小覷。 CSS 是以描述為主的樣式表,如果描述得混亂、沒有規則,對於其他開發者一定是一個定時炸彈,特別是有強迫症的人群。CSS 看似簡單,想要寫出漂亮的 CSS 還是相當困難。所以校驗 CSS 規則的行動迫在眉睫。stylelint是 ...
  • 倒圓角 <!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Document</title></head><body> <h1>圓角邊框 —— border-radius IE9</h1> <!-- border-r ...
  • [1]發展歷史 [2]詳細配置 [3]NodeJS [4]React [5]Vue ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...