Σοφία Build Instructions

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:

initPropsSets environment and Ant properties for JavaCC
initIniitalize the ant properties and build output directory
compileThe compilation step, builds the EDL parser using JavaCC and the Java classes from the Sofya sources
buildperforms the compile and build-docs targets
jar-binCreates the jar-file of Sofya binaries/classes
jarBuilds the jar-files of both binary and source-code
cleanCleans/removes the existing Sofya class and jar files
build-docsBuilds 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