29 lines
1.0 KiB
Markdown
29 lines
1.0 KiB
Markdown
# 萌芽笔记 PWA 说明
|
||
|
||
本前端已配置为 **PWA（渐进式 Web 应用）**，支持：
|
||
|
||
- **安装到桌面/主屏**：浏览器中可“安装应用”，像原生应用一样打开
|
||
- **离线可用**：静态资源与部分 API 会被缓存，弱网/离线时可继续使用
|
||
- **独立窗口**：安装后以独立窗口运行（无浏览器地址栏）
|
||
|
||
## 图标
|
||
|
||
请将应用图标放在 **`public/logo.png`**。建议尺寸：
|
||
|
||
- 至少 **192×192** 像素（用于主屏图标）
|
||
- 若有 **512×512** 像素，可同时用于启动画面等
|
||
|
||
若未放置 `logo.png`，PWA 仍可正常工作，但安装图标可能为默认或空白。
|
||
|
||
## 构建与部署
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
构建产物在 `dist/`，部署后通过 **HTTPS** 访问即可使用 PWA 能力（本地预览可用 `npm run preview`）。
|
||
|
||
## 开发时
|
||
|
||
`vite.config.js` 中已开启 `devOptions: { enabled: true }`，开发时也会注册 Service Worker，便于调试离线与安装行为。不需要时可改为 `enabled: false`。
|