gradle - 如何在Gradle中配置插件属性

Question

我的gradle构建文件中还有以下内容

targetCompatibility = '1.8'

checkstyle {
    toolVersion = '6.6'
}

task wrapper(type: Wrapper) {
    gradleVersion = '2.4'
}

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

以我对gradle的有限理解，所有4个部分都是插件的配置。然而，它们看起来却大不相同。

除了语法不同之外，这4个变体之间的语义区别是什么？

我应该如何从文档中了解使用哪种样式？

Answer 1

targetCompatibility = '1.8'

这是 Java Plugin Convention Property，即允许您使用项目属性(而不是仅任务属性)设置其值的属性。这些属性通常在插件文档中列出。您可以阅读有关约定属性 here的更多信息。

checkstyle {
    toolVersion = '6.6'
}

该任务的类型为CheckstyleExtension，您可以在其 DSL Documentation中找到其可用属性。

task wrapper(type: Wrapper) {
    gradleVersion = '2.4'
}

在这里，您定义了Wrapper类型的任务实例。这样，任务 wrapper具有与包装器任务类型相同的属性，后者的DSL被定义为 here。

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

此语法用于配置特定类型的所有任务。在这种情况下，您将选择 JavaCompile类型的所有任务并配置其 options.encoding属性。