Building Apache UIMA distributions

This page is out of date, not updated since 2017, and predates some major changes such as switching many projects to GIT from SVN. Please see the release.html page for current information.

This page describes how we build distributions for the 2.3.1 and later releases. See this page for information on building distributions for the 2.3.0 and prior releases.

Normally, distributions are built within the release activity; the documentation for that is here, and includes information on how to build and update the Eclipse update site, used for making our Eclipse plugins installable over the web. This page focuses on building distributions outside of a release.

Do the one-time-setup and the extra setup for GPG signing if you haven't already done this. The extra setup page also includes information on setting up for uploading (deploying) to apache infrastructure - you can skip that if you are not planning on doing that. It also includes information on setting some properties related to Eclipse - these are only needed for building the Eclipse update site.

Building the Apache UIMA Java SDK distribution

Get the code for the trunk or tag or branch (which ever one you want) from SVN:
mkdir /builduima  
cd /builduima
svn export https://svn.apache.org/repos/asf/uima/uimaj/trunk uimasdk
This checks out the trunk into the directory /builduima/uimasdk. These directory and folder names are arbitrary, and can be changed.

Build the source and binary distributions by doing:
cd uimasdk/uimaj
mvn package -Papache-release
This Maven command will also sign the release.

The build process for base UIMA Java SDK builds individual Jar files suitable for uploading into a Maven repository, and 2 assemblies (one for the source and one for the binary distributions). The individual Jar files are in the target directories of the individual projects they belong to. The source assembly is in the uimaj/target directory and the binary assembly is in the uimaj-distr/target directory.

Building Apache UIMA Addons distributions

The build process for Addons is similar:
mkdir /builduima
cd /builduima
svn export https://svn.apache.org/repos/asf/uima/addons/trunk addons
This checks out the trunk into the directory /builduima/addons.

Build the source and binary distributions by doing:
cd addons
mvn package -Papache-release
This Maven command will also sign the release.

The top level project contains in the target directory the generated source-release.zip archive, and the binary archives.