Manifest 截图与更丰富的安装 UI

一句话： screenshots 是推广图片数组，显示在更丰富的安装对话框中——在 Android Chrome 上，这些图片以可滚动轮播的形式出现在“添加到主屏幕”按钮上方，让用户在安装前先预览应用。若无截图，浏览器只显示包含图标和名称的简约安装提示。

语法

{
  "screenshots": [
    {
      "src": "/screenshots/home-mobile.png",
      "sizes": "390x844",
      "type": "image/png",
      "form_factor": "narrow",
      "label": "主屏幕，显示今日任务"
    },
    {
      "src": "/screenshots/dashboard-desktop.png",
      "sizes": "1280x800",
      "type": "image/png",
      "form_factor": "wide",
      "label": "仪表盘，显示分析概览"
    }
  ]
}

每个截图对象：

属性	是否必填	说明
src	是	图像 URL，相对于清单文件解析。
sizes	是	CSS 像素的 宽x高。
type	建议填写	MIME 类型：image/png、image/jpeg、image/webp。
form_factor	建议填写	"narrow"（移动端竖屏）或 "wide"（桌面端/平板横屏）。
label	建议填写	截图内容的无障碍描述。

form_factor

form_factor 告诉浏览器在哪类设备的安装提示上显示哪些截图：

• "narrow" — 在移动端（竖屏为主）安装提示上显示。
• "wide" — 在桌面端/平板（横屏为主）安装提示上显示。
• 省略 — 浏览器可能在任何设备类型上显示该截图。

为每种 form_factor 分别提供截图，可确保移动端用户看到移动端形态的预览，桌面端用户看到桌面形态的预览，从而提升安装转化率。

图像要求与建议

• 最小尺寸：任意边不小于 320 px。
• 最大尺寸：任意边不超过 3840 px。
• 宽高比：sizes 中的宽高比必须与实际图像一致，否则浏览器会跳过该截图。
• "narrow" 推荐：使用常见手机分辨率，如 390 × 844 或 375 × 812。
• "wide" 推荐：1280 × 800 或 1920 × 1080。
• 至少提供一张截图，以在 Android Chrome 上解锁“更丰富安装 UI”。

更丰富的安装 UI（Android Chrome）

当清单包含至少一张匹配 form_factor 或未设置 form_factor 的截图时，Android Chrome 会将安装底部弹窗升级为全屏高度的模态框，其中包含：

• 应用图标与名称。
• 可滚动的截图轮播。
• 安装按钮。

若无截图，Chrome 显示紧凑型底部弹窗。在 A/B 测试中，更丰富的 UI 持续提升安装率。

实践清单

• 至少提供一张截图，以解锁 Android 上更丰富的安装对话框。
• 截图使用与 sizes 值一致的正确宽高比。
• 移动端截图设置 form_factor: "narrow"，桌面端截图设置 form_factor: "wide"。
• 每张截图都有描述性的 label 以支持无障碍访问。
• 图像已优化（压缩 PNG 或 WebP）——这些是在安装时加载的推广素材，而非运行时资源。
• 截图展示的是真实应用界面，而非占位符或库存图片。