使用Gradle版本目录与Kotlin DSL时出现LibraryExtension不存在报错

报错核心原因是插件与对应扩展类型不匹配：

• 你编写的是AndroidLibraryConventionPlugin，也就是给Android Library模块使用的约定插件，这类插件需要先引入com.android.library插件，才会在项目扩展中注册LibraryExtension类型。
• 但你的代码里错误引入了com.android.application（Android应用模块插件），这个插件注册的扩展类型是BaseAppModuleExtension，和你要获取的LibraryExtension完全不匹配，自然会抛出扩展不存在的错误，这一点也能从报错打印的已注册扩展列表里存在BaseAppModuleExtension、找不到LibraryExtension得到验证。

另外你的通用配置方法里还存在一个隐藏问题：compileOptions闭包嵌套写了两层，会导致Java版本配置不生效。

1. 修正约定插件中引入的Android插件ID，将错误的com.android.application替换为com.android.library，修正后的插件代码如下：

class AndroidLibraryConventionPlugin : Plugin<Project> {
    override fun apply(target: Project) {
        with(target) {
            with(pluginManager) {
                // 修正插件ID，library模块对应com.android.library
                apply("com.android.library")
                apply("org.jetbrains.kotlin.android")
            }

            extensions.configure<LibraryExtension> {
                configureKotlinAndroid(this)
                defaultConfig.targetSdk = 32
            }

            val libs = extensions.getByType<VersionCatalogsExtension>().named("libs")
            dependencies {
                // 后续统一依赖配置
            }
        }
    }
}

2. 修复通用配置方法里的冗余compileOptions嵌套，去掉多余的闭包层，修正后的配置方法如下：

internal fun Project.configureKotlinAndroid(
    commonExtension: CommonExtension<*, *, *, *>,
) {
    commonExtension.apply {
        compileSdk = 32

        defaultConfig {
            minSdk = 21
        }

        compileOptions {
            // 去掉多余的一层compileOptions嵌套，直接配置版本
            sourceCompatibility = JavaVersion.VERSION_1_8
            targetCompatibility = JavaVersion.VERSION_1_8
        }

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

    val libs = extensions.getByType<VersionCatalogsExtension>().named("libs")
    dependencies {
        // 后续统一依赖配置
    }
}

补充说明：如果后续需要编写Android应用模块的约定插件，才需要引入com.android.application插件，此时对应的扩展类型为ApplicationExtension，不要和library模块的插件、扩展类型混用。

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