Android Kotlin多模块根目录统一配置Maven发布失败问题

问题描述 #

• 需求：在Android项目根目录的build.gradle.kts中统一配置Maven打包发布，项目包含Java库和Android Library两类子模块，Java库配置正常，Android Library出现异常。
• 错误现象：同步项目时抛出SoftwareComponent with name 'release' not found，根目录配置中打印的components.asMap.keys为空数组；但在Android Library子模块单独配置Maven发布时，能正常获取到[debug, release]组件。

原因分析 #

Android Gradle插件（AGP）的com.android.library插件不会自动生成release/debug发布组件，必须显式启用变体发布功能。在子模块单独配置时，AGP会在afterEvaluate阶段触发组件生成，但根目录统一配置时，由于执行时机或配置缺失，组件未被正确初始化，导致无法获取。

解决方案 #

根目录build.gradle.kts修改代码 #

import io.gitlab.arturbosch.detekt.Detekt
import com.android.build.gradle.LibraryExtension

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.kotlin.android) apply false
    alias(libs.plugins.jetbrains.kotlin.jvm) apply false
    alias(libs.plugins.arturbosch.detekt)
    alias(libs.plugins.android.library) apply false
    id("maven-publish")
}

subprojects {
    apply(plugin = "io.gitlab.arturbosch.detekt")
    apply(plugin = "maven-publish")

    detekt {
        source.from(files("src/main/java", "src/main/kotlin"))
        buildUponDefaultConfig = true
        allRules = false
        disableDefaultRuleSets = false
        debug = false
        parallel = false
    }

    tasks.withType<Detekt>().configureEach {
        reports {
            html.required.set(true)
            xml.required.set(true)
            txt.required.set(true)
            sarif.required.set(true)
        }
    }

    afterEvaluate {
        when {
            plugins.hasPlugin("com.android.library") -> {
                val androidExt = extensions.getByName("android") as LibraryExtension
                // 显式启用release变体的发布功能，触发AGP生成对应组件
                androidExt.publishing {
                    singleVariant("release") {
                        withSourcesJar() // 可选：添加源码包
                        withJavadocJar() // 可选：添加文档包
                    }
                }

                publishing {
                    publications {
                        create<MavenPublication>("${project.name}Release") {
                            artifactId = project.name
                            if (artifactId == "app") return@create
                            from(components["release"])
                            groupId = project.group.toString()
                            version = project.version.toString()
                        }
                    }
                    // 可选：配置Maven仓库
                    /*
                    repositories {
                        maven {
                            isAllowInsecureProtocol = true
                            name = "release"
                            url = uri("http://xxxxxxx/repository/maven-releases")
                            credentials {
                                username = "xxxxx"
                                password = "xxxxxxxx"
                            }
                        }
                    }
                    */
                }
            }
            plugins.hasPlugin("org.jetbrains.kotlin.jvm") || plugins.hasPlugin("java") -> {
                publishing {
                    publications {
                        create<MavenPublication>("${project.name}Release") {
                            artifactId = project.name
                            from(components["kotlin"] ?: components["java"])
                            groupId = project.group.toString()
                            version = project.version.toString()
                        }
                    }
                }
            }
        }
    }
}

子模块build.gradle.kts保持原有配置 #

无需修改，原有的Android Library配置即可配合根目录的统一发布逻辑工作。

关键修改说明 #

1. 启用Android变体发布：通过androidExt.publishing.singleVariant("release")显式指定要发布的变体，AGP会自动生成对应的release组件，同时可按需添加源码包和文档包。
2. 模块类型精准区分：用when语句分别处理Android Library和Java/Kotlin库的发布逻辑，避免类型判断混乱。
3. 组件获取逻辑优化：Android Library直接使用生成的release组件，Java库优先使用kotlin组件， fallback到java组件。

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