Web App Manifest

2020-02-20 23:41:10

Web App manifest 是一個 JSON 格式的文件，它提供了應用程式相關的資訊，像是名稱、作者、圖示和描述等，還可以設定類似 app 的開啟畫面，可以讓使用者將 Web 應用程式安裝到設備的主畫面，提供更快速的訪問和更豐富的體驗。

Web App manifests 是屬於 PWA(progressive web apps) 的 Web 技術的一部分，是一個能不透過 App 商店就能被安裝到設備主畫面的 Web 應用程式，這個技術還包含了離線使用與通知的接收發送。

關於 manifest 也看先看這隻 google 介紹的影片：

設定好 manifest 後只要像這樣在頁面加上連結就可以了：

以下則為可以設定的參數：

name：網站的完整名稱
short_name：網站的簡短名稱，啟動圖示上會
顯示的名稱
icons：啟動網頁的圖示
start_url：點選啟動圖示會開啟的網頁
display：網頁顯示模式，有以下4種選擇

fullscreen：隱藏瀏覽器的URL
standalone：隱藏瀏覽器的UI
minimal-ui：顯示最少的UI，類似standalone
browser：同原有瀏覽器的設定

orientation：手機瀏覽網站的方向，可分成 landscape 與 portrait
dir：文字顯示方向，可分成ltr(左到右)、rtl(右到左)、auto三種
description：網站內容的敘述
lang：網站的語言
background_color：過場時的背景顏色
theme_color：資訊列的顏色
scope: 如果有填，這樣 app 的作用範圍就會在指定的資料夾內，超過則會變成一般網頁

以下為制服地圖的範例 manifest 檔案：

{
  "name": "Uniform Map 制服地圖",
  "short_name": "Uniform Map",
  "theme_color": "#ad2148",
  "background_color": "#ad2148",
  "display": "fullscreen",
  "Scope": "/",
  "start_url": "/",
  "description": "制服地圖以制服為出發點，希望帶給喜歡制服的朋友青春的回憶，非常歡迎大家提供各種相關的訊息，舉凡學校、動漫或其他行業制服等，都可以讓網站的資料更豐富。",
  "lang": "zh-Hant-TW",
  "icons": [
    {
      "src": "assets/icons/icon-72x72.png",
      "sizes": "72x72",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-96x96.png",
      "sizes": "96x96",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-128x128.png",
      "sizes": "128x128",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-144x144.png",
      "sizes": "144x144",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-152x152.png",
      "sizes": "152x152",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-384x384.png",
      "sizes": "384x384",
      "type": "image/png"
    },
    {
      "src": "assets/icons/icon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ],
  "splash_pages": null
}

也可以透過線上工具 Web App Manifest Generator 幫我們產生這個檔案，其中有一個功能只要上傳 512 x 512 大小的圖片就可以直接幫我們產生各種尺寸的大小很方便。

設定好後可以透過 Web App Manifest Validator 幫我們檢查格式是否正確。

之後就可以透過將網頁加到主畫面的方式將網頁放到桌面了。