Protégé 3.0 Build Instructions
Before building Protégé, you must have the following software installed on your system:
- The Java Development Kit (version 1.4 or higher). Make sure to set the JAVA_HOME environment
variable to the installation directory of your JDK.
- The Apache Ant Java-based build tool. See Apache's Web site
to download Ant. The download
includes installation instructions for all platforms. The Ant build script we distribute was developed
with Ant version 1.5.1. It should work on higher versions of Ant but has not been tested on previous
versions.
- JavaCC (version 2.1 only). JavaCC is available for
download through java.net.
Pertinent files in Protégé's source package:
| build.xml |
Ant build file |
| local.properties.template |
Properties file contaning variables used by the Ant build file |
| Parser.jj |
Grammar file used by JavaCC during the compile process |
| readme.html |
Build instructions |
| /docs |
Directory containing documentation |
| /lib |
Directory containing third party libraries needed to compile the Protégé source code |
| /src |
Directory containing the Protégé source code |
Steps for initiating a build:
- From the command line, change into the installation directory (where the Protégé source code was unzipped).
- Rename local.properties.template to local.properties. We added the ".template" extension so that
each time the source code is downloaded, the local.properties file is not overwritten which causes user defined
settings to be lost.
- Open local.properties and set the javacc.home variable to the location of your JavaCC installation directory.
- To start the build process, type "ant all".
When the build is finished, there are several resulting items:
| /classes |
Directory containing compiled Protégé source files |
| /dist |
Directory containing the newly generated Protégé JAR file as well as source and binary
distributions of Protégé packaged in ZIP format |
| /docs/apidocs |
Directory containing the newly generated Protégé API documentation (javadoc) |
It's also possible to run various parts of the build separately. For a list of available targets, type "ant" on the
command line.