无法将Flutter构建的Release版本上传至Google Play

1. 检查签名配置是否合规 #

Google Play强制要求发布版本使用上传密钥签名（禁止用调试密钥），按以下步骤确认：

• 打开android/app/build.gradle，检查签名配置是否正确：

  signingConfigs {
      release {
          keyAlias '你的密钥别名'
          keyPassword '密钥密码'
          storeFile file('你的密钥文件路径.jks')
          storePassword '密钥库密码'
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 其他构建配置
      }
  }
  

• 若未生成上传密钥，用keytool命令生成：

  keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  

• 将生成的upload-keystore.jks放到android/app目录下，确保配置文件中的路径一致。

2. 确认发布包格式正确 #

Google Play优先推荐上传App Bundle（.aab），若上传APK需满足格式要求：

• 构建AAB的命令：

  flutter build appbundle --release
  

• 若选择上传APK，需确保是拆分APK或通用APK，且符合Google Play的文件规范。

3. 核对版本号与版本代码 #

• pubspec.yaml中的version字段需遵循x.y.z+buildNumber格式（如1.0.0+1），其中buildNumber必须大于之前上传的版本，不能重复。
• 确认android/app/build.gradle中的versionCode和versionName与pubspec配置一致，或已开启自动同步。

4. 检查Google Play控制台配置 #

• 确认应用已在控制台创建，且处于内部测试/封闭测试/开放测试/正式发布状态（草稿状态无法上传）。
• 若为首次上传，控制台会自动关联你的上传密钥；若更换过密钥，需在控制台重新配置密钥信息。

5. 排查构建过程错误 #

• 确保flutter build appbundle --release命令能成功执行，无依赖冲突、资源错误等报错。
• 查看构建日志，重点排查签名失败、资源压缩异常等关键信息。

6. 解决上传工具问题 #

• 网页端上传时，确认网络稳定，发布包文件未损坏；使用fastlane等CI工具时，检查密钥路径、权限配置是否正确。

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