Download & Installation of Shale

How to set up Shale using Eclipse - All Systems

These instructions are intended for the use on the Eclipse IDE for Java Developers Version 3.4.1.
  1. Download all files for the project.
    1. Download the Shale.zip file here
    2. Unzip Shale.zip in either:
      • your Eclipse workspace
      • somewhere that you will remember it's located (you will need to remember for Eclipse setup)
    3. Download the library directory, lib.zip, and unzip it in a subdirectory of your Shale project. Here you should find the following files:
      • core.jar
      • DSVL.dll
      • JMyron.dll
      • JMyron.jar
      • libJMyron.jnilib
      • librxtxSerial.jnilib
      • myron_ezcam.dll
      • RXTXcomm.jar
      • rxtxSerial.dll
      • serial.jar
      IF USING WINDOWS: Copy the JMyron.jar and libJMyron.jnilib into your C:\Windows\System32 directory.
  2. Create the Shale project in Eclipse.
    1. Open up Eclipse - be sure to select your workspace!
    2. Select File->New->Java Project to create a new project space for Shale. Type in 'Shale' as your project name. If you placed the Shale project folder somewhere besides your Eclipse workspace:
      • Select 'Create project from existing source' radio button, and click the 'Browse' button
      • when it allows you to to open up a Browse for Folder dialog box - navigate to the location where you unzipped Shale.zip and select OK.
    3. Select 'Finish' and the project folder will be ready for you in Eclipse.
  3. Set up the dependent library files.
    1. Navigate to the Package Explorer tab of Eclipse, and right-click on Shale. Select 'Build Path->Configure Build Path...' to open the Properties for Shale options box.
    2. Under the Source tab, select 'Shale/src' and then select the 'Native library location' property.
    3. Click on the 'Edit...' button to the right of the 'Shale/src' property window. This will open up a Native Library Folder Configuration dialog box, where you select the location path of the 'lib' directory downloaded earlier. It should be in the same path as that of your Workspace, but you can also select External Folder of you remember the path.
    4. Once you have selected the location of the 'lib' directory, click OK to return to the Properties for Shale options box.
    5. Under the Libraries tab, select the 'Add External JARs...' button, and navigate the JAR Selection dialog box to the location of the 'lib' directory, and select the following .jar files:
      • core.jar
      • JMyron.jar
      • RXTXcomm.jar
      • serial.jar
      Click OK. This will will add these external .jar files to your build path.
    6. For each of the following .jar files:
      • core.jar
      • JMyron.jar
      • RXTXcomm.jar
      • serial.jar
      In the 'JARs and class folders on the build path' window, select the .jar file and then select the 'Native library location' property. Repeat step 3.c for the .jar file, making sure the location path is directed towards the 'lib' directory. Select OK to return to the Properties for Shale options box.
    7. Deselect the 'Native library location' property - this will allow you to select the 'Add Library...' button - do this, and the Add Library dialog box will appear. Select JUnit from the options shown, and select Next. Make sure JUnit3 is selected as the library version, and click Finish. This will add the JUnit 3 library to your Shale project build path.
    8. Click OK to close the Properties of Shale options box.
  4. Set up the Shale run configurations.
    1. In the Package Explorer, select Shale, and navigate to the ShaleApplet.java file. Right-click on it, and select 'Run As->Run Configurations...' - this will open a Run Configurations options box.
    2. On the left-hand side, select the Java Applet configuration. Above and slightly to the left, there is a 'New launch configuration' icon. Click on it to create a new configuration for Shale.
    3. Rename it from 'New_configuration' to ShaleApplet or something like it that you recognize easily. In the main tab, select the 'Search...' button beside the Applet section under the Main tab. Choose 'ShaleApplet - ui' and click OK. It should look like this.
    4. Under the Arguments tab, select the VM Arguments box, and type: '-Djava.library.path="pathToJMyronLibrary"', where pathToJMyronLibrary is the direct path to the 'lib' directory mentioned earlier.
    5. Select Close, and this will close the Run Configurations option box.
  5. Build the project.
    1. Select Project->Clean... from the Eclipse menu, which opens a Clean options box. At this stage you can either clean all your projects. or choose to clean just the Shale project. Either way, make sure the 'Start a build immediately' checkbox is deselected. Click OK, and the Shale project will be cleaned.
    2. Select Project->Build Project from the Eclipse menu to re-build the Shale project.
  6. To run Shale, right-click the ShaleApplet.java file and select Run As->Run Configurations... and run the ShaleApplet configuration.


Return Home