To build Σοφία from the source provided in the SofyaForJava Git repository you will need to obtain the JavaCC library package, which is available here.
The package is structured to allow import into the Eclipse IDE for Java environment, although you may need to experiment a bit to import it. Once imported into Eclipse, you can then modify the project settings to reference the BCEL and JavaCC libraries. As noted in the installation guide, the provided version of BCEL 6.0 may be used or the most recent BCEL version from the Apache Commons site. We made changes to the BCEL 6.0 version supplied allowing it to work correctly with Java 7 class files, but we have not determined if these changes were implemented in the latest BCEL version.
As with most Eclipse projects, Σοφία uses the Ant build environment, which comes standard with Eclipse. If you build outside of the Eclipse environment you will need the Ant package installed as a command line tool which is available from Apache Commons.
The provided build.xml targets are:
initProps | Sets environment and Ant properties for JavaCC |
init | Iniitalize the ant properties and build output directory |
compile | The compilation step, builds the EDL parser using JavaCC and the Java classes from the Sofya sources |
build | performs the compile and build-docs targets |
jar-bin | Creates the jar-file of Sofya binaries/classes |
jar | Builds the jar-files of both binary and source-code |
clean | Cleans/removes the existing Sofya class and jar files |
build-docs | Builds the API JavaDocs for the Sofya tool classes |
If you make substatial changes to Sofya and would like to offer them through our repository on GitHub please contact one of the SofyaTool project members. We welcome anyone who wants to contribute to supporting or enhancing the tool kit.
Author: Wayne Motycka © 2018 University of Nebraska - Lincoln.
Page last updated by Wayne Motycka: 08/29/2018