Gradle Kotlin-DSL插件中无法导入material3依赖的问题

问题分析 #

你已经在libs.versions.toml中声明了Material3依赖，但在自定义插件中添加依赖时失败，核心原因是未将依赖正确注入到Android Library模块的依赖配置块中，此前的调用方式缺少对dependencies闭包的规范引用。

步骤1：完善libs.versions.toml配置 #

推荐通过版本引用的方式管理依赖版本，避免硬编码：

[versions]
androidx-compose-material3 = "1.2.1" # 替换为你需要的版本号

[libraries]
androidx-compose-material3 = { group = "androidx.compose.material3", name = "material3", version.ref = "androidx-compose-material3" }

步骤2：修改自定义插件代码 #

在AndroidLibraryComposeConventionPlugin中，通过dependencies闭包将Material3依赖添加到模块，同时确保Compose基础功能已启用：

class AndroidLibraryComposeConventionPlugin : Plugin<Project> {
    override fun apply(target: Project) {
        with(target) {
            pluginManager.apply("com.android.library")
            val extension = extensions.getByType<LibraryExtension>()
            
            // 配置Compose基础构建特性
            configureAndroidCompose(extension)
            
            // 将Material3依赖添加到implementation配置
            dependencies {
                "implementation"(libs.findLibrary("androidx-compose-material3").getOrThrow())
            }
        }
    }

    private fun configureAndroidCompose(extension: LibraryExtension) {
        extension.apply {
            // 启用Compose功能（必须配置，否则依赖无法生效）
            buildFeatures.compose = true
            
            // 配置Compose编译器版本（需在libs.versions.toml中声明对应版本）
            composeOptions {
                kotlinCompilerExtensionVersion = libs.findVersion("androidx-compose-compiler").get().toString()
            }
        }
    }
}

关键说明 #

• 使用getOrThrow()替代get()：依赖未找到时会抛出明确异常，便于快速定位问题，避免静默失败。
• 依赖必须放入dependencies闭包：这是Gradle管理模块依赖的标准方式，直接调用"implementation"(...)或add()无法正确关联到模块的依赖配置。
• 确保Compose功能已启用：buildFeatures.compose = true是使用所有Compose库的前置条件，缺失会导致依赖无法被识别。

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