如何仅为特定Gradle构建变体应用指定插件？

我们的Android项目包含usStage、usDebug、usProduction等Gradle构建变体，com.heapanalytics.android插件会增加数分钟的构建耗时，且仅需在usProduction变体中启用，其他变体不需要。

当前我们在app/build.gradle.kts顶部统一引入所有插件，导致不必要的Debug构建速度变慢：

plugins {
    id("com.google.gms.google-services")
    id("com.google.firebase.crashlytics")
    id("com.heapanalytics.android")
    id("com.gladed.androidgitversion") version "0.4.14"
    id("jacoco-reports")
}

尝试过在Release构建类型块中应用插件，但插件仍会作用于所有变体：

plugins {
    id("com.google.gms.google-services")
    id("com.google.firebase.crashlytics")
    id("com.gladed.androidgitversion") version "0.4.14"
    id("jacoco-reports")
}

android {
    defaultConfig {
        // ...
    }
    
    signingConfigs {
        create("release") {
            // ...
        }
        getByName("debug") {
            // ...
        }
    }

    buildTypes {
        getByName("debug") {
            // ...
        }

        getByName("release") {
            // ...
            apply(plugin = "com.heapanalytics.android")
            // ...
        }
    }
}

也试过通过项目属性判断加载，虽能生效但不够优雅：

if (project.hasProperty(BuildProperties.Metrics.ENABLE_HEAP)) {
    apply(plugin = "com.heapanalytics.android")
}

解决方案 #

方法1：基于任务判断的插件按需应用（推荐）

先在插件块中声明Heap插件但不直接应用，然后通过Gradle启动时的任务列表判断是否要构建usProduction变体，再决定是否加载插件：

plugins {
    id("com.google.gms.google-services")
    id("com.google.firebase.crashlytics")
    id("com.gladed.androidgitversion") version "0.4.14"
    id("jacoco-reports")
    // 声明插件可用，但暂不应用
    id("com.heapanalytics.android") apply false
}

// 检查启动Gradle时指定的任务，仅当包含usProduction时应用插件
gradle.startParameter.taskNames.forEach { taskName ->
    if (taskName.contains("usProduction", ignoreCase = true)) {
        apply(plugin = "com.heapanalytics.android")
        return@forEach
    }
}

android {
    // ... 你的defaultConfig、signingConfigs、buildTypes等配置
}

这种方式能确保插件仅在构建usProduction时才被加载和配置，完全避免对其他变体的构建开销。

方法2：通过变体过滤器控制插件应用

利用Android Gradle插件的variantFilter，在变体配置阶段为usProduction单独应用插件：

plugins {
    // 同上，声明插件但暂不应用
    id("com.heapanalytics.android") apply false
    // ...其他插件
}

android {
    // ...其他配置

    variantFilter {
        // 仅匹配usProduction变体时应用插件
        if (name == "usProduction") {
            project.apply(plugin = "com.heapanalytics.android")
        }
    }
}

方法3：插件配置开关（若插件支持）

如果Heap插件提供了启用/禁用的配置项，可以统一引入插件，然后在变体中控制开关：

plugins {
    id("com.heapanalytics.android")
    // ...其他插件
}

android {
    // ...其他配置

    applicationVariants.all {
        extensions.configure<com.heapanalytics.android.HeapExtension> {
            // 仅usProduction变体启用插件功能
            enable = name == "usProduction"
        }
    }
}

注意：这种方式需要插件本身支持类似enable的配置参数，需查阅Heap插件文档确认。

关键提醒 #

• 不要在buildTypes块中应用插件，因为同一个buildType会被多个变体共享，无法实现单一变体的插件控制。
• 使用apply false声明插件能让Gradle提前知晓插件存在，但不会立即执行其配置逻辑，直到你显式应用。

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