| API 文档 | ComponentMetadataHandler |
|---|
允许构建提供规则,修改所依赖软件组件的元数据。组件元数据规则应用于构建脚本的依赖块 DependencyHandler 的组件部分。规则可以通过两种不同的方式定义
- 直接在组件部分应用时作为操作
- 作为一个独立的类,实现
ComponentMetadataRule接口
示例展示了从我们的某个依赖项中移除某些传递性依赖项的基本方法。
plugins {
id 'java'
}
repositories {
mavenCentral()
}
dependencies {
components {
withModule("jaxen:jaxen") {
allVariants {
withDependencies {
removeAll { it.group in ["dom4j", "jdom", "xerces", "maven-plugins", "xml-apis", "xom"] }
}
}
}
}
implementation("jaxen:jaxen:1.1.3")
}
| 方法 | 描述 |
all(rule) | 添加一个规则闭包,可以修改任何已解析软件组件的元数据。 |
all(rule) | 添加一个基于类的规则,可以修改任何已解析软件组件的元数据。 |
all(rule, configureAction) | 添加一个基于类的规则,可以修改任何已解析软件组件的元数据。规则本身由提供的配置操作配置。 |
all(ruleSource) | 添加一个规则,可以修改任何已解析软件组件的元数据。 |
all(rule) | 添加一个规则操作,可以修改任何已解析软件组件的元数据。 |
withModule(id, rule) | 添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。 |
withModule(id, rule) | 添加一个基于类的规则,可以修改属于指定模块的任何已解析软件组件的元数据。 |
withModule(id, rule, configureAction) | 添加一个基于类的规则,可以修改属于指定模块的任何已解析软件组件的元数据。 |
withModule(id, ruleSource) | 添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。 |
withModule(id, rule) | 添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。 |
ComponentMetadataHandler all(Closure<?> rule)
Closure<?>添加一个规则闭包,可以修改任何已解析软件组件的元数据。
提供的规则闭包必须声明一个 ComponentMetadataDetails 作为其第一个参数,以允许修改组件元数据。
此外,规则可以声明额外的(只读)参数,这些参数可以提供关于组件的额外细节。这些额外参数的顺序不重要。
支持以下额外参数类型
IvyModuleDescriptor- 额外的 Ivy 特定元数据。声明此参数的规则将仅为打包为 Ivy 模块的组件调用。PomModuleDescriptor- 额外的 Maven 特定元数据。声明此参数的规则将仅为打包为 POM 模块的组件调用。
ComponentMetadataHandler all(Class<? extends ComponentMetadataRule> rule)
Class<? extends ComponentMetadataRule>添加一个基于类的规则,可以修改任何已解析软件组件的元数据。
ComponentMetadataHandler all(Class<? extends ComponentMetadataRule> rule, Action<? super ActionConfiguration> configureAction)
Class<? extends ComponentMetadataRule>Action<? super ActionConfiguration>添加一个基于类的规则,可以修改任何已解析软件组件的元数据。规则本身由提供的配置操作配置。
ComponentMetadataHandler all(Object ruleSource)
添加一个规则,可以修改任何已解析软件组件的元数据。
ruleSource 是一个对象,它有一个用 Mutate 注释的单一规则方法。
此规则方法
- 必须返回 void。
- 必须将
ComponentMetadataDetails作为第一个参数。 - 可以有一个类型为
IvyModuleDescriptor或PomModuleDescriptor的附加参数。
ComponentMetadataHandler all(Action<? super ComponentMetadataDetails> rule)
Action<? super ComponentMetadataDetails>添加一个规则操作,可以修改任何已解析软件组件的元数据。
ComponentMetadataHandler withModule(Object id, Closure<?> rule)
Closure<?>添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。
规则闭包参数需满足与 ComponentMetadataHandler.all(groovy.lang.Closure) 相同的要求。
ComponentMetadataHandler withModule(Object id, Class<? extends ComponentMetadataRule> rule)
Class<? extends ComponentMetadataRule>添加一个基于类的规则,可以修改属于指定模块的任何已解析软件组件的元数据。
ComponentMetadataHandler withModule(Object id, Class<? extends ComponentMetadataRule> rule, Action<? super ActionConfiguration> configureAction)
Class<? extends ComponentMetadataRule>Action<? super ActionConfiguration>添加一个基于类的规则,可以修改属于指定模块的任何已解析软件组件的元数据。
ComponentMetadataHandler withModule(Object id, Object ruleSource)
添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。
规则源参数需满足与 ComponentMetadataHandler.all(java.lang.Object) 相同的要求。
ComponentMetadataHandler withModule(Object id, Action<? super ComponentMetadataDetails> rule)
Action<? super ComponentMetadataDetails>添加一个规则,可以修改属于指定模块的任何已解析软件组件的元数据。