平台
ChromeOS 上的 PWA(启动器与置顶栏)
发布于 更新于
ChromeOS 会把已安装的 PWA 列在启动器中,与 Android、Linux 应用放在一起,你也可以把它固定到置顶栏。PWA 使用与 Windows、macOS、Linux 版 Chrome 相同的 manifest 成员和能力 API,给置顶栏图标加角标、使用 Web Share 和 Share Target、处理文件,以及设置右键快捷方式。
工作原理
链接到“工作原理”一节ChromeOS 运行的就是桌面版 Chrome,所以安装路径和安装后的窗口都是 Chrome 的;ChromeOS 增加的是应用安装后出现在哪里,以及它能接入哪些系统界面(启动器、置顶栏、「打开方式」列表、分享面板)。
从 Chrome 安装
链接到“从 Chrome 安装”一节Google 的 ChromeOS 开发者文档要求 manifest 提供名称、图标、start_url 与 display 模式,并有一个处理 fetch 且能在离线时提供 start_url 的 Service Worker(Powerful PWAs,developers.google.com)。满足之后,Chromebook 上的 Chrome 提供与其他桌面平台相同的两条路径(英文界面):符合条件的站点在地址栏右端显示 Install 按钮,或者三点 More 菜单,然后 Cast, save, and share,再 Install page as app…(Chrome 帮助)。用 Google 的原话,安装后的应用会出现在「along-side other installed apps, like in the taskbar, launcher, desktop, and app switcher」;在 ChromeOS 上,taskbar 指的就是置顶栏。
ChromeOS 上的能力支持
链接到“ChromeOS 上的能力支持”一节这些集成功能各有对应的 manifest 成员或 API,在 ChromeOS 上的发布时间也不同。
- 已安装应用调用
navigator.setAppBadge(),按 chromeos.dev 的描述,会在置顶栏图标上画出「a small circle on the app’s home icon」。 navigator.share()在任何标签页中都能打开 ChromeOS 分享面板;share_target成员则把已安装应用注册为接收方,接收其他应用分享的链接、文本或文件。chromeos.dev 建议action页面要能离线工作,这样分享不会因为没有网络而失败。file_handlers成员让已安装应用出现在 ChromeOS 的「Open with…」列表中,对应声明的 MIME 类型与扩展名;Chrome 102 与 Edge 102 在包括 ChromeOS 的桌面平台上提供该成员(File Handling API,developer.chrome.com)。文件通过window.launchQueue送达。shortcuts成员填充启动器与置顶栏中图标的右键菜单。- 从 Chrome 96 起,manifest 的
id成员独立于start_url标识应用,同一个源下的两个 PWA 只要 manifest 的id不同就能共存(chromeos.dev,2022-05-23)。
Google 的页面明确写道,一项在 Windows 或 macOS 版 Chrome 中已稳定的能力,要在 ChromeOS 上达到稳定支持「can sometimes be a multi-year process」,所以关于 ChromeOS 的结论要在 ChromeOS 上验证。
角标与文件处理是分别发布的,也要分别检测;一项通过不代表另一项可用。
只在有角标的地方给置顶栏图标加角标
链接到“只在有角标的地方给置顶栏图标加角标”一节给已安装的 ChromeOS 应用设置角标前,先检测 setAppBadge。Firefox 没有实现,browser-compat-data 也没有记录 Android 版 Chrome 的支持(badging-api 数据集,BCD api.Navigator.setAppBadge)。
async function setLauncherBadge(count) { if (!('setAppBadge' in navigator)) { return false; // 这里没有角标界面:改为在应用内显示计数 } if (count > 0) { await navigator.setAppBadge(count); } else { await navigator.clearAppBadge(); } return true;}函数没有设置角标时返回 false。调用方据此在应用内显示计数,让不支持该 API 的浏览器也能传达这条信息。
从「Open with…」接收文件
链接到“从「Open with…」接收文件”一节file_handlers 成员只在应用安装后生效,launchQueue 也只存在于实现了该 API 的浏览器中,因此先检测支持,再注册处理器;不支持时回退到普通文件选择器。
if ('launchQueue' in window && 'files' in LaunchParams.prototype) { window.launchQueue.setConsumer(async (launchParams) => { if (!launchParams.files.length) return; for (const handle of launchParams.files) { const file = await handle.getFile(); openDocument(file); } });} else { document.querySelector('#open-file').hidden = false; // <input type="file"> 路径}'files' in LaunchParams.prototype 这个检测是 developer.chrome.com 给出的写法;只写 'launchQueue' in window 也会匹配那些把队列用于其他启动类型的浏览器。
实测行为
链接到“实测行为”一节在 Chromebook 上卸载 PWA 是启动器里的操作,其数据复选框的措辞与 Chrome 在 Windows、macOS 上显示的不同。
由于 ChromeOS 上的存储就是浏览器 profile 的存储,这个复选框也会一并删除该源的 Service Worker 注册与 Cache Storage,之后站点会以首次访问的状态加载。
另请参阅
链接到“另请参阅”一节- Powerful PWAs(developers.google.com)
- Features to take full advantage of PWA installation(chromeos.dev)
- File Handling API(developer.chrome.com)
- Manifest 文件处理程序(file_handlers)
- Manifest 快捷方式(shortcuts)
- Badging API:已安装 PWA 的应用图标徽标
- Chrome 与 Android 上的 PWA
- 桌面上的 PWA
规范
| 规范 | 状态 |
|---|---|
| 无。 | |