返回 PWA 生成器

PWA install guide

PWA 安装页制作与发布检查指南

PWA 能不能安装,取决于一整条技术链路。按下面的顺序检查,比只改按钮文案更容易定位问题。

创建并检查安装页

发布前 7 项检查

1

HTTPS 与同源访问

页面、Manifest、Service Worker、图标和启动地址应通过 HTTPS 提供,并避免关键资源重定向到不受控域名。

2

Manifest 信息

确认 name、short_name、start_url、display、theme_color 和 background_color 与实际页面一致。

3

可用图标

至少准备 192×192 和 512×512 的 PNG 图标;图标地址必须能够直接访问并返回正确的图片类型。

4

Service Worker

Service Worker 应在正确 scope 下注册,并能处理启动页所需的基础资源。

5

启动地址

start_url 必须返回 200,不能跳到登录页、失效页面或不同来源。

6

设备实测

分别在 Android Chrome、Android Edge 与 iPhone Safari 上测试。不同系统不会显示完全相同的安装入口。

7

事件验证

如果配置广告像素,先用平台测试工具确认页面浏览、按钮点击和可用安装事件;不要把未触发事件当成转化。

能力边界

  • PWA 是可安装的 Web 体验,不等于原生 iOS 或 Android App。
  • iPhone 通常通过 Safari 分享菜单手动添加到主屏幕,不能依赖 Android 风格的安装提示。
  • 浏览器是否展示安装提示取决于设备、浏览器版本和安装条件,页面无法保证每次都弹出。
  • 像素只能记录浏览器实际暴露并成功触发的事件;发布前必须逐个平台验证。

用真实设备完成最后验证

生成页面后,从不同系统打开链接,核对图标、启动页、主屏入口和事件记录。

打开 PWA 安装页生成器