web app manifest文件清单详解说明

最新推荐文章于 2025-03-31 10:18:42 发布

1024小神

最新推荐文章于 2025-03-31 10:18:42 发布

阅读量1.1k

点赞数

分类专栏： HTML前端文章标签： web app 前端 javascript

本文链接：https://blog.csdn.net/weixin_44786530/article/details/130359845

版权

HTML前端专栏收录该内容

731 篇文章

订阅专栏

是一个 JSON 文件，它告诉浏览器您的Web应用程序以及在用户移动设备或桌面上“安装”时它应该如何表现。 Chrome需要提供清单才能显示“添加到主屏幕”提示。

典型的清单文件包括有关应用程序名称，应使用的图标，启动时应启动的start_url等信息。

创建清单

PWA的完整manifest.json文件

{
  "short_name": "Maps",
  "name": "Google Maps",
  "icons": [
    {
      "src": "/images/icons-192.png",
      "type": "image/png",
      "sizes": "192x192"
    },
    {
      "src": "/images/icons-512.png",
      "type": "image/png",
      "sizes": "512x512"
    }
  ],
  "start_url": "/maps/?source=pwa",
  "background_color": "#3367D6",
  "display": "standalone",
  "scope": "/maps/",
  "theme_color": "#3367D6"
}

注意：请参阅添加到主屏幕标准，了解显示添加到主屏幕提示所需的特定属性。

告诉浏览器您的清单

创建清单后，为包含Web应用程序的所有页面添加 link标签：

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

清单属性

short_name 和/或 name

您必须至少提供 short_name或 name 属性。如果两者都提供，则在用户的主屏幕，启动器或其他可能空间有限的地方使用 short_name。 name 用于应用安装提示。

"short_name": "Maps",
"name": "Google Maps"

icons

当用户将您的站点添加到其主屏幕时，您可以定义一组供浏览器使用的图标。这些图标用于主屏幕，应用程序启动器，任务切换器，启动画面等位置。

icons是一个图像对象数组，每个对象应包括src，一个sizes属性和图像类型。

"icons": [
  {
    "src": "/images/icons-192.png",
    "type": "image/png",
    "sizes": "192x192"
  },
  {
    "src": "/images/icons-512.png",
    "type": "image/png",
    "sizes": "512x512"
  }
]

成功：包括192x192像素图标和512x512像素图标。 Chrome会自动缩放设备的图标。如果您希望缩放自己的图标并将其调整为像素完美，请以48dp的增量提供图标。

start_url

start_url 告诉浏览器应用程序在启动时应该从哪里开始，并阻止应用程序启动用户在将应用添加到主屏幕时所处的页面。

您的 start_url 应该将用户直接引导到您的应用中，而不是产品目标网页。想一想用户打开您的应用后想要做什么，并将它们放在那里。

"start_url": "/?utm_source=a2hs"

成功：在start_url的末尾添加一个查询字符串，以跟踪您的应用启动的频率。

background_color

首次启动应用程序时，会在启动屏幕上使用background_color属性。

display

您可以自定义启动应用时显示的浏览器UI。例如，您可以隐藏地址栏和浏览器边。或者游戏可能想要完全全屏。

"display": "standalone"

参数

值	描述
fullscreen	在没有任何浏览器UI的情况下打开Web应用程序，占用整个可用的显示区域。
standalone	打开Web应用程序，使其外观和感觉就像一个独立的本机应用程序。该应用程序在自己的窗口中运行，与浏览器分开，并隐藏标准浏览器UI元素，如URL栏等。
minimal-ui	Chrome不支持该模式类似于全屏，但为用户提供了一些访问用于控制导航（即，后退，前进，重新加载等）的最小UI元素集的方法。
browser	标准的浏览器体验。