配置Digital Asset Link后TWA地址栏仍可见的技术求助

我们有一个托管在www.thredup.com的PWA，已打包为TWA（包名com.thredup.www.twa）发布至Google Play商店进行封闭测试。当前遇到的问题是：Digital Asset Link配置完成且经多方验证无误，但TWA中的地址栏仍处于可见状态。

已完成的验证操作 #

• 使用Google应用签名密钥的SHA256指纹配置了Digital Asset Link，对应文件路径为www.thredup.com/.well-known/assetlinks.json，内容如下：

{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.thredup.www.twa",
    "sha256_cert_fingerprints": ["B5:B4:0C:36:87:C1:1B:74:02:90:18:14:D8:52:F9:45:62:81:BC:F4:A1:AD:23:07:66:3E:2D:A0:06:10:99:1D"]
  }
}

• 安装TWA后，通过Android端Asset Links Tool应用验证，该包对应的Digital Asset Link配置完全一致
• 通过Google官方Digital Asset Link测试工具验证，www.thredup.com已向com.thredup.www.twa授予深度链接权限
• 目前仅能通过Chrome命令行禁用Digital Asset Link验证的方式，实现隐藏TWA地址栏的效果

核心疑问 #

1. 是否是Digital Asset Link存在隐性问题，导致地址栏无法隐藏？
2. 除配置Digital Asset Link外，还需要完成哪些操作才能隐藏地址栏？

问题分析与解决方案 #

1. Digital Asset Link的潜在问题排查

从已完成的验证来看，配置本身是合规有效的，但仍存在几种可能的隐性故障点：

• 缓存干扰：Chrome或系统可能缓存了旧的验证结果，建议清除Chrome站点数据，卸载并重装TWA后重试
• 签名一致性问题：确认发布到Play商店的TWA包，确实使用了配置中填写的Google应用签名密钥——若误传了以上传密钥签名的安装包，会导致验证不通过
• 域名严格匹配：确保TWA启动时加载的初始域名，与assetlinks.json所在域名完全一致（包括www前缀，不能存在跳转到无www域名的情况）

2. 隐藏地址栏的必要额外配置

除了正确配置Digital Asset Link，还需满足以下条件：

• PWA Manifest配置：你的PWA必须在Web App Manifest中设置display: standalone或display: fullscreen，且已被Chrome识别为合格的PWA
• TWA清单配置：在TWA的AndroidManifest.xml中需确保：
  • 指定的启动URL与assetlinks.json关联的域名完全一致
  • 使用最新版本的Android Browser支持库（如androidx.browser:browser）
• 站点HTTPS要求：PWA站点必须全程使用有效HTTPS证书，非HTTPS站点会被TWA强制显示地址栏
• 避免跨域跳转：TWA启动的初始页面不能重定向到未配置Digital Asset Link的其他域名，否则地址栏会重新显示

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