跳转到内容

平台

macOS 上的 Safari PWA(Dock 应用)

发布于

Safari 可以把打开的网站添加到 Dock,让你在独立窗口中启动它。这个功能从 macOS Sonoma(14)配合 Safari 17(2023-09)开始提供,适用于任何网站。窗口使用精简工具栏,Cookie 和网站数据独立存储,支持 Service Worker、Web Push、通知和角标。Web 应用 manifest 控制 Dock 应用的名称和显示方式。

Safari 用当前页面创建 Web 应用,有 manifest 就读取,没有也能创建。用户需要手动发起这个流程,网站无法代为发起。

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 时,Safari 17 会读取 display、name、theme_color 和 start_url,控制应用如何显示和启动,见 Safari 17.0 功能说明。

没有 manifest 也能打开 Web 应用窗口,名称取自页面标题,图标取自网站。用户之后可以在应用自己的设置窗口中覆盖这两项,该窗口还提供 Show navigation controls(前进、后退、共享和扩展按钮)与 Show color in title bar 两个选项。

创建时 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 角标,窗口标题是下一个最显眼的位置。

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 可以把页面交还给浏览器。

规范

规范状态
无。