Bindtargets

自 Apache Ant 1.8.2 起

描述

将某些目标绑定到某些定义的 扩展点。这将使目标列表成为扩展点的依赖项。

当您希望某个目标参与另一个构建工作流时,此任务很有用,该工作流明确地为这种插入暴露了一个扩展点。因此,要绑定的目标和要绑定的扩展点都在一些导入的构建文件中声明。但是,直接修改这些外部构建文件的目标依赖关系图可能会对导入它们的某些其他项目产生副作用。此任务有助于修改目标依赖关系,但仅在您的上下文中。

注意:此任务与定义一个中间目标非常类似,该目标将作为要绑定的目标和扩展点之间的桥梁。例如

<bindtargets targets="jar,javadoc" extensionPoint="dist"/>

与以下内容非常类似

<target name="bind-to-dist" depends="jar,javadoc" extensionOf="dist"/>

此任务基本上避免了创建目标。

bindtargets 任务只能用作顶级任务。这意味着它不能在目标中使用。这使得目标依赖关系图在加载每个构建文件后变得静态且可预测。

参数

属性 描述 必需
targets 要绑定的目标名称的逗号分隔列表。
extensionPoint 要将目标绑定到的扩展点的名称。
onMissingExtensionPoint 如果此目标尝试扩展一个缺失的 扩展点,该怎么办:failwarnignore 否;默认为 fail

示例

<bindtargets targets="build-jar,build-src-jar" extensionPoint="dist"/>