The following documentation is about developing LSC itself - not a LSC synchronization task. Make sure you’ve read all the general documentation before continuing here!
As well as the general Requirements, you need some extra tools to hack LSC - make sure you match these requirements:
Java Virtual Machine (JDK) >= 1.8
Maven >=2 (Maven 3 recommended)
Add the mvn command line wrapper to Maven in your path (through
~/.bashrcor something equivalent)
You can use Eclipse, NetBeans,… to edit the Java code. Integrating LSC and its Maven dependencies is described here.
You should follow our defined code style.
Java API for LSC-core¶
The JavaDoc is generated from comments in LSC code. It needs a lot of improvement, all comments in code are very welcome!
You can find LSC on GitHub: https://github.com/lsc-project. There you can fill bugs, see the history of commits,…
Tests are run through Maven.
Run all tests (opendj profile required) :
mvn -Popendj test
Run one test, named MyTest (note: don’t put in the classpath here, write
mvn -Popendj -Dtest=MyTest test
Don’t run tests:
mvn -Dmaven.test.skip=true someOtherTarget
Various builds can be done :
the standard build requires OpenDJ to run tests.
mvn -Popendj clean package
the light build does not require OpenDJ but you must skip tests:
mvn -Dmaven.test.skip=true clean package
a build including PostgreSQL jar (can be with or without OpenDJ)
mvn -Ppostgresql -Popendj clean package