imcjava

Java bindings for IMC.

Generate Messages

IMC.xml resides in conf/imc/ imcjava supports multiple IMC versions.

Use ./gradlew generate to create the bindings.

Publishing

Automated Publishing (CI/CD)

This repository includes a GitHub Actions workflow that automatically publishes to GitHub Packages when:

• A new release is created
• The workflow is manually triggered

The workflow runs on every release and authenticates automatically using the GITHUB_TOKEN secret.

Publish to GitHub Packages

To publish to GitHub Packages, you need to authenticate with your GitHub credentials:

./gradlew publish -Pgpr.user=YOUR_GITHUB_USERNAME -Pgpr.token=YOUR_GITHUB_TOKEN

Or set environment variables:

export GITHUB_ACTOR=YOUR_GITHUB_USERNAME
export GITHUB_TOKEN=YOUR_GITHUB_TOKEN
./gradlew publish

This will publish the artifacts to: https://maven.pkg.github.com/oceanscan/imcjava

Publish to Local Maven Repository

Use ./gradlew publishToMavenLocal to test locally.

Using the Published Package

Add the GitHub Packages repository to your build.gradle:

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/oceanscan/imcjava")
        credentials {
            username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_ACTOR")
            password = project.findProperty("gpr.token") ?: System.getenv("GITHUB_TOKEN")
        }
    }
}

dependencies {
    implementation 'pt.lsts:imcjava:5.5.5-unify'
}

For Maven users, add to your pom.xml:

<repositories>
    <repository>
        <id>github</id>
        <url>https://maven.pkg.github.com/oceanscan/imcjava</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>pt.lsts</groupId>
        <artifactId>imcjava</artifactId>
        <version>5.5.5-unify</version>
    </dependency>
</dependencies>

And configure authentication in ~/.m2/settings.xml:

<servers>
    <server>
        <id>github</id>
        <username>YOUR_GITHUB_USERNAME</username>
        <password>YOUR_GITHUB_TOKEN</password>
    </server>
</servers>