AZ Tools

PWA Manifest 构建器

开发

PWA manifest 告诉浏览器和操作系统如何安装和呈现你的 web app:启动图标、闪屏颜色、全屏 vs 浏览器 chrome、支持的方向、深链 scope。这个构建器生成符合规范的 `manifest.json`,包含你实际需要的字段,包括合理的默认图标集(192px 和 512px,带 Android 安全区域的 maskable 变体)。输出还包括 `<link rel="manifest">` 加上 Apple 特定的 `apple-mobile-web-app-*` meta 标签,因为 Apple 仍未实现完整的 manifest 支持,跨平台可安装性需要两者。一切可编辑;JSON 在你键入时重新生成。

图标
manifest.json
{
  "name": "My App",
  "short_name": "MyApp",
  "description": "A progressive web app",
  "start_url": "/",
  "scope": "/",
  "display": "standalone",
  "theme_color": "#0ea5e9",
  "background_color": "#ffffff",
  "lang": "en",
  "categories": [
    "productivity",
    "utilities"
  ],
  "icons": [
    {
      "src": "/icons/icon-192.png",
      "sizes": "192x192",
      "type": "image/png",
      "purpose": "any"
    },
    {
      "src": "/icons/icon-512.png",
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "any"
    }
  ]
}
HTML head (link + Apple meta)
<link rel="manifest" href="/manifest.json" />
<meta name="theme-color" content="#0ea5e9" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="default" />
<meta name="apple-mobile-web-app-title" content="MyApp" />
<link rel="apple-touch-icon" href="/icons/icon-180.png" />

用 `Content-Type: application/manifest+json` 提供 manifest.json。Lighthouse PWA 审计会标记缺失字段。

使用方法

  1. 设置 name + short_name(short_name 显示在主屏 — 保持 12 字符以下)。设置 start_url 为应用启动时打开的位置。
  2. 选 display 模式:`standalone`(无浏览器 UI,推荐)最常用。`fullscreen` 隐藏状态栏;`minimal-ui` 保留薄浏览器 shell。
  3. 添加图标。默认覆盖 Android(192/512)、自适应图标的 maskable 变体。把 JSON 复制到 `manifest.json`,HTML 复制到你的 `<head>`。

常见问题

什么是 maskable 图标?
Android 自适应图标将你的图标裁剪为系统定义的形状(圆、squircle、圆角方)。`purpose: maskable` 图标在 logo 周围包含安全区域 padding,所以裁剪不会切掉边缘。在 192/512 生成 logo 周围 ~20% padding 的 maskable 变体。
我需要 manifest.json 和 Apple meta 标签两者吗?
如果你想在 iOS 上 install-to-home-screen,是的。Apple 有部分 manifest 支持(theme_color、通过 `apple-touch-icon` 的图标)但忽略大多数。`apple-mobile-web-app-capable` meta 是实际让 iOS 把你站点视为独立应用的东西。

相关工具