<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jacky810124 on Medium]]></title>
        <description><![CDATA[Stories by Jacky810124 on Medium]]></description>
        <link>https://medium.com/@jacky810124?source=rss-56f3dc05bd29------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*9jLDkIPfR_MwXTQecWIGqg.png</url>
            <title>Stories by Jacky810124 on Medium</title>
            <link>https://medium.com/@jacky810124?source=rss-56f3dc05bd29------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 19:47:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jacky810124/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Firebase Dynamic Link — 簡單介紹]]></title>
            <link>https://medium.com/swag/firebase-dynamic-link-%E7%B0%A1%E5%96%AE%E4%BB%8B%E7%B4%B9-fd8259974eec?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/fd8259974eec</guid>
            <category><![CDATA[engineering]]></category>
            <category><![CDATA[firebasedynamiclinks]]></category>
            <category><![CDATA[universal-links]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Fri, 03 May 2019 04:19:34 GMT</pubDate>
            <atom:updated>2019-05-03T04:19:34.560Z</atom:updated>
            <content:encoded><![CDATA[<h3>Firebase Dynamic Link — 簡單介紹</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KSwrRSczAE4y1DUm1k4MSA.jpeg" /></figure><p>使用者在社群中分享網頁連結，當其他人看到並且有安裝 Mobile App 時，會希望使用者能夠自動開啟 Mobile App；或是尚未安裝時，能夠自動導到 App Store 或是 Play Store。</p><p>Firebase Dynamic Link 可以讓這件事情變得簡單點，先來看一下介紹影片。</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FLvY1JMcrPF8%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DLvY1JMcrPF8&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FLvY1JMcrPF8%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/ac54579ee62d7ef9cf8656254d018d9a/href">https://medium.com/media/ac54579ee62d7ef9cf8656254d018d9a/href</a></iframe><p>看完之後是不是很心動呢？接下來介紹一下 Firebase Dynamic Link 吧！</p><h3>創建 Dynamic Link</h3><p>創建 Firebase Dynamic Link 可以透過幾種方式來創建：</p><ul><li>Firebase Console</li><li>REST API</li><li>SDK</li><li>手動創建</li></ul><p>大家可以挑選適合的方式來創建，今天將會著重在<strong>手動創建</strong>這個方式的小細節。</p><p>在預設情況下，Firebase 提供 page.link 這個域名供使用者使用，能夠自行設定不同的子網域來區分不同的用途，像是：</p><pre>// SWAG 專用的 Dynamic Link<br>swag.page.link</pre><pre>// SWAG 活動專用的 Dynamin Link<br>swagevent.page.link</pre><p>若使用者想使用自己的網域名稱，也可以在 Firebase Console 中來設定，使用自訂的網域名稱，大概會長得像這樣：</p><pre>link.swag.live</pre><p>這個部分就看實際使用的情境來決定。</p><h3>手動創建</h3><p>Firebase Dynamic Link 可以透過自行組合參數來創建，像是：</p><pre>https://link.swag.live?link=<strong>your_deep_link</strong>&amp;apn=<strong>android_package_name</strong></pre><p>若使用者有安裝對應的 Android App 則會直接開啟 Android App；若無，則會自動導到 Play Store。</p><p>Firebase Dynamic Link 的參數會分成幾個部分：</p><ul><li>Deep Link Parameters</li><li>Android Parameters</li><li>iOS Parameters</li><li>Other Platform Parameters</li><li>Navigation Parameters</li><li>Social Meta Tag Parameters</li><li>Analytics Parameters</li><li>Debug Parameters</li></ul><h4>Deep Link Parameters</h4><p>Deep Link 的參數主要是提供 App 和退到網頁版來使用，若使用者已安裝 Mobile App 則直接透過 App 來開啟；若尚未安裝，則看是要導到商店或是退到網頁版。</p><p><strong>link<br></strong>Mobile App 將會開啟的 URL，指定 App 可以處理的 URL，一般來說是 App 的內容或是啟動特定 App 邏輯的 Payload；link 會是格式良好且 URL 編碼過的 URL，可以是 HTTP 或 HTTPS，且不能為另一個 Firebase Dynamic Link。</p><p>在桌面裝置的瀏覽器上開啟時，將會開啟這個連結，除非有另外指定 ofl。</p><h4>Android Parameters</h4><p>這部分的參數主要是提供給 Android 來使用。</p><p><strong>apn<br></strong>Android 用來開啟連結的 Package name，且該 App 在 Firebase Console 的 Overview 頁面中，應該要與專案被連結在一起；對於 Dynamic Link 要開啟 Android App 來說是必要的。</p><p><strong>afl<br></strong>當 Android App 尚未安裝時所開啟的連結，這個連結用來指定一些像是開啟手機版的網頁，或是一些 App 的促銷頁面，並非用在使用者尚未安裝 App 時，從 Play Store 安裝 App 的用途。</p><p><strong>amv<br></strong>App 能夠開啟此連結的最低版本，如果安裝的較舊的版本時，將會導至 Play Store 來升級 App。</p><h4>iOS Parameters</h4><p>這部分的參數主要提供給 iOS 和 iPads 來使用。</p><p><strong>ibi<br></strong>用來開啟連結的 iOS App Bundle ID，該 App 應該要在 Firebase Console 的 Overview 中與專案連結在一起；對於 Dynamic Link 要開啟 iOS App 來說是必要的。</p><p><strong>ifl<br></strong>當 iOS App 尚未安裝時所開啟的連結，用來指定一些像是開啟手機版的網頁，或是開啟 App 的促銷頁面，並非用在使用者尚未安裝 App 時，開啟 App Store 讓使用者安裝 App 的用途。</p><p><strong>ius<br></strong>自訂的 URL Schema。</p><p><strong>ipfl<br></strong>當 App 尚未安裝時，在 iPads 上所開啟的連結，與 ifl 的用途類似，只是專門用在 iPads 上。</p><p><strong>ipbi<br></strong>在 iPads 上用來開啟連結的 App Bundle ID，該 App 必須要在 Firebase Console 的 Overview 頁面中與專案連結在一起。</p><p><strong>isi</strong><br>App 的 Apple Store ID，當使用者尚未安裝 App 時用來帶使用者到 App Store。</p><p><strong>imv<br></strong>能夠開啟連結的最低 App 版本，當 App 開啟時，這個 flag 會被傳到 App 中，App 中必須決定該如何處理。</p><h4>Other Parameters</h4><p>主要為除了 Android 和 iOS 平台外所使用的參數。</p><p><strong>ofl</strong><br>除了 Android 和 iOS 平台，其他平台所開啟的連結，這在電腦版中用來指定不同的行為非常好用，像是開啟 App 內容的滿版網頁，或是其他用來安裝 App 的 Dynamic Link Payload。</p><h4>Navigation Parameters</h4><p>Navigation 所使用的參數。</p><p><strong>efr</strong><br>將 <strong>efr</strong> 設為 1 開啟 Dynamic Link 時會略過 App 的預覽頁面，直接跳轉到商店或是 App；App 的預覽畫面在使用者開啟 Dynamic Link時，可以更可靠的將使用者帶到更適合的目的地</p><p>然而，如果你期望 Dynamic Link 只在 App 中被開啟，在沒有 App 的預覽畫面時會更可靠，因此也可以選擇將 <strong>efr</strong> 設為 0 來停止它。</p><blockquote>App 的預覽畫面現在只會在 iOS 上出現， Android 上之後可能也會出現，這個參數將會影響到 Dynamic Link 在兩個平台上的行為。</blockquote><h4>Social Meta Tag Parameters</h4><p>用在社群分享的參數。</p><p><strong>st</strong><br>用來當作分享在社群貼文中的標題。</p><p><strong>sd</strong><br>用來當作分享在社群貼文中的描述。</p><p><strong>si</strong><br>跟這個連結有相關的圖片，圖片至少要 300*200px 且小於 300KB。</p><h4>Analytics Parameters</h4><p>用於數據分析的參數。</p><p><strong>Google Play Analytics Parameters</strong></p><ul><li>utm_source</li><li>utm_medium</li><li>utm_campaign</li><li>utm_term</li><li>utm_content</li><li>gclid</li></ul><p><strong>iTunes Connect Analytics Parameters</strong></p><ul><li>at</li><li>ct</li><li>mt</li><li>pt</li></ul><h4>Debug Parameters</h4><p>用於偵錯的參數。</p><p><strong>d</strong><br>透過將 <strong>d</strong> 設為 1 進入偵錯模式，將會產生 Dynamic Link 的行為流程圖，而不是載入 Dynamic Link，可以用來預覽 Dynamic Link 在不同平台和配置的行為。</p><pre>https://link.swag.live?link=your_deep_link&amp;<strong>d=1</strong></pre><h3>總結</h3><p>使用 Firebase Dynamic Link 時，可以結合 Android 和 iOS 兩平台的參數，來產生在 Android 和 iOS 上都能夠使用的 Dynamic Link。</p><p>另外，當使用者尚未安裝 Mobile App 時，不是每次都需要導到商店，這種情況下 iOS Parameters 可以不帶 <strong>isi</strong>，這樣就能夠不跳到 App Store。</p><p><strong>ifl</strong>、<strong>ipfl</strong>、<strong>afl</strong> 和 <strong>ofl</strong> 在大多數的情況下可以不用帶，但如果有需要針對尚未安裝 Mobile App 的使用者有不同行為（像是：安裝 Mobile App 就能夠獲得一些特別促銷……等），在這種情況下就蠻適合透過這幾個參數，來設定這種不同的行為。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fd8259974eec" width="1" height="1" alt=""><hr><p><a href="https://medium.com/swag/firebase-dynamic-link-%E7%B0%A1%E5%96%AE%E4%BB%8B%E7%B4%B9-fd8259974eec">Firebase Dynamic Link — 簡單介紹</a> was originally published in <a href="https://medium.com/swag">SWAG</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day08 — 好好用的推播訊息 Part 2 — 動手做]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day08-%E5%A5%BD%E5%A5%BD%E7%94%A8%E7%9A%84%E6%8E%A8%E6%92%AD%E8%A8%8A%E6%81%AF-part-2-%E5%8B%95%E6%89%8B%E5%81%9A-42699becd105?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/42699becd105</guid>
            <category><![CDATA[service-worker]]></category>
            <category><![CDATA[web-push-notifications]]></category>
            <category><![CDATA[push-notification]]></category>
            <category><![CDATA[pwa]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Tue, 18 Sep 2018 06:08:26 GMT</pubDate>
            <atom:updated>2018-09-18T06:28:11.882Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>繼上篇（ <a href="https://medium.com/@jacky810124/progressive-web-application-day07-%E5%A5%BD%E5%A5%BD%E7%94%A8%E7%9A%84%E6%8E%A8%E6%92%AD%E8%A8%8A%E6%81%AF-part-1-%E7%B0%A1%E4%BB%8B-59d4cdb69a25">Progressive Web Application Day07 — 好好用的推播訊息 Part 1 — 簡介</a> ）簡單的介紹了推播流程，接下來就要進入動手做的系列了；由於推播的部分，需要跟著後端一起配合，這次動手做也會實作這部分。</p><p><a href="https://github.com/jacky810124/pwa-day08">這次完整的程式碼都會放在 Github 上，有興趣的人可以參考一下連結。</a></p><p><a href="https://pwa-day08.firebaseapp.com/">範例網站可以參考這個連結。</a></p><p>這次的教學文章中，每個小段落都會有 Git Commit 的連結，可以看出這次的段落到底新增了什麼東西，亦或是刪除了哪些區塊，可以當作每個小段落的總結。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vPq2rjPLhqEeKvNRCDYK3A.png" /><figcaption>Git Commit Diff Demonstration</figcaption></figure><h3>Functional Map</h3><p>這次 Demo Site 會專注在推播的部分，因此把其餘的部分都先移除掉，預計會有的功能如下：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-5kpfra7xv0r9-OViTOHdA.png" /><figcaption>Demo Site Functional Map</figcaption></figure><p>雖然看起來功能少少的，但其中的步驟還蠻繁瑣的 😩 。</p><h3>Wireframe</h3><p>這個是預計會完成的樣子，有點像是個人介紹的區塊；區塊中會有大頭貼、摘要還有訂閱的按鈕，蠻符合這次 Demo 的核心目標。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pryAb_pG-RdWdti_3WSkxw.png" /><figcaption>Demo Site Wireframe</figcaption></figure><p>接著，就把版面先切出來吧。</p><h3>切版</h3><p>下面就是版面已經完成的模樣，基本上就是只有一個訂閱的功能而已 😆 ；有看程式碼的夥伴們，會發現樣式的命名方式，採用 BEM 的命名規則，對 BEM 有興趣的夥伴們，可以在下方敲碗、留言，找時間再寫一篇。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/532/1*WsLjzQaBBPFkdwSi3KnUzQ.png" /><figcaption>Demo Site Layout</figcaption></figure><p><a href="https://github.com/jacky810124/pwa-day08/commit/fe8f5785d604c021740c7df9b3bb4168549261a4">這階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/fe8f5785d604c021740c7df9b3bb4168549261a4">✨ Feat: finish layout · jacky810124/pwa-day08@fe8f578</a></p><h3>前端—新增訂閱</h3><p>在開始新增訂閱資訊到後端，必須要完成一些初始化的工作：</p><ol><li>註冊 Service Worker</li><li>公、私金鑰</li></ol><h4>註冊 Service Worker</h4><p>前端想要接收到推播訊息，必須透過 Service Worker 在背景執行，才能夠隨時隨地，接收來自伺服器的推播訊息；因此使用者的裝置必須支援 Service Worker 和 Push Manager ，也必須要先註冊好 Service Worker ，才能夠進行接下來的步驟。</p><p>接著就開始註冊 Service Worker 吧。</p><p>在專案的根目錄下，新增 app.js 來擺放主要的 JavaScript 程式碼；並在 app.js 中新增以下的程式碼。</p><pre>const PUBLIC_KEY = &#39;BCDMOxYAhVUZY1cXwkXsKuKztlqfOXjowcriucykb5qBmFq-8lVMVx3bJbFOmLSci1Jq_SPqBdFeWGi0jcHJfXM&#39;<br>const NOTIFICATION_USABILITY = &#39;serviceWorker&#39; in navigator &amp;&amp; &#39;PushManager&#39; in window</pre><pre>/**<br> * initialization function<br> */<br>const init = () =&gt; {<br>  const subscribeButton = document<br>    .querySelector(&#39;.user-profile__subscribe-button&#39;)</pre><pre>  if (!NOTIFICATION_USABILITY) {<br>    console.log(&#39;Service Worker and Push is supported&#39;)</pre><pre>    // Disable subscribe button when user device is not support<br>    subscribeButton.innerHTML = &#39;未支援訂閱&#39;<br>    subscribeButton.disabled = true<br>  } else {<br>    navigator<br>      .serviceWorker<br>      .register(&#39;sw.js&#39;)<br>      .then((registration) =&gt; {<br>        console.log(&#39;Service Worker is registered&#39;)</pre><pre>        return getSubscription(registration)<br>      })<br>      .then(subscription =&gt; {<br>        const isSubscribed = subscription !== null</pre><pre>        if (isSubscribed) {<br>          saveSubscription(subscription)</pre><pre>          subscribeButton.innerHTML = &#39;已訂閱&#39;<br>          subscribeButton.disabled = true<br>        }<br>      })<br>      .catch(error =&gt; {<br>        console.error(&#39;Service Worker Error&#39;, error)<br>      })<br>  }<br>}<br>const getSubscription = (registration) =&gt; {<br>  return registration<br>    .pushManager<br>    .getSubscription()<br>}<br>const saveSubscription = (subscription) =&gt; {<br>  // TODO: upload subscription data to server side<br>}<br>const subscribe = () =&gt; {<br>  // TODO: click event handler<br>}</pre><pre>init()</pre><p>NOTIFICATION_USABILITY 代表是否可以使用 Service Worker 以及 Push Manager ，若是這兩個其中一個不能使用，接下來的訂閱也無法實作了。</p><p>init 是初始化的 Function ，透過 NOTIFICATION_USABILITY 判斷使用者是否可以使用，若是無法使用，則需要禁用訂閱按鈕；或是已訂閱的使用者，也會將訂閱按鈕改成對應的狀態。</p><p>getSubscription 則是透過 Service Worker Registration 中的 Push Manager ，取得使用者目前的訂閱資訊，若是已訂閱則將最新版本的訂閱資訊，傳給 saveSubscription 同步到伺服器端。</p><h4>公、私金鑰</h4><p>前端訂閱 Push Service ，或是後端發送推播訊息，都需要一組公、私金鑰，可以透過<a href="https://web-push-codelab.glitch.me/">這個網站</a>來產生，或是自行產生 VAPID 金鑰。</p><blockquote><strong>貼心小提示：產生出的金鑰，請勿將私鑰放置在程式碼中；這次的程式碼為了展示方便，所以會這樣做，但在實務上請勿這樣做。</strong></blockquote><p><a href="https://github.com/jacky810124/pwa-day08/commit/d509b9c60344ca920b33da276fa6dd840e736de8">這階段所新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/d509b9c60344ca920b33da276fa6dd840e736de8">✨ Feat: initialization · jacky810124/pwa-day08@d509b9c</a></p><p>至此，初始化的步驟已經完成，接下來要開始處理：使用者點擊訂閱按鈕後的事件處理。</p><p>當使用者點擊訂閱按鈕後，會發生幾件事情：</p><ol><li>取得使用者訂閱資訊</li><li>同步訂閱資訊到伺服器端</li></ol><h4>取得使用者訂閱資訊</h4><p>當使用者點擊訂閱的按鈕後，先取得使用者的訂閱狀態，若使用者已經訂閱，則將訂閱狀態更新到伺服器端；倘若使用者尚未訂閱，則向使用者要求通知權限並且訂閱。</p><p>在向使用者要求權限時，應該要避免直接跳出權限要求，而是使用 confirm 或是跳出確認視窗，以免遭到使用者拒絕太多次後，被瀏覽器禁止向使用者要求權限。</p><blockquote><strong>貼心小提示：被瀏覽器禁止向使用者要求權限，可以參考這篇文章 </strong><a href="https://www.chromestatus.com/features/6443143280984064"><strong>Temporarily stop permission requests after 3 dismissals</strong></a></blockquote><p>在 subscribe 中處理使用者點擊訂閱按鈕後的訂閱流程。</p><pre>const subscribe = () =&gt; {<br>  let swRegistration</pre><pre>  const subscribeButton = document<br>    .querySelector(&#39;.user-profile__subscribe-button&#39;)</pre><pre>  navigator<br>    .serviceWorker<br>    .ready<br>    .then(registration =&gt; {<br>      swRegistration = registration</pre><pre>      return getSubscription(registration)<br>    })<br>    .then(subscription =&gt; {<br>      const isSubscribed = subscription !== null</pre><pre>      if (isSubscribed) {<br>        return subscription<br>      }</pre><pre>      return requestSubscription(swRegistration)<br>    })<br>    .then(subscription =&gt; saveSubscription(subscription))<br>    .then(response =&gt; {<br>      if (response.ok) {<br>        alert(&#39;已訂閱&#39;)</pre><pre>        subscribeButton.innerHTML = &#39;已訂閱&#39;<br>        subscribeButton.disabled = true<br>      } else {<br>        alert(response.message)<br>      }<br>    })<br>    .catch(error =&gt; {<br>      subscribeButton.disabled = false</pre><pre>      console.error(&#39;Failed to subscribe user &#39;, error)<br>    })<br>}</pre><p>Service Worker 啟用後，可以透過 ready 這個屬性來判斷；接著也是透過 Service Worker Registration 取得使用者的訂閱資訊，如果使用者已經訂閱，則直接將訂閱資訊往下傳；如果尚未訂閱，則透過 requestSubscription 來取得使用者的訂閱資訊；接著，透過 saveSubscription 將訂閱資訊同步到伺服器端。</p><p>在 requestSubscription 中的流程是長成這樣。</p><pre>const requestSubscription = (registration) =&gt; {<br>  const result = confirm(&#39;是否要訂閱 Jacky ？&#39;)</pre><pre>  if (result) {<br>    return registration<br>      .pushManager<br>      .subscribe({<br>        userVisibleOnly: true,<br>        applicationServerKey: urlB64ToUint8Array(PUBLIC_KEY)<br>      })<br>  }</pre><pre>  return Promise.reject(new Error(&#39;Failed to request push notification permission&#39;))<br>}</pre><p>值得注意的有幾個部分：</p><ol><li>避免直接跟使用者要求權限</li><li>subscribe 的參數設定</li></ol><p>向使用者要求權限時，如果被使用者拒絕太多次，瀏覽器會禁止向使用者要求權限一段時間，為了避免這種情況發生，實務中應該先向使用者詢問和告知權限的用途。</p><p>在訂閱時會將 userVisibleOnly 設成 true ，這是強制收到的推播訊息，都需要顯示出來，避免開發者在背後做些噁心的事情，詳細內容可以參考<a href="https://developers.google.com/web/fundamentals/push-notifications/subscribing-a-user#uservisibleonly_options">這篇文章</a>； applicationServerKey 則是需要將公鑰轉成 UInt8Array 的格式，這個可以直接使用 utils.js 中的 urlB64ToUint8Array 的 Function 。</p><p><a href="https://github.com/jacky810124/pwa-day08/commit/ca32fc62556485f210ea22f57c577b55b239fdde">這階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/ca32fc62556485f210ea22f57c577b55b239fdde">✨ Feat: get subscription data · jacky810124/pwa-day08@ca32fc6</a></p><h4>同步訂閱資訊到伺服器端</h4><p>取得訂閱資訊後，還需要將訂閱資訊儲存在伺服器端上，如此一來伺服器要發送推播訊息時，才知道要將推播訊息發送給誰。</p><p>儲存訂閱資訊時，因為每筆訂閱資訊，都需要有個唯一值來辨識是哪個人訂閱的，在這次演示中，使用 Fingerprint2 來創建這個唯一值，只需要在 index.html 中加入以下這段。</p><pre>&lt;script src=&quot;<a href="https://cdnjs.cloudflare.com/ajax/libs/fingerprintjs2/1.8.1/fingerprint2.min.js">https://cdnjs.cloudflare.com/ajax/libs/fingerprintjs2/1.8.1/fingerprint2.min.js</a>&quot;&gt;&lt;/script&gt;<br>&lt;script src=&quot;utils.js&quot;&gt;&lt;/script&gt;<br>&lt;script src=&quot;app.js&quot;&gt;&lt;/script&gt;</pre><p>以及在 init 中修改一下即可完成； HAS_FINGERPRINT 則是用來判斷是否已經創建出唯一值； generateFingerprint 這個是已經寫好在 utils.js 裡。</p><pre>const HAS_FINGERPRINT = !(localStorage.getItem(&#39;fingerprint&#39;) == null &amp;&amp; localStorage.getItem(&#39;fingerprint&#39;) === &#39;&#39;)<br>const init = () =&gt; {<br>  const subscribeButton = document<br>    .querySelector(&#39;.user-profile__subscribe-button&#39;)</pre><pre>  if (HAS_FINGERPRINT) {<br>    generateFingerprint()<br>      .then(fingerprint =&gt; {<br>        localStorage.setItem(&#39;fingerprint&#39;, fingerprint)<br>      })<br>  }</pre><pre>  if (!NOTIFICATION_USABILITY) {...}<br>}</pre><p>在 saveSubscription 中只需要透過 AJAX ，將訂閱資訊傳送給伺服器端即可，但是因為目前伺服器端尚未建立，因此還無法知道 API 網址是什麼，因此 API_HOST 先暫時為空字串。</p><pre>const API_HOST = &#39;&#39;<br>const saveSubscription = (subscription) =&gt; {<br>  const options = {<br>    method: &#39;PUT&#39;,<br>    body: JSON.stringify({<br>      fingerprint: localStorage.getItem(&#39;fingerprint&#39;),<br>      subscription<br>    }),<br>    headers: new Headers({<br>      &#39;Content-Type&#39;: &#39;Application/json&#39;<br>    })<br>  }</pre><pre>return fetch(`${API_HOST}/subscriptions`, options)<br>    .then(response =&gt; response.json())<br>}</pre><p><a href="https://github.com/jacky810124/pwa-day08/commit/9f9385b9273ec7554845de13ec4815b15dced8bb">此階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/9f9385b9273ec7554845de13ec4815b15dced8bb">✨ Feat: sync subscription data to server side · jacky810124/pwa-day08@9f9385b</a></p><h3>後端—儲存訂閱資訊</h3><p>在前端基本的訂閱流程都完成後，接下來開始進行後端的部分。</p><p>後端會使用 Firebase Functions 和 Firebase Realtime Database ，因此必須要先到 <a href="https://console.firebase.google.com/u/0/">Firebase Console</a> 上申請帳號；申請完成之後新增專案，專案名稱和國家的區塊就根據個人需求填寫。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JMyMhd7bnnVg2L2yBT3fnw.png" /></figure><p>這次會用到的兩個服務， Functions 是拿來放置後端的程式碼； Realtime Database 則是存放訂閱資料的地方；接著就開始初始化後端的環境吧。</p><h4>初始化後端環境</h4><p>首先，需要安裝 firebase-tools 來初始化後端的環境。</p><pre>npm install -g firebase-tools</pre><p>安裝完成之後，就可以使用 firebase login 登入 Firebase ；登入之後，可以在專案的根目錄，執行 firebase init functions 即可初始化 Firebase Functions 的環境。</p><p>完成後，會在專案的根目錄下，多出 functions 的資料夾，這個資料夾會拿來擺放後端的程式碼；在開發前，必須先切換到 functions 這個資料夾下，執行 npm install 來安裝相依套件；或是在初始化 Firebase Functions 環境時，會詢問是否要安裝相依套件，選擇“是”即可自動將相依套件安裝好。</p><p>順帶一提，在 Firebase Functions 初始化完成後，會建立幾個指令在 package.json 中；比較常用到的有： npm run serve 主要是用在本機開發；而 npm run deploy 則是用在部署到 Firebase 上。</p><p><a href="https://github.com/jacky810124/pwa-day08/commit/525d57e8f35ffb02b974f2c1f5d3c15c6bd51f3b">此階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/525d57e8f35ffb02b974f2c1f5d3c15c6bd51f3b">✨ Feat: server side initialization. · jacky810124/pwa-day08@525d57e</a></p><p>因為後端是使用 Express （ NodeJS 的框架）來開發，加上前後端可能會在不同的網域下，會有跨域的問題；另外還需要 Firebase Realtime Database ，因此必須要先安裝幾個相依套件。</p><pre>npm install express firebase-admin cors</pre><p>安裝完成後，前置作業大致上算處理完畢，接著就可以開始進行開發。</p><p><a href="https://github.com/jacky810124/pwa-day08/commit/e16f4bd37f671bd31a69328309ccb8864b1846db">此階段新增或刪除的程式碼，可參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/e16f4bd37f671bd31a69328309ccb8864b1846db">✨ Feat: install some packages · jacky810124/pwa-day08@e16f4bd</a></p><p>在 functions 這個資料夾中， index.js 這個檔案就是後端程式碼的進入點；首先，在 index.js 中引入會用到的相依套件，預設已經引入 Firebase Functions 的套件了，因此只需要再引入 firebase-admin 、 express 、 cors 這幾個套件，並將其初始化與套用。</p><pre>const functions = require(&#39;firebase-functions&#39;)<br>const admin = require(&#39;firebase-admin&#39;)<br>const express = require(&#39;express&#39;)<br>const cors = require(&#39;cors&#39;)</pre><pre>admin.initializeApp({<br>  databaseURL: &#39;<a href="https://pwa-day08.firebaseio.com/&#39;">https://pwa-day08.firebaseio.com/&#39;</a><br>})</pre><pre>const db = admin.database()<br>const app = express()</pre><pre>app.use(cors())</pre><pre>exports[&#39;api&#39;] = functions.https.onRequest(app)</pre><p>由於訂閱資訊是儲存在 Firebase Realtime Database 上，因此在這邊也先將資料庫初始化； databaseURL 則是代表 Firebase Realtime Database 上的網址，可以在 Firebase Console 上找到。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rHrcQIU5jMyZubnekHsa6w.png" /></figure><p>Firebase Functions 部署的後端程式碼，必須要匯出之後才能夠使用，因此這邊將 app 匯出，並且將前綴設為 api ，之後在 index.js 中開發的 API ，都會以 /api 作為前綴，以下是 API 範例。</p><pre>POST   https://YOUR_API_HOST/api/messages<br>PUT    https://YOUR_API_HOST/api/subscriptions<br>DELETE https://YOUR_API_HOST/api/subscriptions</pre><p><a href="https://github.com/jacky810124/pwa-day08/commit/d372389f52b5270383f276c9a034cccc426682d7">此階段新增或刪除的程式碼，可參考以下網址。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/d372389f52b5270383f276c9a034cccc426682d7">✨ Feat: initialize package · jacky810124/pwa-day08@d372389</a></p><p>同步訂閱資訊這邊的邏輯也蠻單純，基本上就是從 Request Body 將訂閱資訊以及 Fingerprint 取出；將 Fingerprint 當成是 ID ，再將訂閱資訊儲存在 Firebase Realtime Database 上。</p><p>值得注意的是，這個同步訂閱資訊的 API ，會設定成這樣。</p><pre>PUT /subscriptions</pre><p>不論使用者是否已經訂閱，伺服器端都會再次同步訂閱資料；因此在創建或是覆蓋資料時，會使用 PUT 這個 HTTP Method ，而 /subscriptions 則是代表訂閱資料的資源節點。</p><p>因此訂閱的 API 就會長得像這樣。</p><pre>app.put(&#39;/subscriptions&#39;, (req, res) =&gt; {<br>  const ref = db.ref(`/subscriptions/${req.body.fingerprint}`)<br>  const callback = error =&gt; {<br>    if (error) {<br>      res.json({<br>        ok: false,<br>        message: &#39;更新訂閱資訊失敗&#39;<br>      })<br>    } else {<br>      res.json({<br>        ok: true<br>      })<br>    }<br>  }</pre><pre>  ref.set({ subscription: req.body.subscription }, callback)<br>})</pre><p>不論是成功或是失敗，回傳的 JSON 中都會有 ok 這個 Key ，但是從 true 或 false 可以分辨出是否執行成功。</p><p>在程式碼都完成後，可以透過 npm run serve 將 API 部署在本機，接著就可以測試 API 是否如預期中執行。</p><blockquote><strong>貼心小提示：測試 API 可以使用 </strong><a href="https://www.getpostman.com/"><strong>Postman</strong></a><strong> 或是 </strong><a href="https://paw.cloud/"><strong>Paw</strong></a><strong> 等測試工具。</strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_lTZfyKHIHll37Mwqg-Wyg.png" /></figure><p>紅框處代表的是本機後端 API 的網址，此時就可以將這串網址，貼到 app.js 的 API_HOST 中測試看看。</p><pre>const API_HOST = &#39;http://localhost:5000/pwa-day08/us-central1/api&#39;</pre><p>測試成功後，記得要把後端的程式碼，透過 npm run deploy 部署到 Firebase Functions 上，部署完成之後，一樣也會有一串 API 的網址，但是此時這串的的網域就不會在 localhost 了，而是在 Firebase Functions 上。</p><blockquote><strong>特別注意：部署完成之後，記得將 </strong><strong>index.html 的 </strong><strong>API_HOST 改成 Firebase Functions 上的網址；本機的僅供測試使用。</strong></blockquote><p>如果在終端機看不到 API 的網址，也可以到 Firebase Console 打開專案中的 Functions 來查看。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*P_ZgEs1UfaJ-URy2W1_rOw.png" /></figure><p>實際按下訂閱的按鈕，並且有訂閱成功後，就可在 Firebase Realtime Database 上看到訂閱的資料了。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jUhdDX4KNlSGmWG1l4-mLA.png" /></figure><p><a href="https://github.com/jacky810124/pwa-day08/commit/062c298b565b2ee873d8520c49c15f2ecc9e41ac">此階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/062c298b565b2ee873d8520c49c15f2ecc9e41ac">✨ Feat: save subscription data on firebase realtime database · jacky810124/pwa-day08@062c298</a></p><h3>後端—發送推播訊息</h3><p>推播訊息會使用 <a href="https://github.com/web-push-libs/web-push">web-push</a> 來發送，因此需要先安裝相依套件。</p><pre>npm install web-push</pre><p>使用 <a href="https://github.com/web-push-libs/web-push">web-push</a> 發送推播訊息也非常容易，只需要將訂閱資訊，以及推播的訊息內容帶入，即可發送推播訊息給使用者，大致上會長得像下面這樣。</p><pre>const webpush = require(&#39;web-push&#39;)</pre><pre>webpush.setVapidDetails(<br>  &#39;mailto:YOUR_EMAIL&#39;,<br>  &#39;YOUR_PUBLICK_KEY&#39;,<br>  &#39;YOUR_PRIVATE_KEY&#39;<br>)</pre><pre>const subscription = {<br>  endpoint: &#39;.....&#39;,<br>  keys: {<br>    auth: &#39;.....&#39;,<br>    p256dh: &#39;.....&#39;<br>  }<br>}</pre><pre>webpush<br>  .sendNotification(subscription, &#39;Your Push Payload Text&#39;)<br>  .then((result) =&gt; {...})<br>  .catch((error) =&gt; {...})</pre><p>接著，來創建發送推播訊息的 API， 供使用者發送推播訊息給追蹤者；這個 API 會長得像這樣，以及 Request Body 的格式會是 JSON ，而可接受的欄位會有 title 、 content 。</p><pre>POST /messages</pre><pre># Request Body</pre><pre>{ &quot;title&quot;: &quot;...&quot;, &quot;content&quot;: &quot;&quot;}</pre><p>程式碼則是會長得像這樣。</p><pre>const webpush = require(&#39;web-push&#39;)</pre><pre>webpush.setVapidDetails(<br>  &#39;mailto:kang810124@gmail.com&#39;,<br>  &#39;BCDMOxYAhVUZY1cXwkXsKuKztlqfOXjowcriucykb5qBmFq-8lVMVx3bJbFOmLSci1Jq_SPqBdFeWGi0jcHJfXM&#39;,<br>  &#39;1jwNoayXn3XGHqYPib37COkGXpu91FyFxJMfHGcAzJk&#39;<br>)</pre><pre>app.post(&#39;/messages&#39;, (req, res) =&gt; {<br>  const ref = db.ref(`/subscriptions`)<br>  const callback = (snapshot) =&gt; {<br>    const subscriptions = snapshot.val()<br>    const tasks = Object<br>      .keys(subscriptions)<br>      .map(key =&gt; {<br>        const subscription = subscriptions[key].subscription<br>        return webpush.sendNotification(<br>          subscription,<br>          JSON.stringify(req.body)<br>        )<br>      })<br>    <br>    Promise<br>      .all(tasks)<br>      .then(result =&gt; {<br>        res.json({<br>          ok: true<br>        })<br>      })<br>      .catch(error =&gt; {<br>        res.json({<br>          ok: false<br>        })<br>      })<br>  }<br>  <br>  ref.once(&#39;value&#39;, callback)<br>})</pre><p>首先，先將 web-push 初始化，將先前取得的公、私鑰，帶入 setVapidDetails 初始化 web-push 。</p><p>將儲存在 Firebase Realtime Database 上的訂閱資料，透過 ref.once 取出後，把 Request Body 中的推播訊息，透過 webpush.sendNotification 傳給訂閱者，這邊需要注意一下，訊息必須為 String 或是 Buffer ，因此在這邊會使用 JSON.stringify 將 Request Body 中的推播訊息，轉成字串來送。</p><p>接下來，只剩下前端將接收到的推播訊息顯示出來。</p><p><a href="https://github.com/jacky810124/pwa-day08/commit/118450ea5d77be8567eec6cf741a2e68fee943da">此階段新增或刪除的程式碼，可參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/118450ea5d77be8567eec6cf741a2e68fee943da">✨ Feat: create send push messages api · jacky810124/pwa-day08@118450e</a></p><h3>前端—顯示推播訊息</h3><p>在前端的世界，只要使用者將瀏覽器關閉了，整個網站就結束了；但是有了 Service Worker 後，就可以在背景執行，即便使用者關閉網站，還是可以在背景處理事情。</p><p>這次介紹的顯示推播訊息，即是使用 Service Worker 來實現，透過 Service Worker 在背景監聽 push 事件（也就是來自後端的推播訊息），收到事件後即可透過 Service Worker Registration 將訊息顯示出來。</p><p>由於顯示推播訊息這塊，是直接在 Service Worker 去操作，因此接下來的程式碼，會存在 Service Worker 中。</p><p>在 Service Worker 中需要監聽 push 事件。</p><pre>self.addEventListener(&#39;push&#39;, event =&gt; {...})</pre><p>這邊的 self 在 Service Worker 中，則是代表 Service Worker 自己，這算在 JavaScript Worker 中比較特殊的用法。</p><p>而具體在 sw.js 的程式碼會長得像這樣。</p><pre>self.addEventListener(&#39;push&#39;, event =&gt; {<br>  const message = JSON.parse(event.data.text())<br>  const title = message.title<br>  const options = {<br>    body: message.content<br>  }</pre><pre>  event.waitUntil(<br>    self.registration.showNotification(title, options)<br>  )<br>})</pre><p>透過 event.data.text() 即可舉得推播的訊息內容，在上個章節 <strong>後端—發送推播訊息</strong> 中，已經知道後端送過來的推播訊息格式，會是將 Object 轉成 JSON （也就是字串），因此需要經過 JSON.parse 將取得的字串重新轉為 Object 。</p><pre>&#39;{ &quot;title&quot;: &quot;&quot;, &quot;content&quot;: &quot;&quot;}&#39;</pre><p>接下來就可以透過 Service Worker Registration 的 showNotification 將推播訊息內容顯示出來。</p><blockquote><strong>貼心小提示：在 Service Worker 中程式碼有變動時，不會即時的替換上去，而是會等到該網站全部的分頁都關閉後，才會替換上去；如果不想等待那麼久，可以透過 Devtool 中的 skip waiting 即時更換。</strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zTOkxwDGlCVRrp9FH5-pyg.png" /><figcaption>Devtool — Skip Waiting</figcaption></figure><p>接著，使用 PAW 來測試 API ，送出的內容如下圖，同時也要確保前端的 Service Worker 是在最新的版本；只要發出 Request 後，前端能夠正確顯示推播訊息，這樣就大功告成啦。</p><p>接著就只剩下將後端程式碼，部署到 Firebase Functions 上。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0n84Z4sJIovsvAx8JeDepg.png" /><figcaption>Finish</figcaption></figure><p><a href="https://github.com/jacky810124/pwa-day08/commit/240a73bffbe9cd0793174f2306fc9d67a5f3d075">此階段新增或刪除的程式碼，可以參考以下連結。</a></p><p><a href="https://github.com/jacky810124/pwa-day08/commit/240a73bffbe9cd0793174f2306fc9d67a5f3d075">✨ Feat: show notification · jacky810124/pwa-day08@240a73b</a></p><h3>後記</h3><p>這篇文章真的是拖了世界久，主要是因為有點不知該如何下手，同時也藉著這次的文章，將 PWA 推播的流程重新順了一次；這次也算是第一次寫這麼長的教學文章，應該也有蠻多地方不太清楚，或是寫得不好的，也歡迎大家多給些建議，看看下次應該要如何改進才好；或是你覺得寫得不錯，也歡迎多給些鼓勵，地方的開發者，需要你的鼓勵 😝 。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=42699becd105" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[禁止 Safari 中 Double Tap 的縮小和放大]]></title>
            <link>https://medium.com/@jacky810124/%E7%A6%81%E6%AD%A2-safari-%E4%B8%AD-double-tap-%E7%9A%84%E7%B8%AE%E5%B0%8F%E5%92%8C%E6%94%BE%E5%A4%A7-661802fa27cb?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/661802fa27cb</guid>
            <category><![CDATA[safari]]></category>
            <category><![CDATA[double-tap]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Sun, 22 Apr 2018 14:46:35 GMT</pubDate>
            <atom:updated>2018-04-22T14:46:35.876Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*68m1pog1jhqOUpqgj2hhTw.png" /><figcaption>封面照</figcaption></figure><p>在很多情況下，為了確保版面不會因為使用者縮小或放大而導致跑版，這時都會使用 user-scalable=no ，來確保使用者無法縮小或放大畫面，但是這個方法，可能沒辦法在所有瀏覽器上都支援了。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/eca33a6b72f430b93343bbe779c1c810/href">https://medium.com/media/eca33a6b72f430b93343bbe779c1c810/href</a></iframe><h3>問題點</h3><p>平常都是使用 Chrome 作為主要開發瀏覽器，因此一直沒注意到這個問題，直到使用者回報：使用 Safari 瀏覽時，雙擊螢幕時可以放大或縮小畫面，這才注意到，原來 Safari 已經忽略 user-scalable=no 這個屬性。</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fb7NztdfhaMM%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Db7NztdfhaMM&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fb7NztdfhaMM%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="640" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/6a7e0b08f5745253c46c049e1355c411/href">https://medium.com/media/6a7e0b08f5745253c46c049e1355c411/href</a></iframe><h3>解決方式</h3><p>以上面的例子來說，可以在 CSS 裡面加上 touch-action: manipulation; ，讓元素只能使用滑動或兩指縮放，並且禁止所有非標準的手勢，像是雙擊縮放，同時也可以避免瀏覽器發生點擊事件的 300ms 延遲。</p><p>不過這只能解決其中一部份，當按鈕加上 disabled 的屬性，而且按鈕也是在禁止使用的狀態時，雙擊禁止使用的按鈕還是會觸發放大或縮小畫面，但這個部分就沒找到比較好的解法了。</p><p>既然解決不了問題，那只好解決發生問題的人！</p><p>所以就把按鈕的 disabled 屬性移除掉了……，取而代之的是用 JavaScript 來管理狀態，當按鈕應該要是禁止使用時，套用禁止使用的樣式，並且把 Click Event 忽略掉。</p><p>程式碼大概是長這樣：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2a159714a6597f1d81d03862359ee00e/href">https://medium.com/media/2a159714a6597f1d81d03862359ee00e/href</a></iframe><h3>後記</h3><p>應該會有更好的解決方式，如果有的話再麻煩大家告訴我了。</p><p>這篇文章除了想要記錄這個情況該如何解決，另外還想討論 user-scalable=no 這個屬性被忽略的意義。</p><p>在 Safari 的發佈內容裡面有提到：</p><blockquote>To improve accessibility on websites in Safari, users can now pinch-to-zoom even when a website sets user-scalable=no in the viewport.</blockquote><p>簡單來說呢，就是為了要提升使用者的可用性，因此在 Safari 上會自動忽略 user-scalable=no 的屬性。</p><p>對使用者來說這個應該算是好事一件， user-scalable=no 沒辦法限制使用者縮小或放大畫面，使用者可以自行調整到合適的大小瀏覽內容。尤其在沒做 RWD 的網站，或是為了整體設計，而將字體設定在不適合閱讀的字體大小，這些網站對於使用者在瀏覽時，都是非常痛苦的體驗。</p><p>因此將縮放比例固定住，這件事情本身就值得討論，因為每個人覺得舒服的字體大小都不同，因此使用者勢必要自己調整至舒服的字體大小，才能夠在網站上瀏覽得久。</p><p>Safari 忽略 user-scalable=no 這個屬性，也算是替使用者做了件好事吧！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=661802fa27cb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day07 — 好好用的推播訊息 Part 1 — 簡介]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day07-%E5%A5%BD%E5%A5%BD%E7%94%A8%E7%9A%84%E6%8E%A8%E6%92%AD%E8%A8%8A%E6%81%AF-part-1-%E7%B0%A1%E4%BB%8B-59d4cdb69a25?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/59d4cdb69a25</guid>
            <category><![CDATA[pwa]]></category>
            <category><![CDATA[service-worker]]></category>
            <category><![CDATA[push-notification]]></category>
            <category><![CDATA[web-push-notifications]]></category>
            <category><![CDATA[progressive-web-app]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Sat, 31 Mar 2018 18:55:47 GMT</pubDate>
            <atom:updated>2018-03-31T18:55:47.886Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>在先前的章節中，介紹了許多讓 PWA 看起來與用起來和一般的 Web App 不太一樣的地方，接下來要介紹在之前，只有 Native App 才有的原生功能， Web App 如果也要的話，往往需要第三方服務的支援才能達成，這個功能就是：<strong>推播訊息</strong>。</p><p>因為推播有通知使用者的功用，因此當訂單狀態改變，或是有新的訊息時，可以即時的通知使用者，不需讓使用者時不時就進入應用程式查詢，讓應用程式用起來更加好用。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/540/1*jNCtmDmwccrsMjuOocVTHg.png" /><figcaption>實際成果</figcaption></figure><blockquote>謎之聲：在進入此章節前，對於 Service Worker 需要有一定的認識，同時因為推播訊息會需要用到後端，所以也必須具備一些 NodeJS 的知識（後端是使用 NodeJS ，不過這部分並不是一定要使用 NodeJS）</blockquote><h3>流程介紹</h3><p>在介紹整個推播流程前，需要先介紹一下這個流程裡面的角色。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G6gXMWEaeysd_HVCkzm5GQ.png" /><figcaption>角色介紹</figcaption></figure><h4>Push Service</h4><p>在整個推播流程中，有個問題需要解決：該如何知道訊息要送到哪個裝置？只要解決了這個問題後，產生推播訊息或是顯示通知，這些都不是太困難的問題。</p><p>為了解決這個問題，各家瀏覽器分別實作了一個服務，叫做： Push Service ，由於是各個瀏覽器分別實作，所以各個瀏覽器可能會有點不太一樣。在整個推播流程中， Push Service 主要的功能在於：把推播訊息送到正確的裝置上，以及讓 Browser 可以訂閱 Push Service ，用來接收推播訊息。</p><h4>Browser</h4><p>而 Browser 中的 Service Worker ，則是負責在背景接收來自 Push Service 的推播訊息，為什麼會選擇在 Service Worker 中接收呢？為什麼不是在頁面上？</p><p>這是因為推播訊息，在使用者未開啟應用程式時，也要能接收到推播訊息，因此必須透過 Service Worker ，可以在背景執行的特性，讓使用者即便未開啟應用程式，也能收到訊息。</p><p>另外， Browser 也負責通知該如何呈現，像是：標題、內容、圖標、震動……等。</p><h4>Server</h4><p>主要負責產生推播的訊息，但這個不見得是使用者，所看到的推播訊息，有可能只是讓 Browser 可以識別的內容，產生通知的部分還是由 Browser 來負責。</p><p>另外， Server 也必須要儲存 Browser 訂閱 Push Service 的訂閱資訊，與加密推播訊息內容。</p><h4>流程介紹</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Lz2sP3a3YR8iQSdchyxqMQ.png" /><figcaption>取得 Notification 權限</figcaption></figure><p>首先，必須要先確保使用者已經同意顯示通知，如果使用者不允許顯示通知，即便後續的流程完成，也沒辦法正確的顯示通知，因此必須要先確認使用者的通知權限。</p><p>如果使用者的權限是 <strong>granted </strong>或是<strong> denied </strong>都無法再次要求權限。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*A1jAdNKg_XeR_d-_3xCxwQ.png" /><figcaption>訂閱 Push Service</figcaption></figure><p>確認完使用者的權限後，就可以繼續接下來的流程。想要接收到推播訊息，就必須要訂閱 Push Service ，為什麼呢？前面有提過 Push Service 主要的功能在於：將推播訊息傳送到正確的裝置上。</p><p>Push Service 能夠傳遞推播訊息給正確的裝置，是因為透過 Browser 訂閱 Push Service 時， Push Service 能夠產生一組獨特，且屬於該裝置的 endpoint URL ， Push Service 會自動將裝置和該 endpoint URL 對應起來，因此只要有推播訊息傳送到該 endpoint URL ， Push Service 自然能夠將推播訊息傳給正確的裝置。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5FChqQnRPxdwCVRk3-kaQg.png" /><figcaption>儲存訂閱資訊在 Server 端</figcaption></figure><p>Browser 拿到了裝置的訂閱資訊之後，需要將訂閱的資訊傳送給 Server 端，儲存在 Server 的 DataBase 中，這樣 Server 才能透過這些訂閱資訊，傳送推播訊息給使用者。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sYaX5kXwDTA6-Rj-Di67ow.png" /><figcaption>傳送訂閱資訊與推播訊息給 Push Service</figcaption></figure><p>在某個時機點，可能是使用者做了某些操作，或是來自其他服務的觸發， Server 需要傳送推播訊息給使用者。此時會先在 Server 組出推播訊息，組完之後把訊息和訂閱資訊傳送給 Push Service。</p><p>看到這邊應該有人覺得奇怪，為什麼不直接將推播訊息傳送給使用者呢？</p><p>這是因為： Server 本身是沒辦法直接對裝置端傳送東西，除非裝置端有向 Server 發出請求，因此這邊要先將推播訊息與訂閱資訊，傳送給 Push Service ，透過 Push Service 幫忙轉送推播訊息。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mGCvE3IIkAs5ti-hG9CcSw.png" /><figcaption>傳送推播訊息給 Service Worker</figcaption></figure><p>Push Service 在接收到推播訊息後，會根據 Server 所傳送的訂閱資訊，把推播訊息傳送給對應裝置上的 Service Worker 。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XK1z-Js5Sb89nBs224mAhw.png" /><figcaption>顯示通知</figcaption></figure><p>Service Worker 在接收到推播訊息後，即可根據訊息內容，決定通知的內容和一些樣式設定，設定完成後 Service Worker 透過呼叫顯示通知的方法，使用者即可在裝置上收到推播訊息了。</p><h3>總結</h3><p>整個推播的流程可以簡單整理為以下的步驟：</p><ol><li>必須要先取得使用者通知的權限。</li><li>訂閱 Push Service 。</li><li>儲存 Browser 訂閱資訊。</li><li>Server 被觸發時，將推播訊息與訂閱資訊傳送給 Push Service 。</li><li>Push Service 根據訂閱資訊，傳送推播訊息給對應的裝置。</li><li>Service Worker 顯示通知。</li></ol><p>也把上面的步驟，整理成 GIF 檔讓大家比較好對照。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tXFEGI4gVCPtTxAE_IyQ6A.gif" /><figcaption>推播流程 GIF 檔</figcaption></figure><h3>後記</h3><p>這次先將 PWA 的推播流程介紹一遍，接下來將會進入到動手做系列，因此如果對整個流程還不熟的朋友，記得先把本篇文章看個 10 遍啊！</p><p>如果有任何錯誤，或是寫得不夠詳細的地方，都歡迎在底下留言告訴我。</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=59d4cdb69a25" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day06 — 好的快取讓使用者上天堂 Part 3 — 總結]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day06-%E5%A5%BD%E7%9A%84%E5%BF%AB%E5%8F%96%E8%AE%93%E4%BD%BF%E7%94%A8%E8%80%85%E4%B8%8A%E5%A4%A9%E5%A0%82-part-3-%E7%B8%BD%E7%B5%90-28508f1b48ee?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/28508f1b48ee</guid>
            <category><![CDATA[cache-storage]]></category>
            <category><![CDATA[progressive-web-app]]></category>
            <category><![CDATA[pwa]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Thu, 29 Mar 2018 08:26:02 GMT</pubDate>
            <atom:updated>2018-03-29T08:26:02.963Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>前幾篇文章中已經把基本的快取概念跑過一輪，此篇文章將會做個總結，同時也做個比較深入的介紹。在 Service Worker 可以透過 Cache Interface 來操控 Cache Storage ，同時 window 也能使用相同的 Cache Interface 來操控，因此不見得要在 Service Worker 才能執行 Cache Storage 相關的操作。</p><h3>儲存頁面上的資源</h3><p>此章節將介紹幾種常見快取資源的範例</p><h4>快取 App Shell</h4><p>在 Service Worker 的 install 事件中，非常適合拿來快取 App Shell 。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7ef568f620bb4798a52b16fd5b438677/href">https://medium.com/media/7ef568f620bb4798a52b16fd5b438677/href</a></iframe><p>可以看到 event.waitUntil 這是為了避免 Service Worker 在快取還沒完成前，就進入了 terminated 的狀態，因此 Service Worker 會一直等到快取完成後，才會結束 install 的事件。不過當快取失敗時， Service Worker 就不會安裝成功，會繼續使用上個版本的 Service Worker 。</p><h4>使用者的操作</h4><p>如果無法讓整個網頁離線操作，也可以讓使用者選擇想快取的內容，有點類似「稍後觀看」的功能。這部分的快取就不是在 Service Worker 裡面發生。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d97f6334e4e3bb0c6c36673b3269213d/href">https://medium.com/media/d97f6334e4e3bb0c6c36673b3269213d/href</a></iframe><p>上面的範例是當使用者點了帶有 .cache-article 的元素時，會開啟 mysite-article-{id} 的 Cache Object ，接著取得文章的列表並透過 cache.addAll 將陣列裡面的網址全部快取。</p><p>簡易的流程大概如下圖：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jo0_ay-0k7Rg3ypTi5RZSw.png" /><figcaption>使用者的操作快取流程</figcaption></figure><h4>網路的 Response</h4><p>當 Request 在 Cache Storage 中沒有符合的 Request 時，會透過網路跟遠端的 Server 拿，拿到之後傳送給頁面並放進 Cache Storage 中。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e98412c9be94de169cc950021d20a4f3/href">https://medium.com/media/e98412c9be94de169cc950021d20a4f3/href</a></iframe><p>這個範例可以動態的將某個資源或內容存在 Cache Storage ，很適合拿來存放一些不太重要的內容。但是必須注意 Cache Storage 的容量，身為開發者，你有責任把這個管理好，不然當使用者需要清理空間時，你不會想要當頭號候選人吧？</p><h3>從 Cache Storage 提供檔案</h3><p>從 Cache Storage 提供檔案，或是讓網站可以離線操作，必須要攔截網站中的 Request ，並從 Cache Storage 中提供檔案，這邊有幾種常見的方式：</p><ul><li>從 Cache Storage 提供</li><li>從網路提供</li><li>從 Cache Storage 提供，失敗後由網路提供</li><li>從網路提供，失敗後由 Cache Storage 提供</li><li>從 Cache Storage 提供，並透過網路更新</li></ul><h4>從 Cache Storage 提供</h4><p>這個方式並不常見，但這個方式很適合用來提供頁面中所需要的靜態檔案。必須在 Service Worker 的 install 事件中，將頁面所需要的靜態檔案都加進 Cache Storage 中。如果在 Cache Storage 無法找到對應的 Request ， Response 將會看起來像是連線有問題。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/52518c90dddd8221890b33f929e1931c/href">https://medium.com/media/52518c90dddd8221890b33f929e1931c/href</a></iframe><h4>從網路提供</h4><p>這個方式並不常見，當內容必須要在有連線情況下才能使用時，才會使用這個方式，或是 non-Get 的 Request 。</p><p>另外，也可以選擇不要呼叫 event.respondWith ，結果將會是瀏覽器的預設行為。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/cbd137b45b5a38032e7c380487b959e1/href">https://medium.com/media/cbd137b45b5a38032e7c380487b959e1/href</a></iframe><h4>從 Cache Storage 提供，失敗後由網路提供</h4><p>這個方式結合了「從 Cache Storage 提供」和「從網路提供」，當 Cache Storage 中有對應的 Request ，則透過「從網路提供」所提供；反之，則透過「從網路提供」所提供。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/16b8ac3305c94b241222bff38294b6db/href">https://medium.com/media/16b8ac3305c94b241222bff38294b6db/href</a></iframe><h4>從網路提供，失敗後由 Cache Storage 提供</h4><p>當內容很常更新時，這是非常好的方式。使用此方式，代表有網路連線的使用者，可以獲得最新的內容，而沒網路連線的使用者，會獲得較舊版本的內容。</p><p>但是，這個方式有個缺點，如果使用者的網路速度很慢，或是網路斷斷續續時，會等到從網路讀取失敗時，才從 Cache Storage 提供舊版本的內容，這個可能會造成使用者體驗不佳。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a324d54a21fdd2177736480c8476a806/href">https://medium.com/media/a324d54a21fdd2177736480c8476a806/href</a></iframe><h4>從 Cache Storage 提供，並透過網路更新</h4><p>當內容很常更新時，這個也是很棒的方式。可以從 Cache Storage 快速的提供內容，也因為同時向遠端 Server 讀取最新的內容，所以可以確保使用者看到的是最新版內容。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/70412b0c3930908b9f15644c952876e5/href">https://medium.com/media/70412b0c3930908b9f15644c952876e5/href</a></iframe><p>一般來說， 內容來自 Cache Storage 會比遠端 Server 回來得更快，如果遠端 Server 的內容還沒回來時，先以 Cache Storage 的內容更新頁面，等到遠端 Server 的內容回來後，再次更新頁面，確保可以獲得最新的內容。</p><p>另外，在 Service Worker 所接收到的 fetch 事件中，可以從遠端 Server 所拿回的資料，更新到 Cache Storage 。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b8dee2032e696141ff45415a43538dd9/href">https://medium.com/media/b8dee2032e696141ff45415a43538dd9/href</a></iframe><h4>通用的失敗處理</h4><p>如果透過 Cache Storage 或網路都無法提供內容時，可能會需要提供個失敗的處理。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a1857630895b466b1f25b8f4147bca55/href">https://medium.com/media/a1857630895b466b1f25b8f4147bca55/href</a></iframe><p>或是根據網路錯誤的不同，提供不同的失敗處理。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/90f4ff7a8a9b404d649b90aae4d7cea4/href">https://medium.com/media/90f4ff7a8a9b404d649b90aae4d7cea4/href</a></iframe><blockquote>謎之聲：網路的錯誤在 fetch 裡不會拋出 Error ，因此不會進入到 catch ，這個需要特別注意。</blockquote><blockquote>以下節錄自 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch">MDN — Using Fetch</a></blockquote><blockquote>The Promise returned from fetch() won’t reject on HTTP error status even if the response is an HTTP 404 or 500. Instead, it will resolve normally (with ok status set to false), and it will only reject on network failure or if anything prevented the request from completing.</blockquote><h3>移除舊版本的快取</h3><p>在 Service Worker 安裝完成之後，舊版本的 Service Worker 就不會再使用了，因此在 Service Worker 的 activate 的事件中，相當適合拿來處理舊版本的快取。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fd926d00ae155ff4a2e10dd1539d1b3c/href">https://medium.com/media/fd926d00ae155ff4a2e10dd1539d1b3c/href</a></iframe><p>在 Service Worker 啟用時，其他的事件（像是： fetch ）會被放在 queue 中，如果啟用 Service Worker 佔用太長的時間，會導致畫面讀取時被卡住，因此 Service Worker 的 activate 事件，時間最好越短越好。</p><h3>Cache API</h3><p>此章節將會介紹 Cache 的方法和屬性。</p><h4>檢查是否支援</h4><p>在使用之前，必須先確保瀏覽器是否支援，可以使用以下方式來檢查。</p><pre>if (&#39;caches&#39; in window) {<br>  // has support<br>}</pre><h4>創建 Cache</h4><p>一個 Origin 可以包含數個 Cache Object ，要創建 Cache 或是連接到已經存在的 Cache ，可以使用 cache.open 的方法。</p><pre>caches.open(cacheName)</pre><p>這個將會回傳 Promise ，可以接收到 Cache Object 。 cacheName 所傳入的是字串，代表是 Cache 的名稱。</p><h4>創建資料</h4><p>有三個方法可在 Cache 中創建資料，分別是： add 、 addAll 、 put ，在這邊將會用 caches.open 所傳回的 Cache Object 來呼叫這三種方法。</p><p>大概會像這樣：</p><pre>caches<br>  .open(&#39;example-cache&#39;)<br>  .then(cache =&gt; {<br>    cache.add(&#39;/example-page&#39;)<br>  })</pre><p>caches.open 回傳 example-cache 的 Cache Object ，接著在 example-cache 的 Cache Object 上使用 add 這個方法來快取 /example-page 。</p><p>cache.add(request) — 這個方法需要傳入 URL 當作參數，接著將取得的 Response 新增到 Cache Object ，而 Key-Value 的 Key 則是 Request ，下次可以透過相同的 Request 從 Cache Object 取得對應的 Response 。</p><p>cache.addAll(requests) — 這個方法與 cache.add 非常類似，不同的是需要傳入 URL 的陣列，不過如果當中有個檔案快取失敗，則整個操作將會失敗。</p><p>cache.put(request, response) — 這個方法需要傳入 Request 和 Response 當作參數。直接使用 fetch() ，並直接將 Response 直接放入快取的情況下，直接使用 cache.add 或是 cache.addAll 就可以了。</p><pre>fetch(url)<br>  .then(response =&gt; {<br>    return cache.put(request, response)<br>  })</pre><h4>比對資料</h4><p>有幾個方法可以搜尋 Cache 裡面的內容，像是： match 或是 matchAll 。這幾個方法可以在 caches 的 Object 被使用，呼叫後會搜尋全部的 Cache ，或是可以透過 caches.open 來搜尋特定的 Cache 。</p><p>caches.match(request, options) — 會回傳帶有 Response 的 Promise ，這個方法只會取得第一個比對成功的結果，如果比對失敗時，則 Response 會是 undefined 。詳細參數屬性可以參考 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Cache/match">MDN Cache.match()</a> 。</p><p>caches.matchAll(request, options) — 這個方法與 caches.match 有點類似，不同的地方是會回傳所有比對相符合的結果。詳細參數屬性可以參考 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Cache/matchAll">MDN Cache.matchAll()</a> 。</p><p>例如： Cache 中已經保存一些儲存在 /images 資料夾的圖片內容，可以透過以下方式取得所有的快取結果</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c053750429dc13b283f80507d6c0e256/href">https://medium.com/media/c053750429dc13b283f80507d6c0e256/href</a></iframe><h4>刪除資料</h4><p>可以透過 cache.delete(request, options) 刪除 Cache 裡面的資料，此方法會比對 Cache 裡面的 Request 並刪除，刪除後會回傳帶有 true （刪除成功）或 false （刪除失敗）的 Promise 。詳細參數屬性可以參考 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Cache/delete">MDN Cache.delete()</a> 。</p><h4>取得 Keys</h4><p>可以透過 cache.keys(request, options) 取得 Cache 裡面的 key 的列表（換句話說：已存在 Cache 裡面的 Request 列表），這會回傳帶有 Request 陣列（排序與新增到 Cache 的排序相同）的 Promise 。</p><p>如果沒有帶入 request 參數，則代表回傳全部的列表；如果有帶入 request 參數，則回傳比對成功的結果。</p><p>這個方法也可以被使用在 caches.keys() ，這個將回傳全部的 Cache 列表。</p><pre>// 會列出 example-cache 中所有的 request<br>caches<br>  .open(&#39;example-cache)<br>  .then(cache =&gt; cache.keys())<br>  .then(keys =&gt; {<br>    console.log(keys) <br>  })</pre><pre>// 會列出所有的 cache object<br>caches<br>  .keys()<br>  .then(keys =&gt; {<br>    console.log(keys)<br>  })</pre><h3>後記</h3><p>快取寫到這應該差不多告個段落，接下來要進入 PWA 中其他有趣的功能了！</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=28508f1b48ee" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day05 — 好的快取讓使用者上天堂 Part 2]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day05-%E5%A5%BD%E7%9A%84%E5%BF%AB%E5%8F%96%E8%AE%93%E4%BD%BF%E7%94%A8%E8%80%85%E4%B8%8A%E5%A4%A9%E5%A0%82-part-2-daec6a768393?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/daec6a768393</guid>
            <category><![CDATA[offline-first]]></category>
            <category><![CDATA[cache-storage]]></category>
            <category><![CDATA[progressive-web-app]]></category>
            <category><![CDATA[pwa]]></category>
            <category><![CDATA[service-worker]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Thu, 22 Mar 2018 17:02:09 GMT</pubDate>
            <atom:updated>2018-03-22T17:25:35.933Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>上篇文章（ <a href="https://medium.com/@jacky810124/progressive-web-application-day04-%E5%A5%BD%E7%9A%84%E5%BF%AB%E5%8F%96%E8%AE%93%E4%BD%BF%E7%94%A8%E8%80%85%E4%B8%8A%E5%A4%A9%E5%A0%82-569c99b8a2">Progressive Web Application Day04 — 好的快取讓使用者上天堂 Part 1</a> ）中已經帶著大家完成快取頁面上的檔案，如果還沒跟上的朋友，記得將上篇文章補上哦，同時<a href="https://github.com/jacky810124/pwa-day04">完整的程式碼也都已將放到 Github 上</a>。</p><p>雖然已經將 App Shell 快取在 Cache Storage ，但是頁面去跟遠端 Server 去拿檔案時，並不知道這些檔案已經被快取，因此這篇文章將會帶著大家解決這個問題。</p><p>此篇文章也是偏向動手做系列，因此附上<a href="https://github.com/jacky810124/pwa-day05">完整的程式碼</a>提供參考，也希望大家都能捲起袖子動手做看看！</p><blockquote><a href="https://github.com/jacky810124/pwa-day05">https://github.com/jacky810124/pwa-day05</a></blockquote><p>當頁面是在 Service Worker 的 Scope 中，頁面中的 Request 將會觸發 Service Worker 的 fetch 事件，因此這個事件中，可以做一些判斷，讓已經被快取的檔案，不用再次跟遠端 Server 拿。</p><p>但是在開始進入 fetch 事件前，必須要先跟大家談談：<strong>什麼是 Service Worker 的 Scope</strong> 。</p><h3>Service Worker 的 Scope</h3><p>Service Worker 的 Scope 決定了 Service Worker 可以控制哪些頁面，透過 navigator.register() 註冊 Service Worker 時，除了傳入 Service Worker 所在的位置，也可以多傳入個 Object 的參數，來決定 Service Worker 的 Scope 。</p><p>所以，完整的 register 大概會長得像這樣</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c03c912963facdde5e1193ef8f4ba23b/href">https://medium.com/media/c03c912963facdde5e1193ef8f4ba23b/href</a></iframe><p>當註冊 Service Worker 時，預設是以 Service Worker 的所在位置作為 Scope ，因此如果 Service Worker 是放在 /sw.js 的情況，則代表 Service Worker 可以控制全部的頁面。</p><p>而以上面的例子來說， Scope 指定在 /app 的情況下，則代表 Service Worker 只能操控 /app 下的頁面，像是網址是 /app/example 或 /app/test 的情況。</p><p>因此，當前的頁面如果不在 Service Worker 的 Scope 中，是沒辦法觸發 fetch 事件的。</p><h3>fetch 事件</h3><p>當頁面中發出 Request 時，就會觸發 Service Worker 中的 fetch 事件，因此可以在 Service Worker 中，加上 self.addEventListener(&#39;fetch&#39;, event =&gt; {}) 來處理 fetch 的事件。</p><p>接收到 fetch 的事件後，在這邊可以做一些判斷，如果在 Cache Storage 裡面已經有了，這樣就直接從 Cache Storage 提供；反之，則需要透過 Fetch 去跟遠端 Server 拿資料。</p><p>整個流程會長得像是這樣：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7iQWhWfxanLiZop8KY-P6w.png" /><figcaption>Fetch Event 的流程</figcaption></figure><p>完整的程式碼大概會長得像這樣：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/608df85e09739756aa51ee57fd2a0a1d/href">https://medium.com/media/608df85e09739756aa51ee57fd2a0a1d/href</a></iframe><p>首先可以看到，這邊不再是使用 event.waitUntil 了，反而是使用 <a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/respondWith">event.respondWith</a> ，這個是因為在 fetch 事件中，代表的是瀏覽器發出 Request 的事件，因此使用 event.respondWith 可以避免瀏覽器預設的事件處理。</p><p>另外在這個 Function 中，必須要傳回含有 Response 的 Promise ，更詳細的說明可以參考 <a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/respondWith">MDN 的 </a><a href="https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/respondWith">FetchEvent.respondWith()</a> 。</p><p><a href="https://medium.com/@jacky810124/progressive-web-application-day04-%E5%A5%BD%E7%9A%84%E5%BF%AB%E5%8F%96%E8%AE%93%E4%BD%BF%E7%94%A8%E8%80%85%E4%B8%8A%E5%A4%A9%E5%A0%82-569c99b8a2#e18b">之前有提過</a>，在 Cache Storage 裡所儲存的是 Key-Value 形式，其實也就是一組組的 Request 與 Response 。透過 self.caches.match(event.request) 來對 Request 做比對，看看在 Cache Storage 裡是否有對應的 Response 。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5tcncoMo8lfNs2-S9FI-vg.png" /><figcaption>是否已經存在 Cache Storage ？</figcaption></figure><p>如果已經 Response 存在 Cache Storage ，則 result 就不會是 null ；反之，如果 Response 不存在 Cache Storage ，則 result 會是 null 。當 Response 不存在 Cache Storage 的情況時，必須透過 Fetch 去遠端 Server 取得資料。</p><h3>實際成果</h3><p>補完所有在 fetch 事件的邏輯後，打開 Chrome 的開發者工具，切換到 Network 的頁面，就可以看到以下的成果。可以看到當頁面需要 App Shell 的檔案時，都可以透過 Service Worker 來提供，大大的降低資料傳輸量與讀取時間。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*143KbAPoBpAS0NqHYQvY9Q.png" /><figcaption>實際成果圖</figcaption></figure><p>除此之外，還有另一個更重要的效果，那就是：<strong>離線體驗。</strong></p><p>當屬於 App Shell 的檔案都可以透過 Service Worker 來提供時，就代表即便使用者處於離線狀態，也可以瀏覽網站。</p><p>做了一個離線瀏覽的 Demo 影片，同時也歡迎大家動手做看看！</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FeNQFsWkQ5ho%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DeNQFsWkQ5ho&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FeNQFsWkQ5ho%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="640" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/39c8087edb0e4e536c9c325be0457579/href">https://medium.com/media/39c8087edb0e4e536c9c325be0457579/href</a></iframe><h3>後記</h3><p>才寫了五天而已，感覺後面的路還好漫長……，真心覺得可以參加鐵人 30 的人都超厲害。希望自己也可以把 PWA 寫成個系列文章，讓大家可以參考，希望不會富奸吧！</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=daec6a768393" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day04 — 好的快取讓使用者上天堂 Part 1]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day04-%E5%A5%BD%E7%9A%84%E5%BF%AB%E5%8F%96%E8%AE%93%E4%BD%BF%E7%94%A8%E8%80%85%E4%B8%8A%E5%A4%A9%E5%A0%82-569c99b8a2?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/569c99b8a2</guid>
            <category><![CDATA[cache-storage]]></category>
            <category><![CDATA[pwa]]></category>
            <category><![CDATA[service-worker]]></category>
            <category><![CDATA[progressive-web-app]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Wed, 21 Mar 2018 19:24:36 GMT</pubDate>
            <atom:updated>2018-03-21T19:30:19.967Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>上一篇文章中（ <a href="https://medium.com/@jacky810124/progressive-web-application-day03-%E9%9A%B1%E8%97%8F%E5%B7%A5%E5%85%B7%E4%BA%BA-service-worker-92e207b64af6">Progressive Web Application Day03 — 隱藏工具人 Service Worker</a> ）簡單介紹了什麼是隱藏工具人 Service Worker ，這篇將會著重在：<strong>如何使用 Service Worker 快取頁面中所需要的檔案</strong>。</p><p>另外，這篇會比較偏向動手做系列文章，因此會附上完整程式碼，如果有興趣的朋友，可以到以下網址查看完整程式碼。</p><blockquote><a href="https://github.com/jacky810124/pwa-day04">https://github.com/jacky810124/pwa-day04</a></blockquote><h3>為什麼要快取呢？</h3><p>俗話說：沒圖沒真相，先來個實際比較圖</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*shDMDtoE9TXWoOuYIu9aNQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iaui9_-gguMYjygfCMnZFg.png" /><figcaption>實際比較圖</figcaption></figure><p>雖然在時間的部分，差異並不是很大，但在資料傳輸量就差了 349KB ，這還只是單純只是一個簡單頁面的靜態檔案，如果是實際的網站，可能還會有不少圖片，傳輸量和時間的差距會更大。</p><p>在有被快取的情況，可以看到在 Size 的欄位，幾乎全部的檔案都是由 Service Worker 所提供的。這代表了檔案已經被儲存在 Cache Storage ，使用者再次瀏覽這個網頁時，不需要再耗費額外的流量去遠端 Server 拿檔案，同時頁面讀取的時間也會變短。</p><p><strong>快取，真的好棒棒！</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/573/1*ofFvLTiySlScvUP_4KfyZg.jpeg" /><figcaption>快取，真的是好棒棒</figcaption></figure><h3>如何快取？</h3><p>在實際動手做快取之前，有幾個角色必須要先認識：</p><ul><li>Service Worker ：隱藏工具人，執行在背景，可以默默的替你處理事情。</li><li>Cache Storage ：透過 Key-Value 的形式儲存 Request 和 Response 。</li></ul><p>對這幾個角色有基本的認識後，接下來就可以開始動手做了！</p><h4>Step.1 創建專案</h4><p>專案的結構大概會長得像這樣</p><pre>.<br>├── app.js<br>├── icons<br>│   ├── android-icon-144x144.png<br>│   ├── android-icon-192x192.png<br>│   ├── android-icon-48x48.png<br>│   ├── android-icon-96x96.png<br>│   ├── favicon-16x16.png<br>│   ├── favicon-32x32.png<br>│   └── favicon.ico<br>├── index.html<br>├── logo.png<br>├── manifest.json<br>└── sw.js</pre><ul><li>index.html — 主要的 HTML 檔。</li><li>app.js — 主要的 JavsScript 程式。</li><li>sw.js — Service Worker 的程式。</li></ul><h4>Step.2 註冊 Service Worker</h4><p>在開始快取之前，必須先註冊 Service Worker ，註冊完成之後，如果 Service Worker 都有被正確的下載與解析，接下來就會觸發 install 的事件，在這個生命週期中，非常適合拿來快取網頁中所需要的靜態檔案。</p><blockquote>謎之聲：如果對 Service Worker 還不熟悉的朋友，把<a href="https://medium.com/@jacky810124/progressive-web-application-day03-%E9%9A%B1%E8%97%8F%E5%B7%A5%E5%85%B7%E4%BA%BA-service-worker-92e207b64af6#b8f4">上個章節</a>看個 10 遍啊</blockquote><p>接著要在 app.js 中註冊 Service Worker ，不過因為 Service Worker 還屬於比較新的功能，因此必須要先檢查瀏覽器是否支援，透過 &#39;serviceWorker&#39; in navigator 可以檢查是否支援。</p><p>如果瀏覽器支援，接下來就可以開始註冊 Service Worker ，可以透過 navigator.serviceWorker.register(&#39;/sw.js&#39;) 註冊，註冊完成之後，接下來就可以透過 Service Worker 快取網頁中的檔案了。</p><p>app.js 完整的程式碼會長得像這樣：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/93d58774b15f7767f2d96b916caed4a9/href">https://medium.com/media/93d58774b15f7767f2d96b916caed4a9/href</a></iframe><blockquote>底下也附上在 2018–03–22 這天的 Service Worker 支援度。</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hPimdzT7qQiB-UDRG5LAjA.png" /><figcaption>Can I Use — Service Worker</figcaption></figure><h4>Step.3 App Shell</h4><p>在開始快取之前，必須要了解哪些是屬於 App Shell 。</p><p>為什麼呢？</p><p>因為 Cache Storage 是有容量的限制，這個會根據瀏覽器的不同，會有不同的限制，但是身為工程師，你有責任把快取給管理好，因此不能把所有的東西都往 Cache Storage 裡面塞。</p><p>App Shell 指的是Web App 的殼，也就是頁面上必要的東西。即便今天使用者沒有網路連線了，透過 Cache Storage 裡面所儲存的 App Shell ，也要能夠正常瀏覽。</p><p>如果以<a href="https://github.com/jacky810124/pwa-day04">完整程式碼範例</a>中的 index.html 為例，屬於 App Shell 的部份大概有：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/049cb73723c5cef4a55e0a51e8c20679/href">https://medium.com/media/049cb73723c5cef4a55e0a51e8c20679/href</a></iframe><p>整理出來之後，就可以開始把這些東西都加進 Cache Storage 了！</p><h4>Step.4 快取</h4><p>在 sw.js 裡面可以開始新增一些有關快取的程式碼，在上篇文章中有提到，在 install 這個生命週期中，非常適合快取頁面中所需要的檔案。</p><p>因此，在 sw.js 需要使用 self.addEventListener(&#39;install&#39;, event =&gt; {}) 來監聽 install 的事件，而快取的邏輯則是寫在這個事件處理中。</p><p>完整的程式碼大概會長得下這樣：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7ef568f620bb4798a52b16fd5b438677/href">https://medium.com/media/7ef568f620bb4798a52b16fd5b438677/href</a></iframe><p>看到一大片程式碼覺得慌嗎？別擔心，一步步來看。</p><blockquote>謎之聲：在 Service Worker 中，會使用大量的 Promise 作為非同步的流程控制，因此如果對於 Promise 還不很熟，建議先把 Promise 補起來，再進行接下來的部分。</blockquote><p>在事件處理中，可以看到 event.waitUntil 這個方法，這個方法主要是用來避免 Service Worker 在快取還沒完成前，就進入 terminated 的狀態，因此透過這個方法可以告訴 Service Worker ，還有事情還沒結束，必須等到結束後才能進入 terminated 。</p><p>接著是 self.caches.open(APP_ASSETS_CACHE_NAME) ，這個部分則是在 Cache Storage 中，取得一個符合 APP_ASSETS_CACHE_NAME 的 Cache object，透過 Promise 的 then 則可以接收到這個 Cache object。</p><p>用 cache.addAll 就可以把剛剛整理出來的 App Shell 路徑，通通快取起來。</p><p>因此整個快取的流程，簡單來說就是：</p><ol><li>接收到 install 事件</li><li>取得符合 APP_ASSETS_CACHE_NAME 的 Cache object</li><li>儲存到 Cache Storage</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gsDzPJpYJE6Mn9drMGkstw.png" /><figcaption>簡易快取流程</figcaption></figure><p>做到這邊，整個快取的流程就差不多了，但是開啟網站後，會發現不管重新整理多少次，還是會去跟遠端 Server 去要資料，到底有沒有把檔案快取起來啊？</p><p>可以透過 Chrome 的開發者工具，切換到 Application 分頁後展開 Cache Storage ，選擇 app-assets-cache-v0.0.1 ，應該可以看到類似的畫面。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9_vQ3lv7NhBIW3GXJxk6Ig.png" /><figcaption>Cache Storage in Chrome Dev Tool</figcaption></figure><p>這個畫面代表了，的確有把東西存進 Cache Storage ，但是當頁面去發 Request 時，並不知道在 Cache Storage 裡已經有了，因此還是會再次去跟遠端 Server 拿資料。</p><p>下個章節，來改善這個問題！</p><h3>後記</h3><p>啊啊啊啊，這篇文章也寫好久啊，發現動手做系列的文章，需要花費更長的時間，覺得一天一篇文章好像會很容易難產，不知道在文章中附上程式碼說明與<a href="https://github.com/jacky810124/pwa-day04">完整的程式碼</a>大家會不會更容易了解？</p><p><a href="https://www.facebook.com/GoodideasStudio">好想工作室</a>的 <a href="https://www.facebook.com/ken1271">Ken</a> 在 2018–03–22 13:30 也會分享<a href="https://www.facebook.com/GoodideasStudio/photos/a.1548098875429314.1073741829.1531156107123591/2011628435743020/?type=3">「建構 PWA」—如何建構 PWA</a> ，有興趣的朋友也可以抽空前往參加活動。</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=569c99b8a2" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day03 — 隱藏工具人 Service Worker]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day03-%E9%9A%B1%E8%97%8F%E5%B7%A5%E5%85%B7%E4%BA%BA-service-worker-92e207b64af6?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/92e207b64af6</guid>
            <category><![CDATA[progressive-web-app]]></category>
            <category><![CDATA[pwa]]></category>
            <category><![CDATA[service-worker]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Wed, 21 Mar 2018 15:57:48 GMT</pubDate>
            <atom:updated>2018-03-21T16:01:17.289Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>上篇文章（ <a href="https://medium.com/@jacky810124/progressive-web-application-day02-%E5%88%B0%E5%BA%95%E4%BB%80%E9%BA%BC%E6%98%AF-manifest-9f6e21994b36">Progressive Web Application Day02 — 到底什麼是 Manifest</a> ）中提到了什麼是 Manifest ，接著要來討論在 PWA 中也佔據非常重要地位的：<strong>隱藏工具人— Service Worker 。</strong></p><p>在 PWA 中可以做到許多以前是 Native App 的專屬功能，像是：推播訊息、離線瀏覽……等，因為有了 Service Worker 在背景的執行，才能讓這些功能也能在 Web App 上執行。</p><h3>什麼是 Service Worker</h3><p>Service Worker 有幾項特色：</p><ul><li>能夠在背景執行，即便使用者不開啟網站，也能夠與網站互動（例：使用者關閉網站後，還是能夠接收推播訊息）。</li><li>是 JavaScript Worker ，因此不能夠直接操作 DOM ，但是可以透過 postMessage 與頁面溝通，讓頁面代替 Service Worker 操作 DOM 。</li><li>可以操作與控制頁面上的 Request 。</li><li>以非同步的概念去設計，使用 Promise 作為非同步的流程控制。</li><li>可以在背景執行，在安全的考量下，需要執行在 localhost 或是 HTTPS 的環境中。</li></ul><p>基本上 Service Worker 就是在背景默默去幫你做許多事情，也是因為有了這個工具人，讓 Web App 可以達成許多原本專屬於 Native App 的功能。</p><h3>Service Worker 的一生</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bZEgngRoTDR8O5oGuuQgtw.png" /><figcaption>Service Worker 生命週期</figcaption></figure><p>生命週期在 Service Worker 中屬於比較複雜的部分，但是只要搞懂了，就能夠了解各個週期中該做的事情是什麼。</p><h4>Parsed</h4><p>呼叫 register() 後，將會下載與解析 Service Worker ，成功後就會進入到此階段，但如果下載與解析中發生錯誤，此 Service Worker 將會被捨棄。</p><h4>Install</h4><p>Service Worker 的第一個觸發的事件是 install ，這個會在 Service Worker 執行時被觸發， install 事件每個 Service Worker 只會被觸發一次，但是當你修改了 Service Worker ，將會視為不同的 Service Worker ，此事件將會再次被觸發。</p><p>在這個階段，很適合拿來快取頁面中所需要的檔案。</p><h4>Activate</h4><p>此階段 Service Worker 已經準備好處理 push 或是 sync ……等各種事件，在這階段也會收到 activate 的事件，此階段適合拿來清理舊的快取，或是搬移資料庫。</p><h3>後記</h3><p>最近想說把 PWA 的部分，拿來當鐵人 30 來寫，不過因為這個東西也還不是非常熟悉，需要花蠻多時間的……，如果文章更新的時間不太固定，還請多多見諒啊啊啊。</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=92e207b64af6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day02 — 補充： Web Server For Chrome]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day02-%E8%A3%9C%E5%85%85-web-server-for-chrome-87bd9ceac241?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/87bd9ceac241</guid>
            <category><![CDATA[pwa]]></category>
            <category><![CDATA[web-server-for-chrome]]></category>
            <category><![CDATA[progressive-web-app]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Tue, 20 Mar 2018 11:17:20 GMT</pubDate>
            <atom:updated>2018-03-20T11:17:20.343Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MlO9uyRzSlooE175HahxiQ.png" /><figcaption>Progressive Web Application</figcaption></figure><p>在 <a href="https://medium.com/@jacky810124/progressive-web-application-day02-%E5%88%B0%E5%BA%95%E4%BB%80%E9%BA%BC%E6%98%AF-manifest-9f6e21994b36">Progressive Web Application Day02 — 到底什麼是 Manifest</a> 中提到了 <a href="https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb">Web Server For Chrome</a> ，應該有些人對於這個東西有點陌生。其實可以把它想成是專門拿來提供靜態檔案的 Server 就可以了，有點類似 Nginx 或是 Apache ，只是專門拿來提供靜態檔案。</p><blockquote>神秘的聲音：如果了解該如何提供靜態檔案，此篇文章可以跳過</blockquote><p>為什麼要使用這個東西呢？</p><p>當工程師把網站寫好後，會是一個 HTML 格式的檔案，雖然可以開啟檔案，但是直接開啟可能會造成一個問題：<strong>就是樣式與 JavaScript 可能會遺失！</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CqA38_JMD3addh74wivsLg.png" /><figcaption>透過直接開啟檔案的方式打開 index.html</figcaption></figure><p>這是因為，在網頁中載入樣式和 JavaScript 通常是使用絕對路徑來載入，像是 &lt;script src=&quot;/app.js&quot;&gt;&lt;/script&gt; ，因此直接開啟 HTML 檔案是沒辦法正確的顯示網頁。</p><p>因此，除了把 HTML 檔案產出之外，我們還需要 Server 來提供靜態檔案，讓HTML 可以正常的顯示出來。</p><h3>如何使用 Web Server For Chrome</h3><p><a href="https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb">Web Server For Chrome</a> 本身是 Chrome 的擴充套件，因此可以到 Chrome 的線上應用程式商店安裝，網址如下：</p><blockquote><a href="https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb">https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb</a></blockquote><p>安裝完成之後，會出現在 Chrome 的應用程式。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oVrLVqUUJM8ZQ3tiYIGXAw.png" /></figure><p>將 Web Server For Chrome 開啟，畫面會如下圖：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qotIIwOj3eA4hXBjie84Yw.png" /><figcaption>開啟 Web Server For Chrome 的畫面</figcaption></figure><p>那該如何來使用呢？操作步驟如下：</p><ol><li>利用 CHOOSE FOLDER 選擇 HTML 檔所在的資料夾。</li><li>將開關開啟後，能夠提供靜態檔案的 Server 就完成了。</li><li>接著，可以透過 Web Server URL(s) 裡面的連結來開啟網頁。</li></ol><p>像是在這台電腦中， Web Server URL(s) 分別是：</p><ul><li><a href="http://192.168.0.10:8887/">http://192.168.0.10:8887/</a></li><li><a href="http://127.0.0.1:8887/">http://127.0.0.1:8887/</a></li><li><a href="http://192.168.1.6:8887/">http://192.168.1.6:8887/</a></li></ul><p>這三組網址都能將網頁正確的開啟，網頁開啟的畫面取決於 HTML 檔案，因此每個人的畫面不見得會相同。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dGZjWoxYzTrA2iCwdVfVmA.png" /></figure><h3>後記</h3><p>這篇文章寫得時間比較想像中久很多，有點不知道該如何去解釋一些基本概念，同時也怕寫得不夠清楚，如果還是有哪邊寫得不夠清楚，也都歡迎在底下留言給我</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=87bd9ceac241" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Progressive Web Application Day02 — 到底什麼是 Manifest]]></title>
            <link>https://medium.com/@jacky810124/progressive-web-application-day02-%E5%88%B0%E5%BA%95%E4%BB%80%E9%BA%BC%E6%98%AF-manifest-9f6e21994b36?source=rss-56f3dc05bd29------2</link>
            <guid isPermaLink="false">https://medium.com/p/9f6e21994b36</guid>
            <category><![CDATA[progressive-web-app]]></category>
            <category><![CDATA[pwa]]></category>
            <dc:creator><![CDATA[Jacky810124]]></dc:creator>
            <pubDate>Mon, 19 Mar 2018 17:25:48 GMT</pubDate>
            <atom:updated>2018-03-20T10:48:39.996Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ZmLQiEE7aoE4UnXsxIRv7g.png" /><figcaption>Progressive Web Application</figcaption></figure><p><a href="https://medium.com/@jacky810124/progressive-web-application-day01-pwa%E7%9A%84%E6%84%8F%E7%BE%A9-29e8d2a940de">上一篇文章（ Progressive Web Application Day01 — PWA 的意義）</a>中提到了為什麼要做 PWA ，既然了解了為什麼要做，接下來就進入到該怎麼做，身為工程師當然要捲起袖子動手做一下囉！</p><p>在 PWA 中有兩個東西是非常重要的： <a href="https://developer.mozilla.org/zh-TW/docs/Web/Manifest">Manifest</a> 和 <a href="https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API">Service Worker</a> ，在今天的文章中，會先介紹 Manifest 的部分。 Manifest 決定了 PWA 要怎麼去呈現，讓 Web App 用起來與看起來可以跟 Native App 有 87% 像。</p><p>所以今天就先跟大家介紹：<strong>到底什麼是 Manifest ？</strong></p><h3>什麼是 Manifest</h3><p>Manifest 是 JSON 格式的檔案，提供了 Web App 的相關資訊，同時也包含了一些 Web App 該怎麼呈現的設定。</p><p>像是底下這張圖，就是一個標準的 Manifest 檔案，其中可以看到 Web App 的名稱、摘要、 Web App Icon 與一些該如何呈現的設定……等。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iaGnCPHh5bcIsLQGHv3L7g.png" /><figcaption>Manifest JSON File</figcaption></figure><p>對 Manifest 有了基本的認識之後，接著就來看看 Manifest 有哪些屬性可以設定呢？</p><h3>Manifest 屬性說明</h3><p>在 Manifest 裡面有非常多的屬性可以設定，以下列出所有的屬性與說明：</p><ul><li>name：完整名稱</li><li>short_name：比較簡短的名稱，用在不能顯示 name的情況</li><li>description：應用程式的簡介</li><li>background_color：背景顏色</li><li>theme_color：主題顏色</li><li>display： 呈現的方式</li><li>orientation：顯示方向</li><li>icons：應用程式名稱</li><li>start_url：應用程式名稱</li><li>lang：語言</li><li>dir：書寫方向</li><li>prefer_related_applications：是否要推薦相關的應用程式，這個應該被用在當 Native App 提供了 Web App 無法替代的功能時</li><li>related_applications：能夠被底層平台安裝或使用的 Native App</li><li>scope：可使用的範圍，如果使用者超出 Manifest 所提供的範圍，將會回到原本的 Web App</li></ul><p>這些是在 <a href="https://developer.mozilla.org/zh-TW/docs/Web/Manifest">MDN - Web AppManifest</a> 上有列出的屬性，各屬性可使用的值，可以請參考 <a href="https://developer.mozilla.org/zh-TW/docs/Web/Manifest">MDN - Web App Manifest</a> 的文件。</p><h3>引入 Manifest</h3><p>Manifest 設定完成之後， 大概會長得類似像是這樣：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/577eee2349fe970438089c94f990ef4d/href">https://medium.com/media/577eee2349fe970438089c94f990ef4d/href</a></iframe><p>在 index.html 中把 Manifest 引入近來</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/41f3c463b38cccf307774b1c2b988641/href">https://medium.com/media/41f3c463b38cccf307774b1c2b988641/href</a></iframe><p>接下來，可以透過 <a href="https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb">Web Server For Chrome</a> 或是類似的工具，開啟一個 Server 來提供靜態檔案。將網站開啟後，開啟 Chrome 的開發者工具，在 Application 的分頁，就可以看到 Manifest 的被成功載入後的效果。</p><blockquote>神祕的聲音：開啟 Chrome 的開發者工具可以透過以下快捷鍵</blockquote><blockquote>Windows ： ctrl + shift + i</blockquote><blockquote>Mac ： cmd + opt + i</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TnvZ4sJK8H3OJIt_P5Eb5Q.png" /><figcaption>Manifest 載入成功</figcaption></figure><p>但是，在開發者工具中只能看到 Manifest 有被 Chrome 正確地被引入，也有正確的被解析， Manifest 對於 PWA 的目的在哪呢？</p><h3>設定 Manifest 的目的</h3><p>會說 Manifest 在 PWA 中佔了非常重要的地位，那是因為在 PWA 中幾個很重要的功能，例如： Install Banner 、 Splash Screen 或類似 Native App 的呈現方式，這些都是需要 Manifest 屬性有被正確的設定，才能正常的使用，因此才會說 Manifest 在 PWA 中非常重要。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0QjvRFBoTI43qUS4r535yw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kBoWDUtfOncmCllmUvz3xA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zcHNFrGmNBJ1YPoQXE26MQ.png" /><figcaption>左： Splash Screen 、中： Install Banner 、右： standalone 呈現方式</figcaption></figure><h3>後記</h3><p>寫到這邊才發現有些工具或是觀念，對於剛接觸網頁的開發者，可能不是很熟悉，不知道大家是否有看不懂的地方？如果有的話都歡迎在底下留言給我。</p><p>今天可能還會再寫一篇有關 <a href="https://chrome.google.com/webstore/detail/web-server-for-chrome/ofhbbkphhbklhfoeikjpcbhemlocgigb">Web Server For Chrome</a> 的簡介，對於和 Apache 或 Nginx 不是很熟悉的人，這個工具可以非常容易就開起提供靜態檔案的 Server ，非常值得推薦！</p><p>2018–03–15 在<a href="https://www.facebook.com/GoodideasStudio/">好想工作室</a>有分享 <a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">PWA — 簡單介紹</a> 這個主題，雖然活動已經結束，但還是放上<a href="https://docs.google.com/presentation/d/1FVTplZVYoI0bX0hAXYdE0-DwlQDsHICduRVGEKoXWlE/edit?usp=sharing">活動簡報</a>，如果對於 PWA 有興趣的話，都歡迎<a href="https://www.facebook.com/jacky810124/">聯絡我</a>或是在底下留言給我。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f6e21994b36" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>