Flutter打包Release APK失败：SigningConfig缺失storeFile属性

问题描述 #

构建Release版本APK失败，核心报错内容：

FAILURE: Build failed with an exception.

• 出错原因：
  任务':app:packageRelease'执行失败。

执行com.android.build.gradle.tasks.PackageAndroidArtifact$IncrementalSplitterRunnable时发生错误
SigningConfig "release"缺少必填属性"storeFile"。

BUILD FAILED in 27s
正在运行Gradle任务'assembleRelease'... 28.7s
Gradle任务assembleRelease执行失败，退出码1

已尝试flutter clean、flutter pub get命令，问题未解决。

解决方案 #

1. 补全Release签名配置 #

在Flutter项目的android/app/build.gradle文件中，找到android节点下的signingConfigs，补充完整release签名信息：

android {
    signingConfigs {
        release {
            storeFile file("your-keystore.jks") // 替换为你的密钥库文件路径
            storePassword "你的密钥库密码"
            keyAlias "你的密钥别名"
            keyPassword "你的密钥密码"
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            // 其他release相关配置
        }
    }
}

• 密钥库文件（.jks）建议放在android/app目录下，也可以使用绝对路径指定位置。
• 若还未生成密钥库，可通过以下命令创建：

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

2. 敏感信息外置配置（可选） #

将密码等敏感信息放在android/gradle.properties中，避免硬编码到build.gradle：

RELEASE_STORE_FILE=your-keystore.jks
RELEASE_STORE_PASSWORD=你的密钥库密码
RELEASE_KEY_ALIAS=你的密钥别名
RELEASE_KEY_PASSWORD=你的密钥密码

再在build.gradle中引用这些配置：

release {
    storeFile file(project.property("RELEASE_STORE_FILE"))
    storePassword project.property("RELEASE_STORE_PASSWORD")
    keyAlias project.property("RELEASE_KEY_ALIAS")
    keyPassword project.property("RELEASE_KEY_PASSWORD")
}

3. 重新构建 #

配置完成后，执行以下命令重新构建Release APK：

flutter clean
flutter pub get
flutter build apk --release

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