gradle/groovy 脚本中的逻辑

Question

我是 groovy-gradle 领域的新手，现在我正在学习多个在线课程，但我在这里遗漏了一些东西。

我会给你举个例子。这将创建一个 Jar 文件：

apply plugin: 'java' // 1. Apply the Java plugin to the project

sourceSets {
    main {
        java {
            srcDir 'java' // 3. Add 'java' directory as a source directory
        }
    }
}

jar {
    manifest {
        attributes 'Implementation-Version': '1.0' // 2. Add manifest attribute
    }
}

你可以在任何地方找到这个解决方案，但没有明确的解释。

现在，可以通过以下方式申请插件：Plugin.apply(T) 我假设 Plugin 是对象实例， apply 是它的方法， T 是一个参数。 那么apply plugin "java"是什么？

还有一种叫做 sourceSets 的东西。它可能是采用闭包参数的方法，也可能是由于 groovy 生成的默认 getter 而采用闭包作为参数的属性。 我不知道，因为在 groovy 中等号是可选的，括号是可选的。--- 非常创新！！！！！！！！！

最后还有一个叫做main的东西。我找不到它是什么，我一直在到处寻找它，甚至在这里：https://docs.gradle.org/current/dsl/org.gradle.api.tasks.SourceSet.html

这个'main'-ting包含一个叫做java的东西（看起来像SourceDirectorySet的实例），它包含方法srcDir，它接受一个字符串作为参数。

这对你有意义吗？ 如何从这里提取信息： https://docs.gradle.org/current/dsl/，并在构建中使用它？

我在这里错过了什么？

Answer 1

我在手机上，所以很难解释 Gradle 的所有魔力，但这应该对您有所帮助。

在作用域中有一个隐含的 Project 实例，你在 gradle 脚本中看到的大部分内容都将委托给它。

例如

apply plugin: 'java' 

相当于

getProject().apply([plugin: 'java'])

您可以在writing a custom plugin section 中阅读更多内容，但有一个属性文件将“java”映射到JavaPlugin

当您应用“java”插件时，这会将JavaPluginConvention“混合”到项目中（因此您现在可以在java中调用getSourceSets()，在groovy中可以缩写为“sourceSets”）

在 Gradle 的 DSL 中得到大量使用的一个特性是 Groovy 的 methodMissing(...)。所以

sourceSets.main { ... } 

实际上会被动态委托给

sourceSets.getByName('main').configure { ... } 

另一个“神奇”来源的特性是在 groovy 中你可以编写

def a = new A()
a.foo = 'bar'
a.baz('x')

作为

def a = new A()
a.with {
    foo = 'bar'
    baz('x')
} 

希望您可以看到闭包中的所有属性/方法引用都委托给“a”实例。这种配置风格有助于 gradle 脚本保持简洁。

见the with method