Flutter构建APK失败：build.gradle中Release签名配置缺失storeFile

问题原因 #

Release版本APK必须进行签名，你的android/app/build.gradle中未正确配置Release签名所需的storeFile等核心参数，导致构建流程中断。

解决方案 #

1. 生成签名密钥（若未拥有） #

打开终端执行JDK自带的keytool命令（确保JDK已配置环境变量）：

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

• ~/key.jks：密钥文件存储路径，Windows系统可改为C:\Users\你的用户名\key.jks这类格式
• validity：密钥有效期，单位为天
• 执行过程中会提示输入密钥库密码、密钥密码、个人信息等，务必留存这些内容

2. 创建密钥配置文件 #

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

storePassword=你的密钥库密码
keyPassword=你的密钥密码
keyAlias=key
storeFile=../key.jks  # 若密钥文件存放在app目录的上一级，否则填写实际路径

3. 修改android/app/build.gradle文件 #

步骤1：加载密钥配置

在android代码块之前添加如下代码：

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

步骤2：配置签名规则

在android代码块内新增signingConfigs节点：

android {
    // ... 保留原有代码

    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }

    // ... 保留原有代码
}

步骤3：关联Release构建与签名配置

找到android代码块内的buildTypes节点，确保release配置绑定上述签名规则：

buildTypes {
    release {
        // ... 保留原有配置（如minifyEnabled、shrinkResources等）
        signingConfig signingConfigs.release
    }
}

4. 安全提醒 #

将key.properties添加到项目根目录的.gitignore文件中，防止密钥信息泄露到版本仓库：

# Android key properties
android/key.properties

临时测试方案（仅用于调试，禁止正式发布） #

如果只是临时测试构建，可临时将Release构建的签名配置改为Debug签名：

buildTypes {
    release {
        signingConfig signingConfigs.debug
    }
}

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