Comment créer un pot de sources avec Gradle

Je travaille avec un projet open source construit avec gradle. Je voudrais générer un fichier (projet) -sources.jar que je peux charger dans mon IDE (IntelliJ IDEA) et déboguer via le projet. Je sais comment charger le fichier si je peux le générer.

J'ai regardé à travers les tâches de gradle disponibles pour le projet et il n'y en a pas une qui génère un fichier jar sources.

Quelle est la manière la plus simple de générer un fichier jar sources pour ce projet?

L'ajout de la source dans le fichier jar contenant les fichiers de classe compilés serait également très bien.

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
}

Si vous utilisez 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
}

d' ici

Si vous souhaitez ajouter les sources au fichier JAR des classes compilées , ce que vous avez également dit serait acceptable, vous pouvez le faire assez facilement. Ajoutez simplement ce qui suit à votre fichier de construction. Vous pouvez voir que, en théorie, c'est tout à fait comme la solution pour mettre des sources dans un JAR séparé:

 jar {
     from sourceSets.main.allSource
 }

La différence est que vous l'ajoutez au fichier JAR principal en disant "jar" au lieu de sourcesJar.

Solution à partir de Gradle 6.0

En supposant que vous utilisez le plugin java/ java-libraryavec Gradle 6.0 ou version ultérieure, vous pouvez obtenir une sourcesJartâche en utilisant la configuration suivante:

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

Si vous utilisez en plus le plugin maven-publish/ ivy-publish(recommandé de nos jours), cela publiera également un*-sources.jar artefact avec votre publication Java principale.

Voir aussi la documentation Gradle .

cela devrait fonctionner

assemble.dependsOn 'propertyJar'

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

L'équivalent DSL Kotlin serait:

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)
    }
}

Lors de l'utilisation:

• Niveau: 5+
• javaet maven-publishplugins

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