These steps will help you set up jABC4 and install all required software.
JRE or JDK
For the jABC4 you need a JRE (Java Runtime Environment) for Java 7 or Java 8 installed on your computer. If you already have a JRE or a JDK (Java Development Kit) you can proceed to the next section.
- Download a JRE for example from the Oracle website.
- Install the JRE, you can follow the official guides for Windows, Linux and Mac installation.
- After installing the JRE, make sure that your JAVA_HOME environment variable is set to the installation folder, following step two of this guide by Oracle.
Please note, that in order to generate Java code from jABC4 graph models a JRE is not sufficient and you will instead require a JDK.
jABC4
- download the current jABC4 installer here
- install the jABC4 by executing the installer file with the previously installed Java. Should you use a Windows OS that prevents you to install into your default programs folder, choose another location such as your user folder.
After the installation, your jABC4 is completely set up and ready to be used. It already contains a first project which is targeted in the Basic Modeling Tutorial.
Please note: Currently there is an issue with the installation under Windows that may occur when installing jABC4 into a location that contains a space in the path, such as C:\Users\User Name\jABC4
. If you use a Windows OS, please make sure to choose an installation path without space characters.
Maven (optional)
Some users may want to use Maven for their projects, which allows to include dependencies to external repositories containing graphs or source code files via Maven to make them available for modeling. Since this can also be achieved by adding the respective jars to a project classpath, Maven is not required for using jABC4.
To set up Maven and use it with jABC4
- download Maven from the Apache website
- install Maven
- after installing set the
MAVEN_HOME
environment variable. For help with this follow documentation like this guide for Windows - start your jABC4
In jABC4, click Plugins → jABC4-Plugin → Choose ‘mvn’ dist folder… and browse to the folder containing Mavens’ bin folder, conf folder, lib folder etc. Click Open and close your current project. If your project contains a validpom.xml
, Maven will recognize it upon opening the project again.