动态清单更新让 PWA 无需重新安装即可刷新元数据
如何在安装后通过支持更新的清单交付保持 PWA 列表的新鲜度。
为什么这对 OpenPWA 很重要
许多团队仍将 Web App Manifest 视为项目启动时一次性编写的静态文件。实际上,市场和发现页面会在安装很久之后读取清单数据。动态更新让已安装用户能获得当前品牌、新增快捷方式和修正后的元数据。
OpenPWA 更新检查清单
- 为清单添加版本(
version或时间戳注释),以便检测变更。 - 为已登录用户提供较短的缓存时间或正确的
Cache-Control。 - 更新 manifest JSON 后,触发轻量级 Service Worker 更新,让浏览器重新获取。
- 通过
navigator.getInstalledRelatedApps()或 Android/ChromeOS 应用信息页验证变更是否生效。 - 记录哪些清单字段可在安装后安全变更(图标、快捷方式、描述),哪些可能需要用户重新同意(scope、start_url)。
官方来源事实
- Chrome 和 Edge 支持大多数字段的动态清单更新:https://developer.chrome.com/docs/web-platform/web-app-manifests
- MDN 记录了更新行为:https://developer.mozilla.org/en-US/docs/Web/Manifest
- Safari 26 改进了 iOS 上的清单更新可靠性。
分发影响
能够刷新自身列表元数据的 PWA 无需强制用户再次走安装流程,即可在应用目录和搜索结果中保持相关性。
下一步行动
添加清单版本字段和小型管理界面,让市场团队能够更新图标和快捷方式。测量已安装用户在 7 天内接收到更新元数据的比例。