Bubblewrap构建TWA时未自动生成assetlinks.json的问题咨询

一、先排查配置环节的关键遗漏 #

1. 初始化时的域名配置
   运行bubblewrap init时，必须准确填写你要关联的Web App域名，且该域名需先通过Google Search Console验证（使用Play签名的场景必须完成此步骤）。如果初始化时域名填错或未验证，Bubblewrap无法生成正确的assetlinks。

   • 可重新初始化项目：执行bubblewrap init --force，仔细核对host字段的域名是否正确。

2. 签名信息的正确性

   • 本地调试签名：运行bubblewrap build前，需确保已通过bubblewrap update或初始化步骤，正确配置本地密钥库的路径、密钥别名和密码。Bubblewrap需要读取签名证书的SHA-256指纹才能生成assetlinks。
     • 手动核对指纹：执行keytool -list -v -keystore <你的密钥库路径> -alias <密钥别名>，确认输出的SHA-256指纹无误。
   • Google Play应用签名：如果使用Play控制台的应用签名，一定要填写Play提供的应用签名证书SHA-256指纹，而非你上传密钥的指纹。很多人混淆这两个指纹，直接导致生成失败。

二、自动生成失败？手动创建兜底 #

若自动生成始终无法成功，可直接手动创建assetlinks.json：

1. 准备两个关键信息：
   • TWA应用包名（例如com.yourname.twaapp）
   • 签名证书的SHA-256指纹（对应你使用的签名方式，本地密钥或Play应用签名均可）
2. 按以下格式创建文件：

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

3. 将文件上传至Web App域名的/.well-known/目录下（例如https://yourdomain.com/.well-known/assetlinks.json），确保可通过HTTPS正常访问。

三、验证配置是否生效 #

无论自动还是手动生成，都可通过以下方式验证：

• 执行bubblewrap validate，检查TWA配置和assetlinks的有效性。
• 访问Google验证接口（替换为你的域名）：https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://<你的域名>&relation=delegate_permission/common.handle_all_urls，确认返回信息与你的应用包名、指纹匹配。

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