安装中的平台
桌面端安装
发布于 更新于
桌面端安装让站点成为系统级应用,可以从启动器、任务栏或 Dock 打开,在独立窗口中运行。Chrome 73 与 Edge 79 在 Windows、macOS、Linux 与 ChromeOS 上通过地址栏、浏览器菜单或 beforeinstallprompt 安装;macOS 14 上的 Safari 17 通过 File › “Add to Dock” 安装;Windows 上的 Firefox 143 可以把站点固定为任务栏 web 应用,Microsoft Store 版除外(Firefox 143 发行说明);更早的桌面版 Firefox 没有内置安装(MDN 指向一个扩展),Safari 17 之前在 Mac 上也没有,而 Chromium 之外没有浏览器会触发 beforeinstallprompt(BCD api.BeforeInstallPromptEvent)。
工作原理
链接到“工作原理”一节可以从浏览器自带入口开始安装(Chrome 与 Edge 在满足可安装性条件后在地址栏右端显示安装图标,三点菜单中也有安装项;Safari 用 File › “Add to Dock”;Firefox 143 把站点固定到任务栏),也可以在 Chromium 中点击页面自己的按钮,调用先前保存的 BeforeInstallPromptEvent。mini-infobar 是移动端的东西(web.dev 示例代码的注释就写着 “Prevent the mini-infobar from appearing on mobile”),所以桌面端的页面没有现成的横幅需要压制。
用户接受后,浏览器写入一个系统启动器条目,应用无需先打开浏览器即可启动:
| 系统 | 浏览器创建什么 | 管理入口 |
|---|---|---|
| Windows(Chrome、Edge) | 开始菜单快捷方式;应用出现在任务栏与 Alt+Tab 中。Edge 还会把它登记到设置 › 应用 › “已安装的应用”。 | chrome://apps、edge://apps |
| macOS(Chrome、Edge) | ~/Applications/ 下浏览器专属文件夹(Chrome 为 Chrome Apps.localized/)中的应用包,图标出现在 Dock 里。 |
chrome://apps、edge://apps |
| macOS(Safari 17 及以后) | 一个可从 Dock、启动台与 Spotlight 打开的独立窗口应用;Safari 在安装时复制站点的 Cookie,之后不再共享其他网站数据。 | 从“应用程序”中删除 |
| Linux(Chrome、Edge) | 以用户模式安装的 .desktop 条目,默认位于 ~/.local/share/applications/,GNOME 与 KDE 启动器会读取。 |
chrome://apps、edge://apps |
| ChromeOS | 可固定到任务栏的启动器条目;经由 TWA 的 Play 商店上架是另一回事。 | 启动器 › 右键 › 卸载 |
Chrome 与 Edge 的窗口模式取自 manifest,而 Mac 上的 Safari 对任何添加的站点都以 web 应用打开,有没有 manifest 都一样。display: standalone 得到带系统标题栏、无浏览器界面的窗口;minimal-ui 加回后退、前进与刷新;display_override: ["window-controls-overlay"] 让页面绘制到标题栏区域,系统保留关闭、最小化与最大化按钮,并通过 env(titlebar-area-x)、env(titlebar-area-y)、env(titlebar-area-width) 与 env(titlebar-area-height) 暴露剩余区域(Chrome 105、Edge 105,仅桌面端)。应用名称与图标来自 name 与 icons;每次启动新开窗口还是聚焦已有窗口由 launch_handler.client_mode 决定。
与浏览器标签页相比,应用没有地址栏与标签栏(Edge 与 Firefox 143 在应用窗口里仍可使用已安装的扩展与附加组件),得到 Alt+Tab 或 Cmd+Tab 中独立的窗口、以应用名称与图标署名的系统通知、角标、文件与协议处理,以及从系统启动。Chrome 与 Edge 上 Cookie 与存储同安装它的浏览器配置文件共享,因此登录态会带过去;Safari 17 只在安装时复制 Cookie,存放在 Cookie 里的登录态会带过去,存在本地存储里的则不会。
实测行为
链接到“实测行为”一节安装产物在磁盘上可见,要确认某个浏览器到底做了什么,这样最直接。
页面不需要任何浏览器私有 API 就能判断自己是否以安装态运行、得到了哪种窗口模式。媒体查询报告的是浏览器实际应用的模式,当 display_override 列出多项时它可能与请求的不同。
const mode = ['window-controls-overlay', 'standalone', 'minimal-ui', 'fullscreen'] .find((m) => matchMedia(`(display-mode: ${m})`).matches) ?? 'browser';
if (mode !== 'browser') { installButton.hidden = true; // 已安装并以应用方式启动}if (mode === 'window-controls-overlay') { document.documentElement.classList.add('wco'); // 绘制到标题栏区域}另请参阅
链接到“另请参阅”一节- Installing and uninstalling web apps(developer.mozilla.org)
- Progressive Web Apps on Windows: the user experience(learn.microsoft.com)
- Firefox 143.0 release notes(mozilla.org)
- beforeinstallprompt 事件
- 可安装性条件
- 卸载已安装的 PWA
display_overridemanifest 成员- macOS Safari 上的 PWA
规范
| 规范 | 状态 |
|---|---|
| 无。 | |