Introduction

The JS7 js7 repository holds the source code to build for building the JS7 Controller and JS7 Agent.

...

The JS7 Controller and Agent are implemented with Scala and have to be build built with sbt (Scala Build Tool). SOS uses sbt version 1.1.5 with sbt_script version 1.4.2.

...

Determine the latest tagged version and store it to as a local variable.

tag=$(git describe --tags `git rev-list --tags --max-count=1`)

Checkout the latest version using the just stored variable to a local branch "latest" using the variable you have just stored.

git checkout $tag -b latest

...

Navigate to the root of the cloned repository that you checked out.

Simple Compile

The project will be locally built. The resulting binaries will not be published in any repository.

./sbt-batch clean-all compile

Build With Tests

To build the project with all tests running use compile-all instead.

./sbt-batch clean-all compile-all

Build and Publish to a local M2 Repository

This is the recommended way to build JS7 as the resulting binaries are automatically published in a local /.m2 repository and are available for further builds (e.g. sos-components).

./sbt-batch clean-all compile publishM2

If an already checked out tag is being built again then it will throw the error: java.io.IOException: PUT operation failed because the destination file exists and overwriting is disabled. To solve this error it is necessary to clear/delete the local [USER_HOME]/.m2/repository/com/sos-berlin/js7 folder before the build.

Note: It is not necessary to clear/delete the folder if a new tag is checked out and build for the first time.

Build and Publish to a Binary Repository

The credentials required to deploy to a binary repository have to be available from a credentials file, see https://www.scala-sbt.org/1.x/docs/Publishing.html#Credentials for more information.

Set the repository credentials and repository URI for the build to an environment variable with the name SBT_OPTS.

...