平台
macOS 上的 Safari PWA(Dock 应用)
发布于
Safari 可以把打开的网站添加到 Dock,让你在独立窗口中启动它。这个功能从 macOS Sonoma(14)配合 Safari 17(2023-09)开始提供,适用于任何网站。窗口使用精简工具栏,Cookie 和网站数据独立存储,支持 Service Worker、Web Push、通知和角标。Web 应用 manifest 控制 Dock 应用的名称和显示方式。
工作原理
链接到“工作原理”一节Safari 用当前页面创建 Web 应用,有 manifest 就读取,没有也能创建。用户需要手动发起这个流程,网站无法代为发起。
Add to Dock
链接到“Add to Dock”一节Apple 支持文章 Use Safari web apps on Mac(需要 macOS Sonoma 14 或更高版本)给出路径(英文界面):打开网站后,在菜单栏选择 File > Add to Dock,或点按 Share 按钮并选择 Add to Dock;按需修改名称,点按 Add。Safari 把应用写入用户个人文件夹内的 Applications 文件夹,可从 Dock、启动台或聚焦搜索启动。移除它的方式是在访达中通过 Go > Home > Applications 把该应用拖到废纸篓。
manifest 控制什么
链接到“manifest 控制什么”一节有 manifest 时,Safari 17 会读取 display、name、theme_color 和 start_url,控制应用如何显示和启动,见 Safari 17.0 功能说明。
没有 manifest 也能打开 Web 应用窗口,名称取自页面标题,图标取自网站。用户之后可以在应用自己的设置窗口中覆盖这两项,该窗口还提供 Show navigation controls(前进、后退、共享和扩展按钮)与 Show color in title bar 两个选项。
数据、Cookie 与扩展
链接到“数据、Cookie 与扩展”一节创建时 Safari 会把网站的 Cookie 复制到新应用中,因此可以保留 Cookie 登录状态;其他存储一律不复制,此后该应用不再与 Safari 共享任何历史记录、Cookie、网站数据或设置,类似一个独立的 Safari 描述文件。Safari 扩展可以在各 Web 应用的设置中单独开启。Dock 应用按源使用 WebKit 浏览器应用配额,在 macOS 14 及之后约为磁盘容量的 60%。存储按尽力而为原则淘汰,规则与 Safari 相同。
通知、推送与角标
链接到“通知、推送与角标”一节Dock 应用可以使用 Web Push、Notifications API、Service Worker 和 Badging API。只有在 Web 应用内部(而非 Safari 中)授予的通知权限才会启用 Dock 图标上的红色未读角标,应用会以自己的名称出现在 System Settings > Notifications 中。通过 window.pushManager 订阅、无需 Service Worker 的声明式 Web Push,随 macOS 15.5 登陆 Mac,见 WebKit 公告。
Dock 应用和 Safari 标签页运行同一份代码。调用 API 前,先检测所在环境是否支持。
只在 API 存在且应用已安装时设置角标
链接到“只在 API 存在且应用已安装时设置角标”一节setAppBadge() 在 Dock 应用中存在、在 Safari 标签页中不存在;用户尚未允许通知时,应用会保存设置的计数,获准后再显示。
async function updateUnreadBadge(count) { const standalone = typeof window.matchMedia === 'function' && window.matchMedia('(display-mode: standalone)').matches;
if (!standalone || typeof navigator.setAppBadge !== 'function') { // Safari 标签页,或没有 Badging 的引擎:把计数放进页面标题。 document.title = count > 0 ? `(${count}) 收件箱` : '收件箱'; return; } if (count > 0) { await navigator.setAppBadge(count); } else { await navigator.clearAppBadge(); }}即使在应用内部也要保留页面标题的回退:拒绝了通知的用户看不到 Dock 角标,窗口标题是下一个最显眼的位置。
向 macOS 访客指出 File > Add to Dock
链接到“向 macOS 访客指出 File > Add to Dock”一节Safari 没有安装事件,需要网站自行显示安装提示。只在 macOS 14 及之后的 Safari 标签页中显示这条提示。
const isMacSafariTab = /Macintosh/.test(navigator.userAgent) && /Safari\//.test(navigator.userAgent) && !/Chrome\//.test(navigator.userAgent) && window.matchMedia('(display-mode: browser)').matches;
if (isMacSafariTab) { showHint('把本站添加到 Dock:File > Add to Dock');} else { hideHint();}User-Agent 嗅探分不出 Sonoma 和更早的 macOS。编写提示时,要考虑用户可能找不到这个菜单项。
实测行为
链接到“实测行为”一节Web 应用的设置窗口既是覆盖 manifest 选择的地方,也是两个工具栏开关所在的位置。
没有书签和标签页是有意为之:工具栏只提供后退、前进、共享和扩展按钮,Share > Open in Safari 可以把页面交还给浏览器。
另请参阅
链接到“另请参阅”一节- iOS 与 Safari 上的 PWA
- 桌面安装
- 角标
- Web Push
- Use Safari web apps on Mac(support.apple.com)
- WebKit Features in Safari 17.0(webkit.org)
- Meet Declarative Web Push(webkit.org)
规范
| 规范 | 状态 |
|---|---|
| 无。 | |