1. Installation

2. Build from Source

3. Start JDLabStudio

1. Installation


Download the jdlabstudio-1.x.x package from


http://sourceforge.net/projects/jdlabstudio


and extract it.


>gzip –d jdlabstudio-1.0.1.tar.gz

>tar xvf jdlabstudio-1.0.1.tar


The executable files and libraries are located in the directory jdlabstudio-1.x.x


jdlabstudio-1.0.1>ls -ltr

total 1462

-rwxrwxrwx 519173 Jan 14 2005 jclasslib.jar

-rwxrwxrwx 17990 Apr 28 2006 LICENSE

-rwxrwxrwx 443876 Nov 1 22:41 antlr.jar

-rwxrwxrwx 514977 Jan 26 22:44 jdlabstudio.jar

-rwxrwxrwx 2407 Jan 26 22:47 README.txt

drwxrwxrwx 0 Jan 29 09:18 examples


2. Build from Source


Prerequisites:


1) Download the jdlabstudio-src-1.x.x package from


http://sourceforge.net/projects/jdlabstudio


and extract it.


>gzip –d jdlabstudio-src-1.0.1.tar.gz

>tar xvf jdlabstudio-src-1.0.1.tar

>cd jdlabstudio-src-1.0.1

>ls -ltr

total 21

-rwxrwxrwx 17990 Apr 28 2006 LICENSE

-rwxrwxrwx 3496 Jan 26 15:31 build.xml

-rwxrwxrwx 1054 Jan 26 21:48 README.txt

drwxrwxrwx 0 Jan 29 09:18 src

drwxrwxrwx 0 Jan 29 09:18 examples


2) Download jclasslib.jar library from

http://sourceforge.net/projects/jclasslib

and copy the downloaded jar-file to $JAVA_HOME/jre/lib/ext or include it into CLASSPATH.


Note: Version 3.0 of jclasslib.jar produced on January 14, 2005 was used for developing of the JDlabStudio.



3) Download ANTLR from

http://www.antlr.org/download.html


and copy the downloaded jar-file to $JAVA_HOME/jre/lib/ext or include it into CLASSPATH.


Note; antlr-2.7.7 (released November 1, 2006) was used for developing of the JDLabStudio


4) Download and intstall Java-based build tool Apache Ant from and install it.

http://ant.apache.org/



Build the package:


jdlabstudio-1.0.1-src>ant

Buildfile: build.xml


init:

[mkdir] Created dir: jdlabstudio-1.0.1-src\build


runANTLR:


makeVersionFile:


compile:

[javac] Compiling 242 source files to jdlabstudio-1.0.1-src\build

[copy] Copying 38 files to jdlabstudio-1.0.1-src\build\org\jdlab\gui\images


dist:

[mkdir] Created dir: jdlabstudio-1.0.1-src\distribution

[jar] Building jar: jdlabstudio-1.0.1-src\distribution\jdlabstudio.jar


BUILD SUCCESSFUL

Total time: 8 seconds



To start JDlabStudio from package

> ant run


To load workspace examples set enviroment variable JDLAB_HOME as command line property

> ant run -DJDLAB_HOME=<example directory>


For example:

> ant run -DJDLAB_HOME="./examples"

or

>java -DJDLAB_HOME="../examples" -jar jdlabstudio.jar



3. Start JDLabStudio


To start JDlabStudio for Unix:

>java -cp jdlabstudio.jar:antlr.jar:jclasslib.jar org.jdlab.gui.JDLabStudioApplication


for Windows:

>java -cp jdlabstudio.jar;antlr.jar;jclasslib.jar org.jdlab.gui.JDLabStudioApplication

or from jar file:

>java -jar jdlabstudio.jar


NOTE: Don’t forget to include libraries to CLASSPATH



To load workspace examples set enviroment variable JDLAB_HOME as command line property

> java -DJDLAB_HOME=<example directory>


For example:

>java -cp jdlabstudio.jar;antlr.jar;jclasslib.jar -DJDLAB_HOME="./examples" org.jdlab.gui.JDLabStudioApplication


or

>java -DJDLAB_HOME="./examples" -jar jdlabstudio.jar