Flutter自定义APK文件名失败，编译报错求正确配置方案

我太懂你这种折腾半天改APK文件名却被编译报错卡壳的感觉了！咱们一步步来解决这个问题：

先说说你原来配置里的坑 #

你最初的代码报错主要有这几个原因：

• 在新版Android Gradle插件的Kotlin DSL中，outputs.all的Lambda表达式有返回值要求，直接修改outputFileName会因为类型不匹配报错；
• 你在代码里写了val versionName = variant.versionName，这属于变量名自引用，编译器直接懵圈；
• 没有对output进行正确的类型强转，默认的output对象并没有直接暴露outputFileName属性。

正确的配置方案 #

你需要在android/app/build.gradle.kts中做这几个关键调整，我给你整理好完整的可运行配置：

首先，要在文件顶部导入必要的类：

import com.android.build.gradle.internal.api.ApkVariantOutputImpl

然后，在android闭包中添加正确的applicationVariants.all配置（替换你原来的那段）：

applicationVariants.all { variant ->
    outputs.all {
        // 只处理APK类型的输出，排除bundle等其他输出
        if (this is ApkVariantOutputImpl) {
            val appName = "myapp"
            // 处理空安全，避免versionName/versionCode为空导致的问题
            val appVersionName = variant.versionName ?: "unknown"
            val appVersionCode = variant.versionCode ?: 0
            // 构造自定义文件名，这里可以根据自己需求调整格式
            val newApkName = "${appName}_v${appVersionName}_${appVersionCode}.apk"
            // 设置输出文件名
            this.outputFileName = newApkName
        }
    }
}

完整的android/app/build.gradle.kts参考 #

把上面的配置整合到你的文件中，完整的可运行文件大概是这样的（保留你原来的签名、SDK等配置）：

import com.android.build.gradle.internal.api.ApkVariantOutputImpl
import java.util.Properties
import java.io.FileInputStream

plugins {
    id("com.android.application")
    id("kotlin-android")
    id("dev.flutter.flutter-gradle-plugin")
}

val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}

android {
    namespace = "com.company.myapp_security"
    compileSdk = flutter.compileSdkVersion
    ndkVersion = "27.0.12077973"

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }

    kotlinOptions {
        jvmTarget = JavaVersion.VERSION_11.toString()
    }

    defaultConfig {
        applicationId = "com.company.myapp_security"
        minSdk = flutter.minSdkVersion
        targetSdk = flutter.targetSdkVersion
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }

    signingConfigs {
        create("release") {
            keyAlias = keystoreProperties["keyAlias"] as String
            keyPassword = keystoreProperties["keyPassword"] as String
            storeFile = keystoreProperties["storeFile"]?.let { file(it) }
            storePassword = keystoreProperties["storePassword"] as String
        }
    }

    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
        }
    }

    // 关键：自定义APK文件名的正确配置
    applicationVariants.all { variant ->
        outputs.all {
            if (this is ApkVariantOutputImpl) {
                val appName = "myapp"
                val appVersionName = variant.versionName ?: "unknown"
                val appVersionCode = variant.versionCode ?: 0
                val newApkName = "${appName}_v${appVersionName}_${appVersionCode}.apk"
                this.outputFileName = newApkName
            }
        }
    }
}

flutter {
    source = "../.."
}

dependencies {
    implementation("com.google.android.material:material:1.12.0")
}

最后编译步骤 #

1. 先执行清理命令：

flutter clean

2. 然后打release包：

flutter build apk --release

这样在build/app/outputs/apk/release/目录下，你就能看到类似myapp_v1.0.0_1.apk这样的自定义文件名的APK了！

内容来源于stack exchange