跳到主要内容

如何满足最低 PWA 要求

检查清单​

要求为什么重要
通过 HTTPS 提供这个 Web App。可安装的 PWA 必须运行在安全来源上。
让应用中的每个页面都暴露 Web App Manifest。Manifest 负责定义应用级身份信息和启动行为。
提供 WebSpatial Runtime 所需的最小 manifest 字段。Runtime 需要应用身份、图标资源和起始场景设置。

添加 manifest 链接​

在每个 HTML 文档中添加 manifest 链接
<link rel="manifest" href="/app.webmanifest" />

这个 manifest 的 URL 应该返回 JSON MIME 类型的响应，比如 application/manifest+json。

延伸阅读

可参考 MDN 和 web.dev 了解更多关于可安装 PWA 的要求。

提供最低限度的 manifest 字段​

字段作用备注
name 或 short_name提供应用名称。至少要存在其中一个字段。
icons提供应用图标。至少包含一个 "purpose": "any" 图标，以及一个尺寸不小于 1024×1024、没有透明背景和圆角的 "purpose": "maskable" 图标。
start_url配置起始场景对应的网址。它决定应用启动后首先加载哪个页面。
display配置网页窗口的显示模式。WebSpatial Runtime 当前只支持 "standalone" 和 "minimal-ui"。
满足 WebSpatial 要求的最小 manifest
{
  "name": "My Awesome App",
  "start_url": "/",
  "display": "minimal-ui",
  "icons": [
    {
      "src": "/pwa-512x512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "any"
    },
    {
      "src": "/pwa-1024x1024.png",
      "sizes": "1024x1024",
      "type": "image/png",
      "purpose": "maskable"
    }
  ]
}
示例文件

webspatial-icon-examples.zip 中已经包含满足下列要求的示例图标。

尺寸用途出现场景允许透明背景允许圆角提供方式
48 × 48favicon.ico浏览器标签栏必须允许HTML <link>
180 × 180iOS 应用图标iOS“添加到主屏幕”不允许不允许HTML <link>
192 × 192标准 PWA 图标主屏幕的小图标必须必须Web App Manifest
512 × 512标准 PWA 图标各类启动页、应用市场等必须必须Web App Manifest
1024 × 1024空间应用图标visionOS, PICO OS 6不允许不允许Web App Manifest