Як побудувати баночку з джерелами з градель

Я працюю з проектом з відкритим кодом, який будується з gradle. Я хотів би генерувати (проект) -sources.jar файл, який я можу завантажити у свій IDE (IntelliJ IDEA) та налагодити через проект. Я знаю, як завантажити файл, якщо я можу генерувати його.

Я переглянув доступні завдання Gradle для проекту, і не існує жодної, яка б генерувала файл jar джерела.

Який найпростіший спосіб згенерувати файл jar джерела для цього проекту?

Додавання джерела до файлу jar, який містить компільовані файли класу, було б добре.

task sourcesJar(type: Jar, dependsOn: classes) {
    classifier = 'sources'
    from sourceSets.main.allSource
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives sourcesJar
    archives javadocJar
}

Якщо ви використовуєте Android:

task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}

task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

artifacts {
    archives javadocJar
    archives sourcesJar
}

від сюди

Якщо ви хочете додати джерела до компільованого файлу JAR класів , який ви також сказали, що є прийнятним, ви можете зробити це досить легко. Просто додайте у файл збірки наступне. Ви можете бачити, що теоретично це як рішення для розміщення джерел в окрему JAR:

 jar {
     from sourceSets.main.allSource
 }

Різниця полягає в тому, що ви додаєте його до основного файлу JAR, кажучи "jar" замість sourceJar.

Розчин станом на Gradle 6.0

Якщо припустити, що ви використовуєте java/ java-libraryплагін з Gradle 6.0 або новішої версії, ви можете отримати sourcesJarзавдання, використовуючи таку конфігурацію:

java {
    withSourcesJar()
    // and/or analogously use “withJavadocJar()” to get a “javadocJar” task
}

Якщо ви додатково використовуєте maven-publish/ ivy-publishплагін (рекомендується сьогодні), то це також опублікує *-sources.jarартефакт разом з вашою основною публікацією на Java.

Дивіться також документи Gradle .

це має працювати

assemble.dependsOn 'propertyJar'

task propertyJar(type: Jar) {
 archiveName = "myJarName.jar"
 from('src/main/resources') {
    include '**'
 }}

DSL-еквівалент Kotlin буде таким:

tasks {

    val sourcesJar by creating(Jar::class) {
        dependsOn(JavaPlugin.CLASSES_TASK_NAME)
        classifier = "sources"
        from(java.sourceSets["main"].allSource)
    }

    val javadocJar by creating(Jar::class) {
        dependsOn(JavaPlugin.JAVADOC_TASK_NAME)
        classifier = "javadoc"
        from(java.docsDir)
    }

    artifacts {
        add("archives", sourcesJar)
        add("archives", javadocJar)
    }
}

При використанні:

• Оцінка: 5+
• javaта maven-publishплагіни

task sourceJar(type: Jar) {
    from sourceSets.main.allJava
    archiveClassifier = "sources"
}

publishing {
    publications {
        maven(MavenPublication) {
            from components.java
            artifact sourceJar
        }
    }
}

https://docs.gradle.org/current/dsl/org.gradle.api.publish.maven.MavenPublication.html