Web App Manifest 不支持 screenshots 字段，应用商店也不读取该文件中的截图；TWA 上架 Google Play 需在 Play Console 上传指定尺寸的真实运行截图，iOS 添加到主屏幕仅依赖 apple-touch-icon 和启动画面，普通 PWA 不进应用商店。
Web App Manifest 本身不支持 screenshots 字段，也无法直接用于应用商店（如 Google Play、Apple App Store）的展示优化。
这是个常见误解：很多人看到“PWA 可安装”“能上桌面”，就以为它也能像原生 App 那样提交截图到应用商店。但事实是——
Manifest 是给浏览器和操作系统用的，不是给应用商店审核系统用的。目前所有主流应用商店（包括 Google Play 的 TWA、Apple 的 Web Clip）都不读取 manifest.json 中的截图字段，因为规范里根本不存在 screenshots。
那怎么让 PWA 在应用商店里有好截图？
答案取决于你是否真的把 PWA 上架到应用商店，以及走的是哪条路径：
✅ 如果你用的是「TWA（Trusted Web Activity）」上架 Google Play
Google Play 允许将符合标准的 PWA 封装为 Android App 提交，这时你需要的截图不在 manifest 里配，而是在 Play Console 后台上传：
- 要求尺寸（必须）：
- 横屏截图：1024×500 px（至少 2 张）
- 竖屏截图：1080×1920 px（至少 2 张，最多 8 张）
- 截图内容需真实反映用户首次打开、核心功能页、深色模式（如有）、离线状态等典型场景
- 不接受纯设计稿或 mockup，必须是运行中的实际页面截图（带状态栏/导航栏）
⚠️ 注意：TWA 要求你的 PWA 已部署在 HTTPS 域名下，且已配置合法的
assetlinks.json，否则无法通过审核。
✅ 如果你用的是「iOS 添加到主屏幕」（非 App Store）
Safari 不支持截图上传，也不展示应用商店式图库。用户看到的只有：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
-
<link rel="apple-touch-icon">图标（必须提供，建议 180×180 PNG） - 启动画面（由
splash_screen+background_color+theme_color配合生成，非截图）
iOS 不允许自定义首屏截图，所以所谓“商店展示”在这里不成立。
❌ 如果你只是普通 PWA（没封装、没上架）
那根本不会出现在任何应用商店里，自然也谈不上截图优化。用户只能通过“添加到主屏幕”或“安装此网站”使用，界面完全由 Manifest + Service Worker 控制。
实用建议：让截图更有说服力（即使不进商店）
虽然 manifest.json 不管截图，但你可以主动准备高质量截图，用于：
- 官网介绍页（增强可信度）
- 用户引导弹窗（比如首次访问时提示“可添加到桌面”，附截图示意）
- 社交分享卡片（配合 Open Graph 或 Twitter Card 标签）
做法很简单：
- 用 Chrome DevTools 的 Device Toolbar 模拟 iPhone/Android 尺寸
- 打开关键页面（首页、工具页、设置页），截取干净无地址栏的 full viewport 图
- 导出为 PNG，加上轻微阴影和设备边框（可用 Figma 或 Smartmockups 快速套壳）
总结一句话
screenshots 不是 Manifest 的配置项，也不是 PWA 自身能力的一部分；它是应用商店上架流程中的人工运营动作。想优化展示，重点不是改 JSON，而是按平台要求准备真实、清晰、有代表性的运行截图，并确保你的 PWA 本身体验足够稳定、启动快、视觉一致。
