Flutter打包UatRelease APK时SigningConfig缺失storePassword求助

错误信息 #

• 错误：SigningConfig "release" 缺少必填属性 "storePassword"。
• 失败原因：任务 :app:packageUatRelease 执行失败，具体异常为：

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

用户执行的构建命令：

flutter build apk --flavor uat -dart-define=app.flavor=uat -t lib/namefile.dart --build-name=1.1.40 --build-number=46 --target-platform android-arm,android-arm64 --release

解决方案 #

1. 完善Android签名配置

打开项目的 android/app/build.gradle 文件，在 android 节点下添加或修正 signingConfigs 配置：

signingConfigs {
    release {
        // 替换为你的keystore文件路径、密码和别名
        storeFile file("your-keystore.jks") 
        storePassword "你的store密码"
        keyAlias "你的key别名"
        keyPassword "你的key密码"
    }
    // 若UAT环境使用独立签名，可单独配置uat节点
    uat {
        storeFile file("uat-keystore.jks")
        storePassword "uat-store密码"
        keyAlias "uat-key别名"
        keyPassword "uat-key密码"
    }
}

接着在 buildTypes 或 productFlavors 中指定对应的签名配置：

buildTypes {
    release {
        signingConfig signingConfigs.release
        // 其他构建配置
    }
}

// 针对UAT flavor指定签名（如果项目使用productFlavors）
productFlavors {
    uat {
        // 其他flavor配置
        signingConfig signingConfigs.uat // 或复用signingConfigs.release
    }
}

2. 用gradle.properties管理敏感信息（推荐）

为避免硬编码密码，在项目根目录的 gradle.properties 文件中添加：

STORE_FILE=../your-keystore.jks
STORE_PASSWORD=你的store密码
KEY_ALIAS=你的key别名
KEY_PASSWORD=你的key密码

再在 build.gradle 中引用这些变量：

signingConfigs {
    release {
        storeFile file(STORE_FILE)
        storePassword STORE_PASSWORD
        keyAlias KEY_ALIAS
        keyPassword KEY_PASSWORD
    }
}

3. 验证keystore路径正确性

确保keystore文件的路径是相对于 android/app 目录的，或使用绝对路径，避免因路径错误导致Gradle无法读取keystore文件。

4. 清理缓存后重新构建

执行以下命令清理缓存，再重新构建：

flutter clean
cd android && ./gradlew clean
# 重新执行你的构建命令
flutter build apk --flavor uat -dart-define=app.flavor=uat -t lib/namefile.dart --build-name=1.1.40 --build-number=46 --target-platform android-arm,android-arm64 --release

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