跳转到内容

平台

桌面上的 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 帮助)。

桌面版 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,查询里也要加上这些模式。

同一个媒体特性不需要脚本也能用,适合设置仅在没有地址栏时才需要的间距。

@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 如果保存了状态,重新安装后可能会接着使用原有数据,不能按首次运行处理。

规范

规范状态
无。