跳转到内容

平台

三星 Internet 浏览器上的 PWA

发布于 更新于

三星 Internet 可以通过 Add shortcut on Home screen 菜单项安装 PWA。满足三星要求的网站还会显示 ambient badging 加号图标,要求包括 HTTPS、已注册的 Service Worker,以及把 display 设为 standalone 或 fullscreen 的 manifest。

三星文档分别记载了菜单和徽标两个安装入口,以及 DeX 上的桌面安装。

在 Android 版三星 Internet 中,打开浏览器菜单,选择 Add shortcut on Home screen(英文界面)。如果 manifest 声明了 icons 和 short_name,Progressive Web Apps 页面写明所选图标会和所选短名称一起出现在主屏幕上。Web App Manifest 支持自三星 Internet 4 起提供,Service Worker 以及 Push 与 Notification API 也是从 4 开始支持。

Ambient Badging 页面写明,浏览器会显示一个 “+” 符号表示网站可以安装,点按它会打开一个小菜单。列出的要求之一是 manifest 把 display 设为 standalone 或 fullscreen;保持默认 browser 显示的网站只有菜单项,没有徽标。Ambient badging 在三星 Internet 5.2 引入。

同一组文档指出,在 Samsung DeX 上运行的三星 Internet 中,Web 应用可以添加到桌面,接上显示器的 Galaxy 设备会从桌面以窗口形式启动应用,取代主屏幕图块。

三星的文档没有提到 beforeinstallprompt。MDN 的兼容性数据列出三星 Internet 4.0 支持该事件,与其 Chromium 内核一致,因此为 Chrome 自定义安装按钮写的代码预期可以运行;依赖它之前先在 Galaxy 设备上测试,因为三星自己的界面无论如何都可能显示徽标。

manifest 示例满足徽标要求。脚本无法检测徽标是否显示,只能检测应用是否以安装状态运行。

一份符合加号图标要求的 manifest

链接到“一份符合加号图标要求的 manifest”一节

徽标只取决于 display;手动添加后的主屏幕名称和图标由 short_name 和 icons 决定。

{
"name": "Field Notes",
"short_name": "Notes",
"start_url": "/",
"display": "standalone",
"icons": [{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }]
}

保持 short_name 简短。三星文档说明它会显示在主屏幕图标旁,Android 启动器会截断过长的名称。

不信任 fullscreen 地检测已安装窗口

链接到“不信任 fullscreen 地检测已安装窗口”一节

三星没有记载任何用于询问徽标是否正在显示的 API,页面只能得知自己已经以安装状态运行。(display-mode: fullscreen) 也会匹配调用了 Fullscreen API 的普通页面,所以这里只把 standalone 算作信号。

function isRunningInstalled() {
if (typeof window.matchMedia !== 'function') {
return false; // 无法查询:当作普通标签页
}
return window.matchMedia('(display-mode: standalone)').matches;
}
if (!isRunningInstalled()) {
// 指向浏览器菜单;没有文档记载的方式能从脚本打开它。
document.getElementById('install-hint').hidden = false;
}

为了徽标而声明 display: fullscreen 的网站在这里仍应检测 standalone:MDN 的 display-mode 页面写明,fullscreen 同样匹配由 Fullscreen API 置入全屏模式的页面。

三星给两个入口起了不同的名字,而其中只有一个由 manifest 驱动。

注册了 Service Worker 本身并不会为离线缓存任何内容;三星文档把它描述为一个可能从缓存返回响应的网络代理,离线行为只在 fetch 处理函数实现之后才出现。

国内厂商浏览器(华为、小米、OPPO、UC、QQ 浏览器)与微信内置 WebView 对安装、standalone、Service Worker 和 Web Push 的支持,与三星 Internet 并不一致,整理在国内厂商浏览器兼容性矩阵中,只依据厂商文档。

规范

规范状态
无。