跳转到内容

从原生应用迁移到 PWA

发布于

Progressive Web App 是一种 Web 应用,操作系统可以像安装、启动原生应用一样安装和启动它。PWA 用 URL 交付,下次加载时更新,运行时使用安装它的浏览器引擎。迁移原生应用时,先把功能逐项对应到 Web 能力和兼容性条目,再为现有 Web 产品添加 manifest 和 Service Worker,让它可安装。还要按操作系统规划安装与卸载流程,这些流程与商店应用不同。

你需要原生应用的功能列表、产品的 Web 版本(或决定去做一个),以及一个使用 HTTPS 的域名。

列出原生应用依赖的每一项系统集成,承诺支持前先逐项核对浏览器支持情况。需要核对的项目包括推送通知(Web Push)、应用图标角标(角标)、分享到应用(Share target)、打开文件(file_handlers)、支付(Payment Request),以及蓝牙、USB、NFC 等硬件(能力)。每个条目的兼容性表给出逐浏览器、逐系统的支持情况与核验日期;iOS Safari 那一行同样覆盖 iOS 上的 Chrome、Edge 与 Firefox,它们在那里内嵌 WebKit。每项功能用三列记录,分别填 Web 等价物、缺失的平台,以及你准备在这些平台提供的回退。某项功能没有可接受的回退方案,就需要在那个平台保留原生构建,并把理由记在清单中。

两个文件把站点变成可安装应用。manifest 提供身份与启动元数据;按 MDN 可安装性指南,Chromium 浏览器要求填写 name 或 short_name,以及 start_url 与 display。icons 需要含 192 px 和 512 px 两项。

{
"id": "/",
"name": "Field Notes",
"short_name": "Notes",
"start_url": "/?source=pwa",
"scope": "/",
"display": "standalone",
"theme_color": "#1f4e79",
"background_color": "#ffffff",
"icons": [
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}

Service Worker 从页面注册,让应用壳在离线时仍然可用,这是原生用户习以为常的行为。注册前先检测特性,没有该 API 的浏览器仍能加载页面。

if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('/sw.js').catch((error) => {
console.error('Service worker registration failed:', error);
});
}

/sw.js 本身在 install 阶段预缓存应用壳,在 fetch 阶段从缓存应答;入门里有一份可直接复制的完整 worker。manifest 与 Service Worker 彼此独立。桌面版 Firefox 运行 Service Worker,却不从 manifest 安装(MDN 原文为 “Firefox does not support installing PWAs using a manifest file”),所以要在各自的兼容性条目上分别核实。

商店用户习惯单一的安装路径;PWA 的安装因系统而异,迁移页面必须说清楚。MDN 的安装指南列出了各系统的流程。桌面版 Chrome 与 Edge 在页面合格时于地址栏显示安装图标;移动浏览器把命令放在浏览器菜单里;iOS 上的 Safari 通过 “Add to Home Screen” 界面安装,自 iOS 16.4 起 Chrome、Edge、Firefox 与 Orion 的分享菜单也有该入口;macOS 14(Sonoma)上的 Safari 增加了 File > Add to Dock…。MDN 还指出已安装的 PWA 绑定于安装它的浏览器。先从 Edge 安装、再从 Chrome 安装的用户会得到两个副本。如果原生应用在过渡期内仍留在商店,就把它声明在 related_applications 中,并用 navigator.getInstalledRelatedApps()(仅限顶层安全上下文)对仍装着它的用户隐藏 Web 安装推广。

启动行为与原生应用一致。MDN 写道 “clicking on the application icon opens the PWA, even when the user is offline”,当 manifest 要求时会在没有浏览器界面的独立窗口中打开。删除是客服工单的来源,所以要按 MDN 指南逐系统写明。桌面上,已安装窗口的菜单提供卸载链接,Chrome 在 chrome://apps、Edge 在 edge://apps 列出已安装应用;大多数移动系统上,PWA 像普通应用一样从应用设置中卸载。