使用Gradle引导旧式Ant构建

Gradle提供了几种不同的方式来利用您现有的对Ant的投资，包括积累的知识和您已经放入构建文件中的时间。这可以极大地方便将Ant生成的项目移植到Gradle的过程，并为您提供逐步进行此操作的路径。 Gradle文档在描述如何在Gradle构建脚本中使用Ant方面做得很好，但是这里有一个快速概述以及我遇到的一些细节。

Gradle AntBuilder

每个Gradle项目都包含一个AntBuilder实例，从而使您的构建文件中可以使用任何和所有Ant功能。 Gradle提供了对现有Groovy AntBuilder的简单扩展，它增加了一种与现有Ant构建文件交互的简单而强大的方法： importBuild（Object antBuildFile）方法。在内部，此方法利用Ant ProjectHelper解析指定的Ant构建文件，然后将所有目标包装在Gradle任务中，以使它们在Gradle构建中可用。以下是用于说明的简单Ant构建文件，其中包含一些属性和几个相关的目标。

<?xml version='1.0'?>
<project name='build' default='all'><echo>Building ${ant.file}</echo><property file='build.properties'/><property name='root.dir' location='.'/><target name='dist' description='Build the distribution'><property name='dist.dir' location='dist'/><echo>dist.dir=${dist.dir}, foo=${foo}</echo></target><target name='all' description='Build everything' depends='dist'/>
</project>

使用Gradle导入此构建文件是一种方法。

ant.importBuild('src/main/resources/build.xml')

gradle任务的输出–全部在命令行上显示，目标已添加到构建任务中。

$ gradle tasks --all
...
Other tasks
-----------
all - Build everythingdist - Build the distribution
...

Ant构建文件中使用的属性可以在Gradle构建或命令行中指定，并且与通常的Ant属性行为不同，Ant或命令行上设置的属性可能被Gradle覆盖。给定一个简单的build.properties文件，其中的foo = bar为单个条目，这里有一些组合来演示覆盖行为。

命令行调用	Gradle构建配置	影响	结果
gradle dist	ant.importBuild（'src / main / resources / build.xml'）	使用从ant build加载的build.properties值	foo = bar
gradle dist -Dfoo = NotBar	ant.importBuild（'src / main / resources / build.xml'）	使用命令行属性	foo = NotBar
gradle dist -Dfoo = NotBar	ant.foo ='NotBarFromGradle' ant.importBuild（'src / main / resources / build.xml'）	使用Gradle build属性	foo = NotBarFromGradle
gradle dist -Dfoo = NotBar	ant.foo ='NotBarFromGradle' ant.importBuild（'src / main / resources / build.xml'） ant.foo ='NotBarFromGradleAgain'	使用Gradle构建属性覆盖	foo = NotBarFromGradleAgain

如何处理任务名称冲突

由于Gradle坚持任务名称的唯一性，因此尝试导入包含与现有Gradle任务名称相同的目标的Ant构建会失败。我遇到的最常见的冲突是Gradle BasePlugin提供的clean任务。借助一些间接的帮助，我们仍然可以通过使用GradleBuild任务来导入和使用任何冲突目标，以在独立的Gradle项目中引导Ant构建导入。让我们在导入的Ant构建中向混合添加一个新任务，并对all任务依赖于蚂蚁清理目标添加另一个依赖。

<!-- excerpt from buildWithClean.xml Ant build file --><target name='clean' description='clean up'><echo>Called clean task in ant build with foo = ${foo}</echo></target><target name='all' description='Build everything' depends='dist,clean'/>

还有一个简单的Gradle构建文件，它将处理导入。

ant.importBuild('src/main/resources/buildWithClean.xml')

最后，在主gradle构建文件中，我们添加了一个任务来运行所需的目标。

task importTaskWithExistingName(type: GradleBuild) { GradleBuild antBuild ->antBuild.buildFile ='buildWithClean.gradle'antBuild.tasks = ['all']
}

这行得通，但不幸的是遇到了一个小问题。当Gradle导入这些任务时，它没有正确遵守依赖项的声明顺序。而是按字母顺序执行从属蚂蚁目标。在这种特殊情况下，Ant希望在clean之前执行dist目标，而Gradle则以相反的顺序执行它们。可以通过明确说明任务顺序来解决此问题，该任务顺序绝对不理想，但可行。这个Gradle任务将按照我们需要的方式执行底层的Ant目标。

task importTasksRunInOrder(type: GradleBuild) { GradleBuild antBuild ->antBuild.buildFile ='buildWithClean.gradle'antBuild.tasks = ['dist', 'clean']
}

其余的Gradle规则

最后，您可以使用Gradle Rule来允许在GradleBuild自举导入中调用任意目标。

tasks.addRule('Pattern: a-<target> will execute a single <target> in the ant build') { String taskName ->if (taskName.startsWith('a-')) {task(taskName, type: GradleBuild) {buildFile = 'buildWithClean.gradle'tasks = [taskName - 'a-']}}
}

在此特定示例中，这还可以使您将调用串联在一起，但要警告它们在完全隔离的环境中执行。