io.hkhc.gradle:jarbird-utils

Wrapping boilerplate code of publishing artifact to maven repository


Keywords
kotlin, gradle, maven, gradle-plugin, bintray
License
Apache-2.0

Documentation

Maven Central Gradle Plugin Portal

Components publishing is far too complicated

Publishing libraries to public repositories like Maven, Bintray are not really difficult at all, but it is a nuisance, especially for first-timer. Setting up accounts is a lengthy process, and we need to set our build script right so that those repositories accept our submission. By "right", we mean using proper plugins, declaring proper publication, and executing proper Gradle tasks. Once we have set up all those things, it is mostly "just work". So there is a significant fiction to make our components available in repositories rather than copy-and-paste among projects.

Worst still, the build script code to publish artefacts to Maven is quite different from the script for Bintray repository. We need a double effort if we want to publish to both repositories. It is possible to publish components to Maven Central by Bintray server, but that means vendor lock up.

The complete Gradle script to publish component is filled with boilerplate code. It is hard to read and the project-specific details are buried in the jungle of tasks and configurations.

“Jarbird” Gradle plugin is designed to make these things simple. Simply speaking, this plugin wraps up the boilerplate code to publish components to major public repositories, including Maven Central, Bintray/JCenter, Gradle’s own plugin repository. Its aim is making simple thing simple, so undoubtedly there are things that can be done by hand-coding the publishing code in Gradle build script, but cannot be done by this plugin. However, if things are really complicated, they deserve effort to do it in the good old way.

See more for Sample app repository for basic usage. And full documentation

What's new

See RELEASE.md