Flutter构建APK报错：SigningConfig "release"缺失必填属性storeFile

错误核心原因 #

构建Release版本APK时，Gradle的release签名配置中缺少必填的storeFile属性，导致:app:packageRelease任务执行失败。

解决步骤 #

1. 生成签名密钥库（若已有可跳过） #

使用keytool命令生成签名文件（确保已配置Java环境变量）：

keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

• ~/key.jks：密钥库生成路径，可自定义为项目目录下的路径（如android/key.jks）
• key：密钥别名，可自定义
• 执行命令后按提示输入密钥库密码、密钥密码等信息

2. 创建签名配置文件 #

在Flutter项目的android/app目录下新建key.properties文件，填入以下内容（替换为你的实际信息）：

storePassword=你的密钥库密码
keyPassword=你的密钥别名密码
keyAlias=key
storeFile=../key.jks # 密钥库文件路径，根据实际位置调整

注意：将key.properties添加到.gitignore中，避免泄露敏感信息

3. 修改Android构建配置 #

打开android/app/build.gradle文件，进行两处修改：

• 在android代码块之前添加密钥库配置读取逻辑：

  def keystoreProperties = new Properties()
  def keystorePropertiesFile = rootProject.file('key.properties')
  if (keystorePropertiesFile.exists()) {
      keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
  }
  

• 在android代码块内配置release签名：

  android {
      // 其他原有配置...
  
      signingConfigs {
          release {
              keyAlias keystoreProperties['keyAlias']
              keyPassword keystoreProperties['keyPassword']
              storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
              storePassword keystoreProperties['storePassword']
          }
      }
  
      buildTypes {
          release {
              signingConfig signingConfigs.release
              // 其他原有配置（如minifyEnabled、shrinkResources等）
          }
      }
  }
  

4. 重新构建Release APK #

执行以下命令重新构建：

flutter build apk --release

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