Maven to gradle Migration


I am not a big fan of gradle but still this time i am taking this topic.

Maven pom file is xml based build file and Gradle is groovy based system. There are many logic involve to make one to one comparison of generic features. I would like take some generic logic and try to detail out on converting those from maven pom file to gradle build file.


  • Setup Modules
  • define repositories
  • upload of artifacts to maven repository
  • Profiling
    • jacoco test report
  • use of release plugin




Setup Modules

A multi-project build can have an arbitrary directory structure, Which can be configured in settings.gradle. The information in settings.gradle tells Gradle which subprojects are part of this build, what their logical and physical paths are, how their build scripts are named, etc. It does not, and cannot, tell Gradle what the dependencies between the subprojects are.
Like
include 'abc'
include 'xyz'
include 'pqr'

Define Repositories


allprojects {

     afterEvaluate { project ->
        def javaProject = project.plugins.hasPlugin('java')
        repositories {
            maven {
                name "public"
                url "https://apache.maven.com/public/"
            }
            maven {
                name "release"
                url "https://your-maven-repo.com/releases/"
            }
            maven {
                name "snapshot"
                url "https://your-maven-repo.com/snapshots/"
            }
            mavenLocal()
            mavenCentral()


         }
}


upload of artifacts to maven repository


Maven reads the pom.xml to identify the groupID, artifactId and version number. You need to specify these values explicitly to gradle.
Create a file called gradle.properties. This file contains the information about your project metadata like groupid, version etc.. Here are the entries (values are just example).
version=0.1.5
group=com.xyz
packaging=jar
artifactid=abc
gradle build file entry

allprojects {

 apply plugin: 'maven'

 afterEvaluate {
  uploadArchives {
    repositories {
        mavenDeployer {
            pom.packaging = project.packaging
            pom.groupId = project.group
            pom.version = project.version
            pom.artifactId = project.artifactid
             if(project.version.endsWith('-SNAPSHOT')) {
                repository(url: 'https://your-maven-repo.com//snapshots') {
                authentication(userName: repoUsernameProp, password: repoPasswordProp);
            }
            }
            else {
                repository(url: 'https://your-maven-repo.com//releases') {
                authentication(userName: repoUsernameProp, password: repoPasswordProp);
            }
            }
        }
      }

     }
}
}

Either your can directly provide the username and password of the maven repo to upload the file or use the variable and store it in gradle.properties in ~/.gradle folder. Values for this file would be simple key=value parameter.

Use "upload" as task to upload artifact to maven repo with above configuration.


Profile

If you want to activate some profile with the gradle build, You can add the profile check with following option for java project

allprojects {

         if (project.hasProperty("dev-profile")) {
   <Do your stuff>
        }
     }
}

You can call the profile with -Pdev-profile.

lets take example, If you want to activate jacoco coverage with the profile.


  if (project.hasProperty("dev-profile")) {

                 project.apply plugin: 'jacoco'

                 jacoco {

                     ext.version = "0.8"
                }

                 jacocoTestReport {

                     sourceDirectories = files('src/java')
                    classDirectories = files('build/classes/main')
                }

             }



M2 Release plugin


If you are using maven release plugin to perform release build like "mvn release:prepare release:perform". This is very handy and easy to use plugin to perform release job which takes care of tagging, increment version etc.

You may want to use similar way for gradle build too. Here is the way you can achieve it.

I would suggest to use researchgate plugin for same purposes. There are few alteration but it is most closer to the m2 release plugin.

Plugin source - https://github.com/researchgate/gradle-release
Plugin documentation is very much clear and detail, I would still like to provide some information which can be useful.

Add following entry in your build.gradle to support release plugin
plugins {
id 'net.researchgate.release' version '2.0.2'
}
apply plugin: 'net.researchgate.release'
apply plugin: 'maven'
createReleaseTag.dependsOn allprojects.uploadArchives
Add these configurations too

allprojects {

     apply plugin: 'maven'

   afterEvaluate {
    uploadArchives {
        repositories {
            mavenDeployer {
                pom.packaging = project.packaging
                pom.groupId = project.group
                pom.version = project.version
                pom.artifactId = project.artifactid
                repository(url: 'http://your-repo/releases') {
                    authentication(userName: repoUsernameProp, password: repoPasswordProp);
                }

             }
        }
    }
  }
}

Create a file called gradle.properties. This file contains the information about your project metadata like groupid, version etc.. Here are the entries (values are just example).
version=1.0
group=com.xyz
packaging=jar
artifactid=abc
This file will be used by the plugin to identify the group id, artifact id, version etc to upload it to maven repo.

Difference between M2 plugin and this plugin are



  • Only the root|parent project is applying the plugin
  • Only one version is used for root and sub projects
  • Snapshot is not needed in gradle release plugin.


    • The ultimate command which you may need to run for the release job may be

    gradle release -Pgradle.release.useAutomaticVersion

    gradle wrapper v/s gradle executable

    To use gradle for your project you can download the Gradle distribution and install it on our machine. But maybe you want to share our project with other people or want to run on various systems that don't have Gradle installed. Then we can use the Gradle wrapper. The wrapper is responsible for downloading the Gradle distribution and making it available for our project.


    Auto Mavne to gradle conversion


    There a tool available to convert your pom.xml to builod.gradle
    https://github.com/jbaruch/maven2gradle

    There is build init project within gradle is going on to take care of this migration
    https://docs.gradle.org/current/userguide/build_init_plugin.html

    Comments

    Post a Comment

    Popular posts from this blog

    Colour formatting - Jenkins Console

    Image
    Jenkins is the main CI tool used in Software industry. This is the backbone tool for all CI and CD implementation, Build - release and deployment methods. With the help of 100s of plugin available around the jenkins, We can achieve so much of automation around build process including build/deployment pipeline, notification, analysis, pre and post build action etc. Jenkins has tremendous power to perform great amount of work around the core build process. Many time we write script in pre and post build action to perform many tasks which is becoming very command and necessary for automation. But the main limitation in running shell script is that it's very difficult to make it more human readable for errors and make it fancy. Today i am going to cover some steps to make the output of shell script colour formatted. Jenkins Configuration Steps First install following jenkins plugin https://wiki.jenkins-ci.org/display/JENKINS/AnsiColor+Plugin Go to jenkins configurati...
    Read more

    Manage Docker images on local disk

    Docker is very powerful containerization technique, and it is becoming famous in short time. People are adapting and containerizing their applications for deployment. Soon container become very heavy and consume too much of disk space, If you do not delete old images and layers you may soon run out of disk space. Here i am trying to cover the ways to regain the disk space consumed by docker images. Moving docker filesystem to bigger mount point. Usually docker keeps all temporary files related to image building and layers at /var/lib/docker This path is local to the system usually at root partition "/" . You can mount a bigger disk space and move the content of /var/lib/docker to the new mount location and make sym link.  This way even docker images occupy space, will not affect  your system as it will be using some other mount location. Remove Old docker images Here are few ways to remove old and unused docker images Removing stopped contai...
    Read more

    How to migrate Parent pom from maven to gradle

    Convert Maven parent/super pom to Gradle init file When you think of moving to gradle for some reason from maven, You need to take care of lot of stuff around it, You can find lot of tools and help to convert maven pom.xml to gradle build.gradle But one of the most important task as an engineer or architect would be to convert your super pom (or parent pom) in to gradle init scripts. Gradle init script provides same functionality as Maven super/parent pom. The basic difference is that you can call init script Run time As many as of them This gives us flexibility to change the init script on run time but doubt of not tracking the changes.
    Read more