gradle - 在 Gradle Kotlin DSL 中注册和创建有什么区别

Question

在 Gradle (5.0+) 中有两种创建方法，即任务:

tasks {
    val javadocJar by creating(Jar::class) {
        val javadoc by tasks

        from(javadoc)
        classifier = "javadoc"
    }
}

和

tasks {
    val javadocJar by registering(Jar::class) {
        val javadoc by tasks

        from(javadoc)
        classifier = "javadoc"
    }
}

基本相同的API，那么有什么区别呢？

Answer 1

见 https://docs.gradle.org/current/userguide/kotlin_dsl.html#using_the_container_api :

tasks.named("check")                  
tasks.register("myTask1")

The above sample relies on the configuration avoidance APIs. If you need or want to eagerly configure or register container elements, simply replace named() with getByName() and register() with create().

creating之间的区别和 registering (或 create 和 register 在 5.0 之前的 Gradle 版本中)与 Task Configuration Avoidance 相关新API，详细说明 here (见 this section):

How do I defer task creation?

This feature requires build authors to opt-in by migrating task creation from the TaskContainer.create(java.lang.String) APIs to the TaskContainer.register(java.lang.String) APIs. The register(…​) API registers a task to be created at a later time if and only if the task is needed. The create(…​) API continues to eagerly create and configure tasks when it is called.