Installation

Adding Dependency

ⓘ

VersionWatch depends on the Java-Semver library.

In order to use VersionWatch you will need to download it and its dependency javasemver, using a BuildTool like Maven or Gradle. We also highly recommend relocating/shading the library into your own package.

Gradle Kotlin DSL

Add Repository

build.gradle.kts


repositories {
    mavenCentral()
}

Add Dependency

build.gradle.kts


dependencies {
    implementation("io.github.milkdrinkers:versionwatch:VERSION")
    implementation("io.github.milkdrinkers:javasemver:VERSION")
}

Shade Dependency

build.gradle.kts


plugins {
    id("com.gradleup.shadow") version "8.3.6"
}
 
tasks {
    shadowJar {
        relocate("io.github.milkdrinkers.versionwatch", "yourpackage.versionwatch")
        relocate("io.github.milkdrinkers.javasemver", "yourpackage.javasemver")
    }
}

Gradle Groovy

Add Repository

build.gradle


repositories {
    mavenCentral()
}

Add Dependency

build.gradle


dependencies {
    implementation 'io.github.milkdrinkers:versionwatch:VERSION'
    implementation 'io.github.milkdrinkers:javasemver:VERSION'
}

Shade Dependency

build.gradle


plugins {
    id 'com.gradleup.shadow' version '8.3.6'
}
 
tasks {
    shadowJar {
        relocate 'io.github.milkdrinkers.versionwatch', 'yourpackage.versionwatch'
        relocate 'io.github.milkdrinkers.javasemver', 'yourpackage.javasemver'
    }
}

Maven

Add Dependency

pom.xml


<dependency>
    <groupId>io.github.milkdrinkers</groupId>
    <artifactId>versionwatch</artifactId>
    <version>VERSION</version>
</dependency>
<dependency>
    <groupId>io.github.milkdrinkers</groupId>
    <artifactId>javasemver</artifactId>
    <version>VERSION</version>
</dependency>

Shade Dependency

pom.xml


<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <createDependencyReducedPom>false</createDependencyReducedPom>
        <relocations>
            <relocation>
                <pattern>io.github.milkdrinkers.versionwatch</pattern>
                <shadedPattern>yourpackage.versionwatch</shadedPattern>
            </relocation>
            <relocation>
                <pattern>io.github.milkdrinkers.javasemver</pattern>
                <shadedPattern>yourpackage.javasemver</shadedPattern>
            </relocation>
        </relocations>
    </configuration>
</plugin>

Well done! Next up have a look at the usage page.