Users generally don't need to build Geotk themself since snapshots are built and deployed on the Maven repository every day, and releases are deployed both on the Maven repository and on the download area. If nevertheless there is a need to build Geotk on a local machine, then this page describes the steps.
Project administrators may be interested in the release page instead.
The following free softwares must be installed on the local machine:
The following free softwares are optional. They are included in the Geotk dependencies for convenience, but installation on the local machine is recommended.
Gets the source code from the above-cited download area (if releases are sufficient) or from the Mercurial repository if the development version (snapshot) is wanted. In the later case, see the Source Repository page for more information.
The following branches are available on the Mercurial source code repository:
If the GeoAPI branch is wanted instead than the default one, execute the following command (available only if the source code was obtained from the Mercurial repository):
hg update GeoAPI-3.0
Make sure that the current directory is the project root directory, the one which contains the topermost pom.xml file. From this directory, execute the following command:
If the build fails with compilation errors, or if the execution fails with a throwable of kind java.lang.Error (for example NoSuchMethodError), or if you just want to be safe, try again with the following command:
mvn clean install --update-snapshots
If there is some test failures, or if you want to skip tests for a faster build, use:
mvn install -DskipTests
After a successful build, a copy of the Geotk JAR files will be located in the target/binaries directory together with every dependencies that are required at runtime.
Execute the following command from the same directory than above. It is recommended to run this command only after a successful build.
After a successful javadoc generation, the generated HTML pages will be located in the target/site/apidocs directory.