组件元数据修正 (Metadata Rules)

源：修正不正确的组件元数据

有时你会发现，某个第三方库的 pom.xml 文件写错了（比如：声明了错误的依赖、漏掉了某个库），或者你想在全局范围内强制某个库的行为。

1. 为什么它是“大招”？

传统的 exclude 必须在每个 implementation 处重复写。而 Metadata Rules 允许你在项目的 入口处 (Settings) 全局拦截并修改这个库的“基因”。

2. 实战案例：修复库的依赖缺失

假设库 com.example:bad-lib:1.0 运行需要 guava，但作者在发布时忘了写进依赖里。

// settings.gradle.kts
dependencyResolutionManagement {
    components {
        withModule<com.example.BadLibRule>("com.example:bad-lib")
    }
}

// 具体的修正逻辑类
abstract class BadLibRule : ComponentMetadataRule {
    override fun execute(context: ComponentMetadataContext) {
        context.details.allVariants {
            withDependencies {
                // 为该库强制注入缺失的依赖
                add("com.google.guava:guava:31.0-jre")
            }
        }
    }
}

3. 全局替换“能力 (Capabilities)”

场景

你的项目里有 10 个库都带了不同版本的 log4j，导致 Jar 包冲突。

你可以定义一个规则，声明“所有的日志库都应该指向同一个实现”，Gradle 会自动处理这种基于能力的冲突解决。

4. 结论

Component Metadata Rules 是处理大规模、复杂第三方依赖的最佳防线。它能保证你的业务模块 build.gradle 极其干净，所有的“黑科技适配”都集中在 Settings 层处理。