# jna-build

**Repository Path**: mirrors_elastic/jna-build

## Basic Information

- **Project Name**: jna-build
- **Description**: Build of jna with native bits for all elastic supported platforms
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2025-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Elasticsearch JNA Build
=======================

This project exists in order to build a jna jar which supports
platforms supported by Elastic. We strip out native libraries
for platforms that we do not support.

Publish to Maven Central (Normal case)
--------------------------------------

In the default case, we track with upstream JNA.  This is when the
local version exactly matches net.java.dev/jna.

First set shell variables for convenience:

    # match whatever's in build.gradle
    export VERSION=$(sed -e $'/^String upstreamVersion/!d; s/.*\'\\(.*\\)\'$/\\1/' build.gradle)
    echo $VERSION # should look like 5.10.0

Note that when upgrading the jna version, the `upstreamVersion` variable 
in the build file should be updated too.

Ensure you have the OSSRH Sonatype staging environment set up in
`~/.m2/settings.xml`:

    <server>
      <id>sonatype-nexus-staging</id>
      <username>user</username>
      <password>pass</password>
    </server>

Then build:

    % gradle assemble

In order for OSSRH to accept the package, it must have sources and
javadoc jars as well.  We don't have any automation here to build
them, so simply reuse from net.java.dev/jna:

    % curl -L -o build/jna-${VERSION}-sources.jar \
      https://oss.sonatype.org/content/repositories/releases/net/java/dev/jna/jna/${VERSION}/jna-${VERSION}-sources.jar
    % curl -L -o build/jna-${VERSION}-javadoc.jar \
      https://oss.sonatype.org/content/repositories/releases/net/java/dev/jna/jna/${VERSION}/jna-${VERSION}-javadoc.jar

Now upload to OSSRH, signing with the Elasticsearch key (it will
prompt for passphrase, or if desperate you can use -Dgpg.passphrase
but please try to avoid):

    % mvn gpg:sign-and-deploy-file \
        -DgroupId=org.elasticsearch \
        -DartifactId=jna \
        -DgeneratePom=false \
        -Dpackaging=jar \
        -DrepositoryId=sonatype-nexus-staging \
        -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ \
        -DpomFile=build/distributions/jna-${VERSION}.pom \
        -Dfile=build/distributions/jna-${VERSION}.jar \
        -Dsources=build/jna-${VERSION}-sources.jar \
        -Djavadoc=build/jna-${VERSION}-javadoc.jar \
        -Dgpg.keyname=D88E42B4


Publish to Maven Central (With only local modifications)
--------------------------------------------------------

Sometimes we may need to publish a jar that has local modifications
when there hasn't been an upstream release.  See for example
[4.4.0-1][example-release].  The instructions are almost identical,
but we introduce a `suffix`.

Set shell variables for convenience:

    # Match whatever's in build.gradle
    export VERSION=$(sed -e $'/^String upstreamVersion/!d; s/.*\'\\(.*\\)\'$/\\1/' build.gradle)
    echo $VERSION

    # Start at 1, but this may be incremented to whatever makes sense
    export SUFFIX="-2"

Then build the artifact and pom as usual, but supply `version.suffix`
property:

    % gradle assemble -Dversion.suffix=$SUFFIX

In order for OSSRH to accept the package, it must have sources and
javadoc jars as well.  We don't have any automation here to build
them, so simply reuse from upstream net.java.dev/jna:

    % curl -L -o build/jna-${VERSION}${SUFFIX}-sources.jar \
      https://oss.sonatype.org/content/repositories/releases/net/java/dev/jna/jna/${VERSION}/jna-${VERSION}-sources.jar
    % curl -L -o build/jna-${VERSION}${SUFFIX}-javadoc.jar \
      https://oss.sonatype.org/content/repositories/releases/net/java/dev/jna/jna/${VERSION}/jna-${VERSION}-javadoc.jar

Now upload to OSSRH, signing with the Elasticsearch key:

    mvn gpg:sign-and-deploy-file \
      -DgroupId=org.elasticsearch \
      -DartifactId=jna \
      -DgeneratePom=false \
      -Dpackaging=jar \
      -DrepositoryId=sonatype-nexus-staging \
      -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ \
      -DpomFile=build/distributions/jna-${VERSION}${SUFFIX}.pom \
      -Dfile=build/distributions/jna-${VERSION}${SUFFIX}.jar \
      -Dsources=build/jna-${VERSION}${SUFFIX}-sources.jar \
      -Djavadoc=build/jna-${VERSION}${SUFFIX}-javadoc.jar \
      -Dgpg.keyname=D88E42B4


[example-release]: http://search.maven.org/#artifactdetails%7Corg.elasticsearch%7Cjna%7C4.4.0-1%7Cjar