Bubblewrap打包PWA在Play商店安装后显示地址栏问题咨询

• 核对Play商店应用签名与assetlinks.json的SHA-256指纹
  本地通过bubblewrap install安装时使用的是调试签名，而Play商店发布的应用会使用Google管理的应用签名证书（而非你上传AAB时用的上传密钥）。
  操作步骤：

  1. 登录Play控制台，进入你的应用 → 应用完整性 → 应用签名证书
  2. 复制证书的SHA-256指纹
  3. 更新你的https://{your domain}/.well-known/assetlinks.json文件中sha256_cert_fingerprints字段的值为上述指纹
  4. 重新部署PWA静态资源到你的域名，再重新提交AAB到Play商店

• 验证assetlinks.json的格式与可访问性
  确保assetlinks.json完全符合规范：

  [{
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "你的TWA包名",
      "sha256_cert_fingerprints": ["Play商店应用签名的SHA-256指纹"]
    }
  }]
  

  额外检查：

  • 访问链接无HTTPS证书错误，无301/302重定向
  • 响应头Content-Type为application/json
  • JSON格式无语法错误（比如多余逗号、引号不匹配）

• 检查Web App Manifest配置
  确认你的manifest.json关键字段设置正确：

  • display: 必须设为standalone或fullscreen（browser/minimal-ui会显示地址栏）
  • start_url: 需为完整HTTPS路径，且与assetlinks中的域名一致（例如https://your-domain.com/）
  • scope: 覆盖所有应用路由，建议设为"/"

• 重新生成并提交正确的AAB

  1. 确认twa-manifest.json中display字段为standalone，url指向正确的HTTPS域名
  2. 执行bubblewrap build重新生成AAB
  3. 确保上传到Play商店的是最新构建的AAB文件，而非旧版本

• 等待Play商店缓存生效
  Play商店会缓存TWA的验证结果和配置，提交更新后可能需要2-24小时才能完全生效。可以尝试：

  • 清除设备上Play商店的缓存与数据
  • 使用未安装过该应用的新设备测试

• 检查设备环境
  确保设备上的Chrome浏览器和Android System WebView为最新版本，旧版本可能存在TWA显示逻辑的兼容性问题。

内容的提问来源于stack exchange，提问作者user20364818