平台
桌面上的 PWA
发布于 更新于
桌面 PWA 通常在独立窗口中运行,安装后会出现在 Windows、macOS、Linux 和 ChromeOS 的应用列表里。从哪个浏览器安装,副本就归哪个浏览器管理。Chrome、Edge 和 Safari 各自负责安装、更新和卸载,彼此看不到对方的副本。
工作原理
链接到“工作原理”一节桌面安装由浏览器提供。即使用同一份 manifest,各浏览器的安装入口、窗口外观和卸载路径也不同。
各浏览器的安装支持
链接到“各浏览器的安装支持”一节Chrome 和 Edge 会在地址栏显示安装图标,条件是站点满足可安装性要求,且还没有从这个浏览器安装。点击图标后会出现确认框(Installing and uninstalling web apps,MDN)。英文界面的具体标签如下。
- Chrome 在地址栏右端提供 Install 按钮;或对任何页面(有没有 manifest 都行)用 More > Cast, save, and share > Install page as app…(Chrome 帮助)。
- Edge 在地址栏中显示 App available 图标,然后 Install;安装后的对话框提供 Pin to taskbar、Pin to Start 与 Auto-start on device login(Use Progressive Web Apps in Microsoft Edge,Microsoft Learn)。
- Safari 在 macOS 14(Sonoma)搭配 Safari 17 及之后可用 File > Add to Dock…,有没有 manifest 的站点都可以(WebKit,Safari 17.0);macOS 14 之前,Safari 是 macOS 上唯一不能安装的浏览器(MDN)。
- Firefox 桌面版没有由 manifest 驱动的安装;MDN 指向一个第三方扩展。
你得到的窗口
链接到“你得到的窗口”一节manifest 的 display 成员请求 fullscreen、standalone、minimal-ui 或 browser(缺省时为默认值)。不实现所请求模式的浏览器会沿回退链 fullscreen → standalone → minimal-ui → browser 下降,可能出于安全原因覆盖该模式,也可能让用户自行切换(Manifest display,MDN)。standalone 给出一个没有地址栏的系统窗口;它仍运行在执行安装的浏览器的引擎上,Edge 的应用菜单会列出浏览器已安装的扩展(Microsoft Learn)。Chrome 与 Edge 105 加入了 "display_override": ["window-controls-overlay"],它去掉标题栏并让页面绘制到标题栏区域,仅限桌面操作系统(Customize the window controls overlay of your PWA’s title bar,web.dev)。
{ "name": "HackerWeb", "short_name": "HackerWeb", "start_url": "/index.html", "display": "standalone", "background_color": "white", "icons": [{ "src": "images/icons/homescreen192.png", "sizes": "192x192", "type": "image/png" }]}每个浏览器一份副本
链接到“每个浏览器一份副本”一节安装属于执行安装的浏览器。先从 Edge 安装同一个站点,再从 Chrome 安装,你会得到两个应用,各自放在该浏览器在操作系统应用目录下的专属文件夹里,Cookie、存储与 Service Worker 互不共享;Edge 会提示打开它的副本,而 Chrome 继续提示安装(MDN)。管理页面也按浏览器分开,Edge 用 edge://apps,Chrome 用 chrome://apps。在 Chrome 应用窗口内卸载,依次选择 More > Uninstall [app name] > Remove(Chrome 帮助)。
桌面上的 manifest 更新
链接到“桌面上的 manifest 更新”一节桌面版 Chrome 在应用启动时,如果浏览器启动以来或最近 24 小时内没有检查过,就会重新拉取 manifest;name、short_name、display、scope、shortcuts、start_url(仅当 manifest 设有 id)、theme_color 或 file_handlers 的变化会在所有应用窗口关闭后应用;web.dev 称桌面上暂不应用 icons 的变化,而 Chrome 帮助描述了「App update available」提示,用户可以对名称或图标的变化选择接受、忽略或卸载,所以用户能把任何一项拦下来。已把应用切换为在标签页中打开的用户,在 display 变化后也保留自己的选择(How Chrome handles updates to the web app manifest,web.dev)。Chrome 85 起可用的 chrome://web-app-internals 列出已安装应用的 manifest 状态与上次更新检查时间。
两段代码读取的都是浏览器实际应用的模式,它可能与 manifest 请求的不同。
在脚本中按实际显示模式分支
链接到“在脚本中按实际显示模式分支”一节Window.matchMedia() 求值 display-mode 媒体特性,它反映的是正在使用的模式,而非请求的模式(display-mode,MDN)。
function isStandaloneDisplayMode() { if (!('matchMedia' in window)) { return false; // 不支持媒体查询:读不到显示模式 } return window.matchMedia('(display-mode: standalone)').matches;}
if (isStandaloneDisplayMode()) { document.querySelector('#install-banner').hidden = true;} else { document.querySelector('#install-banner').hidden = false;}回退分支保持安装横幅可见,因为没有 matchMedia 的浏览器根本报不出显示模式。这个检查只匹配 standalone,如果页面请求的是 minimal-ui 或 window-controls-overlay,查询里也要加上这些模式。
用 CSS 为独立窗口设置样式
链接到“用 CSS 为独立窗口设置样式”一节同一个媒体特性不需要脚本也能用,适合设置仅在没有地址栏时才需要的间距。
@media (display-mode: standalone) { body { padding-top: env(titlebar-area-height, 0px); }}env(titlebar-area-height) 只在 window controls overlay 下有定义;0px 默认值让这条规则在普通 standalone 下不产生影响。
实测行为
链接到“实测行为”一节在 Chrome 中,由浏览器自己的卸载对话框决定是否同时删除站点数据。
Edge 的对应入口在 edge://apps(Details > Uninstall),会提示是否一并删除应用历史与数据(Microsoft 支持)。PWA 如果保存了状态,重新安装后可能会接着使用原有数据,不能按首次运行处理。
另请参阅
链接到“另请参阅”一节- Installing and uninstalling web apps(developer.mozilla.org)
- Use Progressive Web Apps in Microsoft Edge(learn.microsoft.com)
- How Chrome handles updates to the web app manifest(web.dev)
- 桌面端 PWA 安装:Chrome、Edge 及更多
- Manifest display:standalone 与 fullscreen
- display_override:选用 window-controls-overlay 与 tabbed 模式
- Windows 上的 PWA
- macOS 上的 Safari PWA(Dock 应用)
- 国内厂商浏览器
规范
| 规范 | 状态 |
|---|---|
| 无。 | |