PWA增强安装UI仅显示首张窄屏截图问题求助
增强安装UI(Richer install UI)截图显示异常求助
我的manifest.json中截图配置如下:
"screenshots": [ { "src": "screenshot/mobile/iphone14.png", "form_factor": "narrow", "sizes": "1290x2796", "type": "image/png", "label": "iPhone 14 Pro max SS" }, { "src": "screenshot/mobile/pixel7.png", "form_factor": "narrow", "sizes": "1105x1748", "type": "image/png", "label": "Pixel 7" }, ]
问题描述
增强安装UI仅显示首张iPhone截图,第二张Pixel截图无法显示;但Google控制台的应用页面能正常展示两张截图。
排查解决建议
- 修正JSON语法错误:截图数组最后一个对象末尾多了一个逗号(
},]),虽然部分解析器能兼容,但严格的JSON解析可能会忽略后续条目,建议删除多余逗号,确保语法完全合规。 - 验证图片路径与文件完整性:确认
pixel7.png文件确实存在于指定的screenshot/mobile/目录下,文件名大小写和manifest配置一致(部分服务器环境对文件名大小写敏感)。 - 检查截图尺寸合规性:Richer install UI对截图尺寸有明确要求,虽然控制台能显示,但1105x1748的尺寸可能不符合窄屏设备的推荐比例(推荐窄屏截图为1280x1920或同比例的尺寸),建议调整图片尺寸至官方推荐范围后重新提交。
- 刷新缓存并重新测试:控制台显示正常但安装UI异常,大概率是CDN缓存未同步,修正配置后重新提交应用包,等待2-4小时后再测试安装UI的显示效果。
内容的提问来源于stack exchange,提问作者Mlhkrtss
相关产品推荐
相关产品推荐

