Manifest 中的清单成员
id 清单成员
发布于
清单成员 id 用来标识 Web 应用,让身份独立于启动 URL。没有这个成员时,浏览器通常用 start_url 等值确定身份;启动 URL 一变,清单就代表新的应用,新旧安装会并存。设置 id 后,修改 start_url 不会改变应用身份。
Chrome 96、Edge 96、Samsung Internet 17.0、iOS 上的 Safari 16.4 以及 macOS 上的 Safari 17 处理该
成员(BCD manifests.webapp.id)。Firefox 会解析该属性,但它不起作用(BCD 说明)。忽略 id 的浏览器沿用原先的身份规则,所以加上该成员不会破坏其他平台上的安装。
| 属性 | 值 |
|---|---|
| 类型 | 字符串,相对 start_url 的源按 URL 解析。浏览器拒绝解析到其他源的值;Chromium 记录 property 'id' ignored, should be same origin as document. 并退回默认值。 |
| 默认值 | 解析后的 start_url。id 缺失、为空或无法解析时,身份就与启动 URL 绑在一起,设置有效的成员值才能解除这种绑定。 |
| 示例值 | "/?homescreen=1",对 https://example.com 上的应用解析为 https://example.com/?homescreen=1。 |
处理清单时,解析后的值会与每个已安装应用的身份比较。匹配意味着“更新这个应用”;不匹配意味着“新
应用”。比较的是完整解析后的 URL,所以 "/" 与 "/?v=2" 是两个不同的应用,值应当选定一次后不再
动。Chromium 对已安装应用每天检查一次更新,多数字段的改动要等该应用的所有窗口关闭后才应用
(web.dev,“How Chrome handles updates to the web app manifest”);只有 id 存在且未变时,改动
start_url 才算更新。
navigator.getInstalledRelatedApps() 读不到 id:它报告相关的原生应用,以及(Chrome 80+)在
related_applications 中以 platform: "webapp" 列出的 PWA,匹配时只看清单 URL,不读取 id。
首次发布前先设好 id。已经发布的应用如果没有 id,先找回现有身份,再填入这个成员。
首次安装前固定身份
链接到“首次安装前固定身份”一节用较短的根相对路径即可;该成员相对 start_url 的源解析,写上协议和主机没有意义。启动 URL 带
着分析参数,以后可以改而不触及身份。
{ "name": "Ledger", "id": "/", "start_url": "/app/?source=pwa", "scope": "/app/", "display": "standalone"}Chrome 96+ 与 Safari 16.4+ 把身份记录为 https://example.com/;之后一份
"start_url": "/dashboard/?source=pwa" 的清单会更新已安装的应用,不会增加安装副本。
移动 start_url 而不产生重复安装
链接到“移动 start_url 而不产生重复安装”一节身份固定后,改动启动路径的改版只需编辑 start_url 与 scope。身份那一行是不能动的。
{ "name": "Ledger", "id": "/", "start_url": "/home/", "scope": "/", "display": "standalone"}在 Chrome 155 上,已安装应用在下一次每日清单检查时拿到新的 start_url,并在应用窗口全部关闭
后应用它;在忽略 id 的浏览器上,只要该浏览器此前没用过 start_url 当身份键,同样的改动也能正常
工作。
为没带 id 就发布的应用补上 id
链接到“为没带 id 就发布的应用补上 id”一节在声明 id 之前安装的应用,其身份是 Chromium 从 start_url 算出来的。要保留现有安装,把 id 设为 DevTools 显示的精确值。这个脚本读取页面链接的清单,打印出可复制的值;抓取失败时给出提示。
async function suggestedId() { const link = document.querySelector('link[rel="manifest"]'); if (!link || !('fetch' in window)) return null; // 没有可检查的东西。 const manifest = await fetch(link.href).then((r) => r.json()).catch(() => null); if (!manifest) return null; if (manifest.id) return new URL(manifest.id, location.origin).href; return new URL(manifest.start_url ?? '/', link.href).href; // Chromium 的默认身份。}
const id = await suggestedId();console.log(id ? `Set "id" to ${new URL(id).pathname + new URL(id).search}` : 'Manifest not readable');对 "start_url": "/app/?source=pwa",打印出的值是 /app/?source=pwa;把这个字符串声明为 id
就冻结了现有用户已经拥有的身份,此后 start_url 可以自由更改。
另请参阅
链接到“另请参阅”一节- start_url 清单成员
- 已安装的 PWA 如何获取清单更新
- N+1 安装问题:同一 PWA、多份互相独立的安装
- getInstalledRelatedApps():检测已安装的原生应用或 PWA 对应物
- Web Application Manifest: id member(w3.org)
- Uniquely identifying PWAs with the web app manifest id property(developer.chrome.com)
- WebKit Features in Safari 16.4(webkit.org)
规范
| 规范 | 状态 |
|---|---|
| Web 应用清单:id | W3C |
| Web Application Manifest: start_url member | W3C |
- 图例
- 支持
- 部分支持
- 需开启标志
- 不支持
- 未知
| 浏览器 / 平台 | 支持 | 版本 | 置信度 | 来源 | 备注 |
|---|---|---|---|---|---|
| Chrome (Desktop)# | 支持 | 96 | 高 | 来源 | — |
| Chrome (Android)# | 支持 | 96 | 高 | 来源 | 1 |
| Edge (Desktop)# | 支持 | 96 | 高 | 来源 | 2 |
| Firefox (Desktop)# | 不支持 | — | 高 | 来源 | 3 |
| Firefox (Android)# | 不支持 | — | 高 | 来源 | 4 |
| Safari (macOS)# | 支持 | 17 | 高 | 来源 | — |
| Safari (iOS)# | 支持 | 16.4 | 高 | 来源 | — |
| Samsung Internet# | 支持 | 17.0 | 高 | 来源 | 5 |
| WebView (Android)# | 支持 | 96 | 高 | 来源 | 6 |
- 由 browser-compat-data 镜像自 Chrome 的数据推导。
- 由 browser-compat-data 镜像自 Chrome 的数据推导。
- 该属性可以解析,但没有任何效果。
- browser-compat-data 未记录 Firefox for Android 的支持。
- 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
- 由 browser-compat-data 镜像自 Chrome Android 的数据推导。