Web App Manifest 不直接决定安装成败，需清单合规、浏览器支持与环境配合；Android 依赖 manifest 实现 PWA 安装，iOS 仅识别 apple-touch-icon 等 meta 标签，二者互不兼容，须双端分别配置。
Web App Manifest 本身不直接决定安装能否成功，它只是告诉浏览器“这个网站可以像App一样安装”，真正能否在 Android 和 iOS 上顺利安装并表现良好，得靠清单内容合规 + 浏览器支持 + 运行环境配合。测试重点不是“有没有 manifest.json”，而是“它有没有被正确读取、解析，并触发对应平台的安装行为”。
Android 上安装表现测试要点
Chrome for Android 是目前对 PWA 安装支持最完整的移动浏览器，测试需围绕它的行为展开：
-
确认 manifest 已加载且无报错：打开 Chrome DevTools → Application 标签页 → Manifest，查看是否显示解析后的 name、icons、start_url 等字段；若显示“Failed to load manifest”或为空，说明 link 标签路径错误、MIME 类型不对（服务器需返回
application/manifest+json），或 JSON 语法有误。 -
验证安装触发条件是否满足：Chrome 要求页面满足“可安装性标准”——已注册有效的 Service Worker、有 HTTPS、manifest 包含
short_name或name、至少一个192x192PNG 图标、display设为standalone或minimal-ui。可用 Lighthouse 的 PWA 审查项快速验证。 -
观察安装入口是否出现：在地址栏右侧或菜单中查找“添加到主屏幕”选项；也可监听
beforeinstallprompt事件，用 JS 捕获并自定义按钮——若事件没触发，大概率是上述条件未全部满足。 -
安装后检查实际效果：安装成功后，点击主屏幕图标启动，应无地址栏、以独立窗口运行（
display: standalone）、使用 manifest 中指定的图标和名称；长按图标应能卸载，且卸载后不残留缓存或 Service Worker（除非代码显式保留）。
iOS 上安装表现测试要点
iOS 对 Web App Manifest 的支持非常有限，Safari 不识别 manifest.json，也不支持“添加到主屏幕”作为 PWA 安装流程。它只认 <link rel="apple-touch-icon">，且行为更接近书签而非应用：
-
不依赖 manifest 实现“类安装”：iOS 用户通过 Safari 的分享菜单 → “添加到主屏幕”，此时系统仅读取
apple-touch-icon（推荐提供180×180PNG）和页面<title></title>，不会读取 manifest 中的name、short_name或icons数组。 -
测试图标是否正确显示：确保 HTML 中有类似
<link rel="apple-touch-icon" href="/icon-180.png" sizes="180x180">的声明；添加到主屏幕后，图标应清晰无拉伸、无默认遮罩（加precomposed可避免 iOS 自动加高光）。 -
检查启动体验是否接近原生：添加后启动，可通过
<meta name="apple-mobile-web-app-capable" content="yes">隐藏 Safari UI，用<meta name="apple-mobile-web-app-status-bar-style" content="black">控制状态栏；但注意：没有 Service Worker 缓存控制时，离线即白屏，也无法实现后台同步等 PWA 特性。 -
不期望 iOS 出现 install prompt：不要在 iOS 上监听
beforeinstallprompt或展示“安装”按钮——该事件在 Safari 中永远不会触发，强行调用会静默失败。
跨平台通用验证手段
无论 Android 还是 iOS，有些基础检查必须同步做：
-
HTTP 状态与响应头：访问
/manifest.json应返回 200，且响应头包含Content-Type: application/manifest+json；若返回 404、302 或 MIME 错误，所有平台都会忽略它。 -
图标路径有效性：manifest 中每个
icons.src都要手动访问一遍，确保返回 200 且是真实图片（尤其注意相对路径是否因start_url或scope导致 404）。 - start_url 可访问性：该 URL 必须能直接加载（最好返回 HTML 页面），且应在 Service Worker 的缓存策略中被包含；否则 Android 安装后首次启动可能失败或跳转异常。
-
用 web.dev 提供的在线检测工具：输入网址，它会模拟 Chrome 的安装检查逻辑，明确指出缺失哪项（如缺少 512×512 图标、
display值不合法等），比人工排查更快。
不复杂但容易忽略的是：Android 看 manifest，iOS 看 meta 标签，两者互不兼容。想覆盖双端，就得同时配好 manifest.json 和 apple-touch-icon 系列标签，不能只靠一份文件打天下。
