Flutter执行build apk/appbundle报错Keystore file not set如何解决

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':app:validateSigningRelease'.

Keystore file not set for signing config release

该报错是Flutter Android端打包时，release模式的签名配置不完整，无法找到对应密钥库文件导致的。

按以下步骤依次检查配置即可解决：

• 确认密钥库文件位置
  将你生成的.jks或.keystore后缀的密钥文件放到项目android/app目录下，避免路径引用出错。
• 新建密钥配置文件
  在项目android目录下创建key.properties文件，填入你的密钥信息：

  storePassword=你设置的密钥库密码
  keyPassword=你设置的密钥密码
  keyAlias=你设置的密钥别名
  storeFile=你的密钥文件名，例如upload.jks
  

  注意：该文件包含敏感信息，不要提交到公共代码仓库，需加入.gitignore规则
• 修改app层级build.gradle配置
  打开android/app/build.gradle文件，做两处调整：
  1. 在android配置块上方新增密钥配置读取逻辑：

  def keystoreProperties = new Properties()
  def keystorePropertiesFile = rootProject.file('key.properties')
  if (keystorePropertiesFile.exists()) {
      keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
  }
  
  android {
      // 原有android块内容保持不变
  }
  

  2. 找到android块内的signingConfigs和buildTypes配置，替换为以下内容，原有其他配置项保留：

  signingConfigs {
      release {
          keyAlias keystoreProperties['keyAlias']
          keyPassword keystoreProperties['keyPassword']
          storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
          storePassword keystoreProperties['storePassword']
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 原有release配置比如minifyEnabled、shrinkResources等保持不变
      }
  }
  

• 重新执行打包命令
  所有修改保存后，先执行flutter clean清理缓存，再执行flutter build apk或flutter build appbundle即可正常打包。

• 密钥文件名大小写、拼写和key.properties中storeFile的配置不一致
• 密钥密码、别名填写错误，前后多余空格也会导致读取失败
• 密钥文件没有放在android/app目录下时，需写对相对路径，比如放在android目录下时storeFile要写成../xxx.jks

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