为何部分Android设备安装应用后未配置已验证深度链接？

问题背景 #

深度链接https://clevelink.github.io/details可在Android 7的Galaxy S6和Android 13的Samsung A52实体设备上正常唤起目标应用（io.github.clevelink），但通过flutter run --release在Android 33的Pixel API 33模拟器安装发布版应用后，系统显示“0个已验证链接”，无法通过该深度链接唤起应用。

已完成的有效验证：

• assetlinks.json配置文件可正常访问
• Digital Asset Links API已确认该深度链接与目标应用的关联关系
• Play Console深度链接验证结果显示“所有链接正常，用户将直接跳转至您的应用”

可能原因及解决办法 #

1. 模拟器的Digital Asset Links缓存异常 #

Android 12及以上系统会缓存Digital Asset Links的验证结果，模拟器可能因缓存未更新导致验证失败。可尝试：

• 清除应用缓存与存储：进入模拟器设置 → 应用管理 → 找到目标应用 → 存储 → 清除缓存和数据
• 通过adb命令强制刷新权限关联：

  am set-delegate-permissions --package io.github.clevelink --web-domain clevelink.github.io
  

• 重启模拟器后重新安装发布版应用

2. 模拟器网络访问限制 #

部分模拟器可能无法正常访问Google的Digital Asset Links验证服务，导致验证流程中断：

• 确认模拟器网络连接正常，可通过浏览器访问外部测试地址验证网络可用性
• 切换模拟器的网络模式（如从Wi-Fi切换至模拟移动数据）

3. 应用签名不匹配 #

flutter run --release默认使用的签名可能与assetlinks.json中配置的签名指纹不一致，而Digital Asset Links验证依赖签名匹配：

• 检查模拟器上安装的发布版应用使用的签名指纹，确认与assetlinks.json中的配置一致
• 若使用调试签名测试，需将调试签名指纹添加到assetlinks.json中，或使用发布签名打包后再安装到模拟器

4. Android 13+权限缺失 #

Android 13（API 33）新增的QUERY_ALL_PACKAGES权限可能影响深度链接验证，需在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
    tools:ignore="QueryAllPackagesPermission" />

注：正式发布时若符合Play Store权限豁免条件，可移除该权限，但测试阶段可临时添加以验证问题。

5. 模拟器系统镜像版本问题 #

第三方或旧版本的模拟器镜像可能存在系统服务逻辑异常，导致验证失败：

• 更新模拟器系统镜像至最新官方版本
• 使用Google官方提供的Pixel模拟器镜像进行测试

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