Flutter Android应用无法通过Google Play更新问题求助

问题概述 #

本地使用上传密钥（keystore.jks）签名的旧版本APK（1.0.2+1）安装后，通过Google Play商店更新至官方新版（1.0.3+24）时，提示「Can't install AppName」，卸载旧版后可正常安装新版，Android 11、12设备均出现此问题。

复现步骤 #

• 用Android Studio构建版本号1.0.2+1、版本代码低于商店版的签名发布APK（使用与提交Play Store的AAB相同的keystore.jks签名）
• 安装该APK后触发更新弹窗跳转至Play Store，执行更新操作时出现安装失败提示

关键背景信息 #

• 本地APK与提交至Play Store的AAB使用同一上传密钥（keystore.jks）签名
• 商店版本已启用Google Play签名机制（由Google使用应用签名密钥重新签名分发）
• 测试覆盖Android 11、12设备

已尝试操作 #

卸载本地APK后可正常安装商店版本，但未找到无需卸载即可完成更新的方案

解决方案分析与操作 #

核心原因 #

启用Google Play签名后，Play商店分发的APK使用的是Google管理的应用签名密钥，而本地用上传密钥直接签名的APK，签名证书与商店版不一致，系统会判定为两个不同应用，因此无法直接更新。

方案1：构建兼容Play签名的测试APK #

通过让本地APK同时包含上传密钥和应用签名证书的签名，实现与商店版的签名同源：

1. 登录Google Play Console，进入应用的「应用签名」页面，下载应用签名证书（DER格式）
2. 将DER格式证书转换为PEM格式，执行命令：

   keytool -printcert -rfc -file app-signing-cert.der > app-signing-cert.pem
   

3. 修改Flutter项目的android/app/build.gradle中的签名配置，添加额外签名证书：

   android {
       signingConfigs {
           release {
               keyAlias '你的上传密钥别名'
               keyPassword '你的上传密钥密码'
               storeFile file('keystore.jks')
               storePassword '你的密钥库密码'
               v2SigningEnabled true
               v3SigningEnabled true
               // 添加应用签名证书作为额外签名
               additionalSigningCertificates = files('app-signing-cert.pem')
           }
       }
       buildTypes {
           release {
               signingConfig signingConfigs.release
               // 其他配置...
           }
       }
   }
   

4. 重新构建发布版APK，此APK可正常通过Play商店更新至官方新版

方案2：通过Play内部测试渠道分发旧版本 #

如果不需要本地构建旧版APK，可直接将旧版本AAB（1.0.2+1）用上传密钥签名后，提交至Play Console的内部测试渠道，从该渠道安装的旧版本与正式版签名一致，后续可正常更新。

注意事项 #

• 启用Google Play签名后，开发者本地签名的APK默认无法直接更新商店版，必须保证测试包的签名链与商店分发版本匹配
• 不要将仅用上传密钥签名的APK用于公开测试，避免用户遇到更新失败问题

内容的提问来源于stack exchange，提问作者a tip from dead sequoia tree