Skip to content

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

  1. 请求 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 等等。

查看术语表

动手做项目

通过引导式项目应用所学,含起始代码与解决方案。

查看项目

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误