oshai / kobalt

A Kotlin-based build system for the JVM.

Kobalt

Kobalt is a universal build system.

Getting Started

Install Kobalt

Manually

1. Download zip file (ie `kobalt-1.1.7.zip).
2. Run from terminal:

mkdir -p ~/kobalt
cd yourLocation
unzip kobalt-1.1.7.zip
mv kobalt-1.1.7 ~/kobalt/
export PATH=~/kobalt/kobalt-1.1.7/bin:$PATH
chmod +x ~/kobalt/kobalt-1.1.7/bin/kobaltw
# also need it in cache ATM, until download is fixed
mkdir -p ~/.kobalt/wrapper/dist
cp kobalt-1.1.7.zip ~/.kobalt/wrapper/dist/

Initialize your project

Change to your project directory and call the kobaltw command with --init:

• To initialize a Java project:

cd ~/java/project
kobaltw --init java

• To initialize a Kotlin project:

cd ~/kotlin/project
kobaltw --init kotlin

References

• beust docs: https://beust.com/kobalt/home/index.html

Contribution

To build kobalt:

./kobaltw assemble

To release a new version:

• Add local.properties file:

# kobalt will be released to https://github.com/oshai/kobalt/releases/latest
github.username=oshai  
# from https://github.com/settings/tokens
github.accessToken=xxxxx

• Update version number in src/main/resources/kobalt.properties.
• Build:

./kobaltw assemble

• Use locally:
  • cp kobaltBuild/libs/kobalt-xxx.zip ~/.kobalt/wrapper/dist/
  • Update kobalt/wrapper/kobalt-wrapper.properties in target project.
• Publish to github:

./kobaltw uploadGithub