从apply plugin迁移至plugins{}块时apply false使用报错求助

问题场景 #

从旧的apply plugin方式迁移至新的plugins{}块结构，使用apply false声明插件时出现如下错误：

• What went wrong:
  Error resolving plugin [id: 'com.android.application', version: '8.1.0', apply: false]

The request for this plugin could not be satisfied because the plugin is already on the classpath with an unknown version, so compatibility cannot be checked.

错误核心是插件重复声明：旧的buildscript块通过classpath引入了插件，新的plugins{}块又再次声明，导致Gradle无法确定版本兼容性。

解决方案 #

1. 改造根项目build.gradle #

移除旧的buildscript块，改用plugins{}集中声明所有子模块需要的插件（带版本+apply false），避免重复依赖：

plugins {
    // 对齐你原buildscript中的AGP版本8.1.1
    id 'com.android.application' version '8.1.1' apply false
    id 'com.android.library' version '8.1.1' apply false
    // 对齐原kotlin版本1.9.0
    id 'org.jetbrains.kotlin.android' version '1.9.0' apply false
    // FlutterFire插件
    id 'com.google.gms.google-services' version '4.3.15' apply false
    // Hilt插件（如果使用）
    id 'com.google.dagger.hilt.android' version '2.44.2' apply false
}

ext {
    kotlin_version = '1.9.0'
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

2. 改造app模块build.gradle #

移除顶部重复的plugins{}声明，改用简洁的插件应用语法，同时删除旧的apply plugin行：

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterRoot = localProperties.getProperty('flutter.sdk')
if (flutterRoot == null) {
    throw GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

// 替换旧的apply plugin为plugins块
plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'com.google.gms.google-services'
    // 若使用Hilt，添加该行：id 'com.google.dagger.hilt.android'
}

apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

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

android {
    compileSdkVersion 33
    namespace "com.mladenovit.logitplus"
    buildFeatures {
        buildConfig = true
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }

    kotlinOptions {
        jvmTarget = '17'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        applicationId "com.mladenovit.logitplus"
        minSdkVersion 21
        targetSdkVersion 31
        versionCode 5
        versionName "1.0.4"
        multiDexEnabled true
    }

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

flutter {
    source '../..'
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${rootProject.ext.kotlin_version}"
    implementation 'com.android.support:multidex:2.0.1'
}

关键注意点 #

• 版本对齐：确保plugins{}块中的插件版本与原buildscript中的版本一致（比如AGP用8.1.1而非8.1.0），避免版本不兼容。
• 彻底迁移：移除旧的buildscript中所有对应插件的classpath依赖，完全切换到新的Plugins DSL语法。
• Flutter兼容性：保留apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"这一行，确保Flutter的Gradle集成正常。

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