PWA 可安装与推送通知深入
使 PWA 可安装(Web App Manifest)并启用推送通知(Push API)。
你将学到
- Web App Manifest:图标、显示模式、start_url
- 安装提示和 beforeinstallprompt 事件
- Push API 和通知订阅
- 通知显示和操作处理
概念讲解
PWA 可安装与推送通知深入
PWA 可安装到主屏幕并发送推送通知,使其感觉像原生应用。
Web App Manifest
manifest 是从 HTML 链接的 JSON 文件。定义 name、icons(192px+512px)、start_url、display、theme_color。可安装需 manifest + SW + HTTPS。
安装提示
满足条件时浏览器显示安装提示。拦截 beforeinstallprompt,保存它,显示自定义按钮。调用 prompt() 显示对话框。
Push API
- 请求 Notification 权限。2. 用 VAPID 密钥通过 PushManager.subscribe() 订阅。3. 服务器向端点发送推送。4. SW 接收 push 事件并显示通知。
通知处理
在 SW push 事件中调用 showNotification(title, options)。选项:body、icon、actions、tag。notificationclick 处理点击,通常打开 URL。
示例代码
const manifest = {name:'My App', short_name:'MyApp', icons:[{src:'/icon-192.png',sizes:'192x192'},{src:'/icon-512.png',sizes:'512x512'}], start_url:'/', display:'standalone', theme_color:'#3b82f6'};
console.log('Manifest:', JSON.stringify(manifest, null, 2));
let deferred = null;
window.addEventListener('beforeinstallprompt', e => { e.preventDefault(); deferred = e; console.log('Install ready'); });
async function installApp() { if (!deferred) return; deferred.prompt(); const {outcome} = await deferred.userChoice; console.log('Install:', outcome); deferred = null; }
self.addEventListener('push', e => { const d = e.data ? e.data.json() : {}; e.waitUntil(self.registration.showNotification(d.title||'Notification', {body: d.body||''})); });
console.log('PWA install and push defined');
manifest 定义应用元数据。beforeinstallprompt 被捕获用于自定义安装按钮。SW push 事件显示通知。
动手试一试
- JSON Formatter
Manifest 和推送载荷是 JSON——格式化和验证。
常见错误
错误写法
manifest 中不提供 512px 图标。
正确做法
可安装性需要 192px 和 512px 图标。缺任一则安装提示不出现。
错误写法
不发 userVisibleOnly: true 的推送。
正确做法
推送必须显示通知。浏览器不允许静默推送。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
动手做项目
通过引导式项目应用所学,含起始代码与解决方案。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。