1.1 Integrate Maven Artifact

This tutorial will guide you through the process of integrating the NIMMSTA maven dependency into your project.

Requirements

• The minimum version is Java 8 (major version 52)
• The library is compiled using OpenJDK 8, make sure your JDK version is compatible
• Kotlin or Java (Kotlin is recommended)
• Credentials for the NIMMSTA Maven Repository
• Make sure to download and install the latest firmware bundle for this release from the B2B Portal
• Windows 10
• Gradle 6.0+ or Maven 3.6+ (Other versions might also work but have not been tested)

Credentials

To download the artifacts, you need access credentials to the NIMMSTA Repo.

You can get access credentials by asking your service partner or contact person at NIMMSTA.

Gradle

Note

If you have a root project gradle file, the maven repository needs to be added using the "allProjects" block.

build.gradle.ktsbuild.gradle

repositories {

    /* ... */

    mavenCentral()

    maven {
        url = uri("https://maven.goma-cms.org/repository/nimmsta-core-release/")
            credentials {
                username = "yourusername"
                password = "yourpassword"
            }
        metadataSources {
            mavenPom()
            artifact()
        }
    }
}

repositories {

    /* ... */

    mavenCentral()

    maven {
        url 'https://maven.goma-cms.org/repository/nimmsta-core-release/'
        credentials {
            username = "yourusername"
            password = "yourpassword"
        }
        authentication {
            basic(BasicAuthentication)
        }
        metadataSources {
            mavenPom()
            artifact()
        }
    } 
}

After you configured the repository, you can add the dependency.

build.gradle.ktsbuild.gradle

dependencies {

    /* ... */

    implementation("com.nimmsta.core:shared-jvm:6.0.+") {
        isTransitive = true
        isChanging = true
    }
}

dependencies {

    /* ... */

    implementation('com.nimmsta.core:shared-jvm:6.0.+') {
        transitive = true
        changing = true
    }
}

Maven

First you need to add a settings.xml file in your .m2 folder. The .m2 folder is usually located under C:\Users\Username\.m2. If the folder is not present, create it first.

settings.xml

<settings>
    <servers>
        <server>
            <id>nimmsta</id>
            <username>yourusername</username>
            <password>yourpassword</password>
        </server>
    </servers>
</settings>

Afterwards you can add the required dependency to your pom.xml.

pom.xml

<project>

    <!-- ... -->

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <java.version>1.8</java.version>
        <kotlin.version>1.4.30</kotlin.version>
    </properties>

    <repositories>
        <repository>
            <id>nimmsta</id>
            <url>https://maven.goma-cms.org/repository/nimmsta-core-release/</url>
            <name>nimmsta</name>
        </repository>
        <repository>
            <id>central</id>
            <name>Maven Repository Switchboard</name>
            <url>https://repo1.maven.org/maven2/</url>
        </repository>
    </repositories>

    <pluginRepositories>
        <pluginRepository>
            <releases>
                <updatePolicy>never</updatePolicy>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
            <id>central</id>
            <name>Maven Plugin Repository</name>
            <url>https://repo1.maven.org/maven2</url>
        </pluginRepository>
    </pluginRepositories>

    <dependencies>
        <dependency>
            <groupId>com.nimmsta.core</groupId>
            <artifactId>shared-jvm</artifactId>
            <version>5.0.3450</version>
            <exclusions>
                <exclusion>
                    <groupId>org.jetbrains.kotlin</groupId>
                    <artifactId>kotlin-stdlib</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.jetbrains.kotlin</groupId>
                    <artifactId>kotlin-stdlib-common</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.jetbrains.kotlinx</groupId>
                    <artifactId>kotlinx-serialization-json</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.jetbrains.kotlinx</groupId>
                    <artifactId>kotlinx-serialization-core</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-stdlib-jdk8</artifactId>
            <version>${kotlin.version}</version>
        </dependency>

        <dependency>
            <groupId>org.jetbrains.kotlinx</groupId>
            <artifactId>kotlinx-coroutines-core-jvm</artifactId>
            <version>1.4.2</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.jetbrains.kotlin</groupId>
                <artifactId>kotlin-maven-plugin</artifactId>
                <version>${kotlin.version}</version>
            </plugin>
        </plugins>
    </build>

    <!-- ... -->

</project>