Flutter应用Google Play封闭测试版本设备兼容性异常求助

问题背景 #

• 初始版本（version code 1）：发布至Google Play内部测试，所有测试设备均可正常下载
• 升级版本（version code 2）：仅修改versionCode，源码无任何变更，上传至封闭测试后，部分原测试设备提示「该版本与您的设备不兼容」，少量设备可正常下载
• 已尝试无效操作：调整minSdkVersion/targetSdkVersion、重置Play Console上传密钥

排查步骤 #

1. 检查Google Play控制台的设备兼容性规则 #

• 进入Play Console → 目标应用 → 发布 → 封闭测试 → 对应版本详情
• 查看「设备兼容性」板块，确认是否误添加了设备排除规则（如特定品牌、型号、屏幕尺寸、CPU架构等）
• 对比version code 1和version code 2的兼容性报告，查看设备支持范围是否存在差异

2. 验证AAB文件的配置一致性 #

• 本地重新构建version code 2的AAB：

  flutter clean
  flutter build appbundle --release
  

• 检查android/app/build.gradle，确保以下参数与version code 1完全一致（仅versionCode除外）：
  • minSdkVersion
  • targetSdkVersion
  • compileSdkVersion
  • ndkVersion（若配置）
  • 第三方依赖库版本（避免构建时自动升级依赖）
• 使用bundletool分析特定设备的兼容性：

  # 生成测试设备的配置文件
  bundletool get-device-spec --output=device-spec.json
  # 验证AAB与该设备的兼容性
  bundletool validate --bundle=app-release.aab --device-spec=device-spec.json
  

3. 确认Play商店的版本发布状态 #

• 检查version code 2的封闭测试是否已完全发布（Play Console显示「已发布」而非「正在处理」）
• 排查是否开启了分阶段发布，导致部分设备未推送新版本
• 确认出现问题的测试设备仍在封闭测试的测试名单中，未被移除

4. 排查Flutter构建缓存与Manifest变更 #

• 彻底清理构建缓存后重新打包：

  flutter clean
  rm -rf android/.gradle
  flutter build appbundle --release
  

• 对比version code 1和version code 2的android/app/src/main/AndroidManifest.xml内容，确认无插件自动添加的权限、特性等变更

5. 清除测试设备的Play商店缓存 #

• 设备操作路径：设置 → 应用 → Google Play商店 → 存储 → 清除缓存/清除数据
• 重启设备后重新尝试下载，排除本地缓存导致的版本识别错误

6. 验证签名一致性 #

• 确认version code 2的AAB使用的签名密钥与version code 1完全一致
• 执行以下命令验证签名信息，对比两个版本的结果：

  jarsigner -verify -verbose -certs app-release.aab
  

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