Flutter Android发布版APK更新时出现包冲突问题求助

1. 核对Flavor对应的最终包名 #

虽然你确认了命名空间未改动，但添加flavors后，build.gradle中可能为prod flavor设置了applicationIdSuffix，导致最终包名和旧版本不一致。执行以下命令查看新版本APK的实际包名，和旧版本APK的包名做完全对比：

aapt dump badging app-prod-release.apk | grep "package:"

2. 彻底验证签名一致性 #

即便keystore文件未变，也要确认流水线构建时确实用了正确的签名配置：

• 检查流水线中keystore的路径、密钥别名、密码是否和旧版本构建配置完全一致，避免误使用debug签名或其他keystore
• 用命令查看新旧APK的签名指纹，确保哈希值完全相同：

apksigner verify --verbose app-prod-release.apk

3. 确认版本号符合升级规则 #

Android系统要求新版本的versionCode必须大于旧版本，否则会判定为降级，触发安装冲突：

• 检查pubspec.yaml中的version字段，确保新版本的数字部分（比如1.0.2+3中的3）比旧版本高
• 排查build.gradle是否针对prod flavor单独设置了versionCode，避免出现版本号倒退的情况

4. 排查Flutter/Gradle升级带来的APK结构变化 #

升级依赖后可能触发了默认配置变更：

• 检查build.gradle中的splits配置，若新版本启用了splitPerAbi生成分ABI的APK，而旧版本是通用APK，可能因ABI不兼容导致冲突。可暂时关闭ABI拆分，构建通用APK测试
• 对比新旧APK的解压结构，重点查看解析后的AndroidManifest.xml，确认权限、组件声明等关键配置无冲突性变更

5. 检查流水线构建命令的正确性 #

添加flavors后，构建命令需明确指定flavor参数，避免构建出错误的包：

• 确认流水线中使用的构建命令是flutter build apk --flavor prod --release，而非未指定flavor的默认命令
• 检查构建输出的APK是否为release版本，debug版本的签名和release版本不兼容，必然导致安装冲突

6. 核对App Center的发布配置 #

• 确认新版本发布到了App Center中同一个应用条目下，避免误发布到其他包名不同的应用
• 检查App Center的分发规则，确保用户下载到的APK是预期的prod flavor版本

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