工具介绍
PWA Manifest 生成器可以帮你快速生成 Progressive Web App 所需的 manifest.json 配置文件,以及 HTML 页面中需要添加的引用代码。你只需要填写基本信息、添加不同尺寸的应用图标,即可一键生成符合规范的配置文件。
使用方法
- 填写应用的基本信息:名称、短名称、描述、起始地址、作用范围等
- 选择显示模式和屏幕方向偏好
- 设置主题颜色和启动背景颜色
- 添加应用图标,至少需要填写 192x192 和 512x512 两个尺寸的图标地址
- 点击「生成 Manifest」按钮,获取生成的 manifest.json 代码和 HTML 引用代码
- 将生成的 manifest.json 文件保存到你的网站根目录,再将引用代码添加到 HTML 页面的 <head> 标签中
字段说明
| 字段 | 说明 |
|---|---|
| name | 应用的完整名称,会在安装提示等位置显示 |
| short_name | 应用的短名称,主要用于手机主屏幕上显示 |
| description | 应用功能的描述说明 |
| start_url | 用户打开应用时默认加载的起始地址 |
| scope | PWA 应用的导航作用范围,控制哪些页面可以被当作 PWA 打开 |
| display | 显示模式:standalone 会让应用像独立应用一样运行,不显示浏览器地址栏;fullscreen 全屏显示;browser 正常浏览器模式显示 |
| orientation | 默认屏幕方向,可以设置为任意、竖屏或横屏 |
| theme_color | 浏览器地址栏等系统 UI 的主题颜色 |
| background_color | 应用启动画面的背景颜色 |
| icons | 应用图标数组,需要提供不同尺寸对应不同使用场景 |
注意事项
- 图标地址需要填写可访问的地址,可以是相对路径(如 /icons/icon-192x192.png)也可以是完整 URL
- 为了适配不同设备,建议至少提供 192x192 和 512x512 两个尺寸的图标
- manifest.json 文件需要放在你的网站根目录,并且配置正确的 MIME 类型(application/manifest+json)
- 如果你的网站使用 HTTPS 协议,配置正确的 Manifest 后,移动端浏览器会提示用户可以将 PWA 添加到主屏幕