Kotlin Publish Plugin

A Gradle plugin to automatically setup source and javadoc jar publications for Kotlin projects. This is mainly useful for multi-project builds where this logic must be shared.

This plugin automatically applies maven-publish, and is meant to react to other plugins:

• If the Kotlin/JVM or Kotlin/JS plugin is applied, the Kotlin Publish plugin configures a Maven publication with code and sources jar, so it's on par with Kotlin/MPP (which does it by default)

• If the Dokka plugin is applied, this plugin sets up a dokkaJar task generating a javadoc jar which is added to all publications (the javadoc jar contains the Dokka HTML format, so it can work on other platforms than JVM)

• If the Github Info plugin is applied (ru.vyarus.github-info) in addition to Dokka, this plugin configures source links in Dokka to point to the sources in the Github repository.

This plugin also configures the POM of all Maven publications so they have a name and description matching the project or subproject to which this plugin is applied.

Usage

Apply the plugin to your project using the plugins block in your build.gradle(.kts):

plugins {
    id("org.hildan.kotlin-publish") version "<version>"
}

In multi-project builds, you should apply the plugin to every subproject for which you want to configure publications. You can avoid repetition by using Gradle conventions plugins.

There is no configuration for this plugin, all its functionality is automatic.

Example usage for Maven Central publication

In addition to what this plugin configures automatically, Maven Central requires:

• More information in the POM:
  • developer information
  • license (automatically handled by the Github Info plugin)
  • SCM (automatically handled by the Github Info plugin)
• Artifact signatures (can be done using the signing plugin)

Here is an example convention plugin that could be shared across subprojects:

buildSrc/src/main/kotlin/myproject-publish.gradle.kts:

plugins {
    id("org.hildan.kotlin-publish")
    id("org.jetbrains.dokka")
    id("ru.vyarus.github-info")
    signing
}

github {
   user = "joffrey-bion"
   license = "MIT"
}

// add the developer to every pom
publishing {
    // configureEach reacts on new publications being registered and configures them too
    publications.configureEach {
        if (this is MavenPublication) {
            pom {
                developers {
                    developer {
                        id.set("joffrey-bion")
                        name.set("Joffrey Bion")
                        email.set("[email protected]")
                    }
                }
            }
        }
    }
}

// sign publications to match Maven Central's expectations
signing {
    val signingKey: String? by project
    val signingPassword: String? by project
    useInMemoryPgpKeys(signingKey, signingPassword)
    sign(extensions.getByType<PublishingExtension>().publications)
}

This requires declaring the plugins as maven dependencies in buildSrc/build.gradle.kts:

plugins {
    `kotlin-dsl`
}

repositories {
    mavenCentral()
    maven(url = "https://plugins.gradle.org/m2/")
}

dependencies {
    implementation(gradleApi())
    implementation(gradleKotlinDsl())
   
    // Replace versions here according to your needs
    implementation(kotlin("gradle-plugin", "1.7.20")) // the Kotlin version used in the project
    implementation("org.jetbrains.dokka:dokka-gradle-plugin:1.7.20")
    implementation("org.hildan.gradle:gradle-kotlin-publish-plugin:0.2.0")
    implementation("ru.vyarus:gradle-github-info-plugin:1.4.0")
}

And can then be used in subprojects like this:

plugins {
   kotlin("multiplatform") // or kotlin("jvm") or kotlin("js")
   id("myproject-publish")
}

// no extra config required, just the rest of your build script for this project

Gradle compatibility

Kotlin Publish Plugin	Min Gradle version
1.5.0	8.6
1.4.0	8.5
1.3.0	8.4
1.2.0	8.2
1.0.0	8.0
0.2.0	7.6
0.1.0	7.5.1

License

This plugin is published under the MIT License.