Flutter项目构建APK失败：release签名配置缺失storeFile属性求助

步骤1：生成签名密钥（无密钥时执行） #

打开终端运行以下命令生成JKS格式的签名密钥：

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

执行过程中会要求输入密钥库密码、密钥密码、个人信息，务必牢记密码与密钥别名。

步骤2：创建密钥配置文件 #

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

storePassword=你的密钥库密码
keyPassword=你的密钥密码
keyAlias=key
storeFile=密钥文件的路径（例：../key.jks，若密钥放在android目录外）

• 若密钥文件直接放在android/app目录下，storeFile值改为key.jks即可；
• Windows系统路径需用双反斜杠（C:\\Users\\xxx\\key.jks）或正斜杠（/C/Users/xxx/key.jks）。

步骤3：修改Android构建配置 #

打开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代码块内、buildTypes之前添加签名配置：

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

3. 修改buildTypes中的release配置，指定签名配置：

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

步骤4：重新构建Release APK #

在终端运行以下命令重新构建：

flutter build apk --release

注意事项 #

• 将key.properties添加到.gitignore文件中，避免密钥信息泄露到版本仓库；
• 若密钥文件路径变更，需同步修改key.properties中的storeFile值。

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