Version 2.0 is under development, use it at your own risk.
POP-Java can be used in a Java application in 2 ways. Either way, when running your application you need to add the pop-java.jar file as the jvm javaagent when launching:
Compile the pop-java jar file
$ ./gradlew fatJar
Add the created jar to the classpath of your project.
Add the following to your pom.xml:
<dependency>
<groupId>ch.icosys</groupId>
<artifactId>popjava</artifactId>
<version>2.0.0</version>
</dependency>
$ ./gradlew prepareRelease $ ./install
You might use sudo or to be root tu execute "make install" if you do not have the right to write in the destination folder.
The installation script will ask you several questions. Here they are:
- Please enter the location of your desired POP-Java installation (default: /usr/local/popj ) :
If unsure leave the answer blank to keep the default setting.
By using the command below you will build and test the latest version of POP-Java.
$ ./gradlew build
In case you don't want to wait you can skip the JUnit test by running the following command.
$ ./gradlew build -x test
Do not forget to add these lines to your .bashrc file or equivalent : If you have kept the default options this should give you something like:
POPJAVA_LOCATION=/usr/local/popj export POPJAVA_LOCATION POPJAVA_JAVA=/usr/bin/java export POPJAVA_JAVA PATH=$PATH:$POPJAVA_LOCATION/bin
Depending on the environment you use you may want to use different IDE, or none at all. Gradle can setup the environment for different platforms.
Go in the project root and generate the Eclipse project files.
$ ./gradlew eclipse
You now should be able to open POP-Java as a Java project.
Go in the project root and generate the IntelliJ project files.
$ ./gradlew idea
You now should be able to open POP-Java as a Java project.
Open the project as a Gradle project. Nothing more should be required.
POP-Java is licenced under LGPL v3
- The user manual http://pop-java.readthedocs.io/en/latest/