第5级Kotlin DSL：多模块项目中的常见任务和Maven工件

Question

我真的很想欣赏Gradle5，特别是结合了新的Kotlin DSL，但是我很难获得（在我看来）一个非常非常简单和普通的构建与Gradle一起运行。

在Maven default目录布局中发布一个Java库，其中包含几个相互依赖的子模块，作为高质量的Maven工件/存储库，在一个即时的、简单的Gradle构建中（即DRY）。

因此：拥有一个根项目作为保护伞，它定义并包含所有公共配置（实际上除了真正的依赖项之外的所有配置）。

我将当前的“结果”移植到Github上的一个示例项目中，并已经在Gradle论坛上提出了这个问题。

目前，我没有声明必要的任务，以便在中央构建中提供标准的-sources和-javadoc工件。

例如，在寻找基于Kotlin DSL的解决方案时，您会发现这三个“解决方案”在多模块方案中都不再起作用：

• https://stackoverflow.com/A/48070667
• https://stackoverflow.com/A/52596969/1237653
• 甚至官方的“Maven Publish”文档也只能在单模块场景中工作。

完整示例参见GitHub：https://github.com/bentolor/gradle-maven-multimodule-kotlindsl

subprojects {
    apply(plugin = "java-library")
    apply(plugin = "maven-publish")
    group = "de.bentolor.sampleproject"
    version = "0.1.0"

    repositories {
        jcenter()
    }

    dependencies {
        // Dependencies used in EVERY module
        "compile"("commons-logging:commons-logging:1.2")
        "testImplementation"("junit:junit:4.12")
    }

    tasks {
        // not working
        /*register("sourcesJar", Jar::class.java) {
            from(sourceSets.main.get().allJava)
            classifier = "sources"
        }*/

       // not working, eiher
       /* task<Jar>("sourcesJar") {
            from(sourceSets.main.get().allJava)
            classifier = "sources"
       } */
    }

    configure<JavaPluginExtension> {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }

    configure<PublishingExtension> {
        publications {
            create<MavenPublication>(project.name) {
                from(components["java"])
                // won't work, beause inaccessible declaration in `tasks{}`-Block
                //add("archives", javadocJar)
                //add("archives", sourcesJar)
            }
        }

        repositories {
            mavenLocal()
        }
    }
}

group = "de.bentolor.sampleproject.module2"

dependencies {
    compile(project(":module1"))
}

Answer 1

试试看：

subprojects {
    apply<JavaLibraryPlugin>()
    apply<MavenPublishPlugin>()

    group = "de.bentolor.sampleproject"
    version = "0.1.0"

    repositories {
        jcenter()
    }

    dependencies {
        val implementation by configurations
        val testImplementation by configurations

        implementation("commons-logging:commons-logging:1.2")
        testImplementation("junit:junit:4.12")
    }

    // This will work, but as long as these tasks are need only for publishing you can declare them inplace later where you need 
    // tasks {
    //     val sourcesJar by creating(Jar::class) {
    //         val sourceSets: SourceSetContainer by project
    //         from(sourceSets["main"].allJava)
    //         classifier = "sources"
    //     }
    //     val javadoc by getting(Javadoc::class)
    //     val javadocJar by creating(Jar::class) {
    //         from(javadoc)
    //         classifier = "javadoc"
    //     }
    // }

    configure<JavaPluginExtension> {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }

    configure<PublishingExtension> {
        publications {
            create<MavenPublication>(project.name) {
                from(components["java"])

                // If you configured them before
                // val sourcesJar by tasks.getting(Jar::class)
                // val javadocJar by tasks.getting(Jar::class)

                val sourcesJar by tasks.creating(Jar::class) {
                    val sourceSets: SourceSetContainer by project

                    from(sourceSets["main"].allJava)
                    classifier = "sources"
                }
                val javadocJar by tasks.creating(Jar::class) {
                    from(tasks.get("javadoc"))
                    classifier = "javadoc"
                }

                artifact(sourcesJar)
                artifact(javadocJar)
            }
        }
    }
}

一些注意事项：

• 当可以执行类型安全的apply () 时，为什么要使用基于字符串的apply？
• 在可以使用委托的情况下，为什么要在依赖项中的sting上使用调用，这样做更不麻烦，可重构性更好。
• 考虑使用实现而不是编译

• 父项目在子项目之前计算，因此在父项目中不知道子项目的扩展。
• 应用于父级和子级的插件集是不同的，您需要在父级中使用子级访问器。

sourcesets是Kotlin DSL为儿童生成的访问器之一。但它在父母版中是不可用的。您可以自己尝试一下：在子项目中只应用Java插件。sourceset将在子生成脚本中可用，但在父生成脚本中不可用。

这也是为什么您可以在子级中使用java，但在父级中配置时必须使用configure 的原因。

但您可以使用委托获取域对象的引用,如任务、源集、配置等。