PWA桌面快捷方式需配置manifest.json、注册Service Worker、满足HTTPS等安装条件，再通过浏览器自动提示或手动添加实现。
如果您希望将 HTML5 网页以桌面应用程序形式运行，PWA（Progressive Web App）技术可实现将网页封装为具备离线能力、推送通知和桌面快捷方式的本地化体验。以下是制作 PWA 桌面快捷方式的具体操作步骤：
一、配置 manifest.json 文件
manifest.json 是 PWA 的核心元数据文件，用于定义应用名称、图标、启动方式及显示模式等，浏览器据此生成桌面快捷方式。
1、在网站根目录下创建名为 manifest.json 的文件。
2、写入标准 JSON 内容，确保包含 name、short_name、icons（至少提供 192×192 和 512×512 PNG 图标）、start_url、display（推荐设为 standalone 或 fullscreen）字段。
立即学习“前端免费学习笔记（深入）”；
3、在 HTML 页面的 <head> 中添加链接标签：<link rel="manifest" href="/manifest.json">。
二、注册 Service Worker
Service Worker 是 PWA 实现离线缓存与后台控制的基础脚本，必须成功注册才能触发“添加到桌面”提示。
1、在网站根目录下创建 sw.js 文件，并编写基础缓存逻辑（如监听 install 和 fetch 事件）。
2、在页面 JavaScript 中检查浏览器支持性后注册：调用 navigator.serviceWorker.register('/sw.js')。
3、确保 sw.js 文件通过 HTTPS 提供（本地开发可使用 localhost），否则注册失败。
三、满足安装条件并触发提示
现代浏览器仅在满足特定条件时才允许用户将网页添加至桌面，需同时满足安全性、功能性和用户体验要求。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
1、站点必须通过 HTTPS（或 localhost）提供服务。
2、manifest.json 中的 display 字段值必须为 standalone、fullscreen 或 minimal-ui。
3、页面需具备可交互内容，且无严重加载错误；首次访问后需等待约 30 秒，部分浏览器（如 Chrome）会自动弹出“添加到桌面”提示。
四、手动添加桌面快捷方式（备用方案）
当自动提示未出现时，用户可通过浏览器 UI 手动完成安装，该方式不依赖自动提示逻辑，适用于所有已满足基本 PWA 要求的页面。
1、在 Chrome 浏览器中打开目标网页。
2、点击地址栏右侧的 +（添加）图标，若图标不可见，请先点击三点菜单 → “安装 [网站名]”。
3、确认安装后，系统将在桌面及开始菜单（Windows）或 Launchpad（macOS）生成独立快捷方式，启动时无地址栏和导航控件。
五、验证 PWA 安装状态与图标显示
安装完成后需验证快捷方式是否正确加载 manifest 配置，尤其图标与启动行为是否符合预期。
1、右键桌面快捷方式 → 属性，检查目标路径是否指向浏览器启动命令并携带 --app-id=xxx 参数（Chrome）。
2、启动快捷方式，观察窗口是否以纯应用形态运行（无 URL 栏、无标签页样式）。
3、检查桌面图标是否显示 manifest 中指定的 icons 对应尺寸图像，若显示默认浏览器图标，说明 icon 路径错误或格式不被识别。
