PWA:用 Manifest 定義 App 的名稱

PWA 所以可以用來加到電腦和手機的桌面,並打造接近原生的使用者體驗,靠的就是 Manifest.json。究竟 Manifest.json 裡面記載了什麼呢?

PWA:用 Manifest 定義 App 的名稱

PWA 所以可以用來加到電腦和手機的桌面,並打造接近原生的使用者體驗,靠的就是 Manifest.json。究竟 Manifest.json 裡面記載了什麼呢?

Manifest.json 記載了 App 的相關資訊,像是 App 名稱、描述、圖案、顏色、大小等。而且你只需要準備一個 json 檔,和相對應的圖示就可以了。

範例 Manifest

這邊取上一篇提到的範例,可以在 GitHub 上存取 這個檔案

{
  "short_name": "訂房 × PWA",
  "name": "訂房 × PWA Example",
  "icons": [
    {
      "src": "favicon.ico",
      "sizes": "64x64 32x32 24x24 16x16",
      "type": "image/x-icon"
    },
    {
      "src": "logo192.png",
      "type": "image/png",
      "sizes": "192x192"
    },
    {
      "src": "logo512.png",
      "type": "image/png",
      "sizes": "512x512"
    }
  ],
  "start_url": ".",
  "display": "standalone",
  "theme_color": "#eeeeee",
  "background_color": "#eeeeee"
}
  • name:App 的名稱
  • short_name:App 在應用程式列表顯示的名稱
  • icons:定義 App 會顯示的圖示。可能會顯示在網址列、手機桌面等。
  • start_url:App 開啟後要顯示的路徑,例如 /login.html 之類的
  • display:設定 App 要不要顯示全螢幕。
  • theme_color:主題顏色,例如狀態列的顏色。
  • background_color:App 的背景色。

除了這個以外,也可以設定 App 是否允許旋轉螢幕、預設是直的還是橫的,App 的啟動畫面(Splash Screen)、App 的主要語言等等。

而要把 Manifest.json 加到 App 中也只要在 <head> 裡面即可,透過 <link> 語法即可嵌入:

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

有了 Manifest.json 後不代表就是一個正常的 PWA,不過你就可以把 App 加到桌面上了。透過 Android 的 Chrome 可以加到主畫面、Safari 則在分享選單中可以加到主畫面。如果你寫好一個正確的 PWA,就會直接出現加到主畫面的提示。

PWA_Homescreen

本篇文章同步發表在 iT邦幫忙

我們正降低廣告比例以提升閱讀體驗。如果你喜歡這篇文章,不妨按下 Like 按鈕分享到社群,以行動支持我寫更多文章。 當然,你也可以 點此用新臺幣支持我,或 點此透過 BTC、ETH、USDC 等加密貨幣支持我
分享到: