Building

Build requirements

Currently, Conman’s Dictionary requires Apache Maven to build and run. Maven will fetch and install all of the external stuff you need to get the program up and running.

It also requires that you have a properly installed copy of GNU gettext. On Linux, this is old hat. Getting it to work properly in Windows is slightly tricky but entirely doable. I’ll probably put the pointers here someday.

I already have Maven! How do I run the program?

  • Check out master: git clone https://git.gitorious.org/conmandictionary/conmandictionary.git ConmanDictionary
  • cd ConmanDictionary
  • You may want to clean it, but this isn’t strictly necessary: mvn clean
  • Build the translations: mvn gettext:dist – this is not your average Maven step, but it is mandatory!
  • Build the package and install it to your repository: mvn install
  • Running the actual program: mvn exec:java or cd target; java -jar target/ConmanDictionary-WHATEVER.jar

Or in other words, to build the program in one fell swoop:

mvn clean gettext:dist install

…and look at the .jar file either in target directory or in your local Maven repository (~/.m2/). It’s a “shaded” “überjar”. In other words, you can just run it with java -jar whatever.jar.

Eh… I don’t have Maven! Where are the binaries?

Maven builds a “shaded” JAR file which includes everything you need to run the app. I’ll probably stick this thingy somewhere. One day.