LOUI development is best done in with the eclipse IDE. Java 5 and eclipse 3.5 are the minimum acceptable versions for development. Errors may occur on 4.x versions of eclipse. Using eclipse 3.8.2 is recommended. It is required to download the full Eclipse SDK (e.g. eclipse-SDK-3.5.2-macosx-cocoa-x86_64.tar.gz) from the eclipse download site. If one wants to create products for multiple platforms, downloading the eclipse Delta Pack and setting up a "Target Platform" would also be required.
Each required plugin which is not part of the standard eclipse SDK is in the source repository as its own project. Current list of required projects for the LOUI build project set are as follows:
The repository is subversion and it is on jumar. The connection url is svn://jumar.lowell.edu
Example checkout syntax from command line:
$ svn checkout svn://jumar.lowel.edu/edu.lowell.loui.nasa42/trunk edu.lowell.loui.nasa42
Create a new workspace and do the above checkouts and then do the following:
- Create
/opt/LOUI/directory for storing the configuration files Check out the whole tree for the config files
$ cd /opt/LOUI $ svn checkout svn://jumar.lowell.edu/LOUI_Configuration/trunk/dev .
- Edit the jndi.properties file in /opt/LOUI/(DESIRED LOUI(we reccomend lmi)) to point to the right machine and right broker.
One can either do the checkouts individually using an eclipse subversion plugin, such as subclipse, or use a shell script to do all the checkouts in one operation, or use the eclipse's Team Project Set.
The easiest and fastest way to build the workspace is to use Team Project Sets.
After you retrieve the required plugins, there are a few more libraries that need to be downloaded and installed. First is JUnit:
https://github.com/junit-team/junit/wiki/Download-and-Install
-Download the JAR file for the latest version.
-Put the JAR somewhere easily reached in your LOUI workspace.
-Find the plugins that require junit. This can be done most easily using the problems pane.
-navigate to that plug-in and right-click it.
-navigate through properties/java build path/libraries/add external JARs
-navigate to the junit JAR, and select it.
-Now, the project can access junit, but the manifest will require junit4.
-navigate to the project''s manifest (META-INF/MANIFEST.MF)
-in the manifest, find the junit4 requirement, and delete the 4.
Next is Eclipse Nebula. Instructions for installation can be found on the site.
https://eclipse.org/nebula/downloads.php
Lastly, you will need to accommodate for two imports that are deprecated and will be removed at some point.
Open classes edu.lowell.loui.common.util/SoundUtilities and edu.lowell.loui.common.view/InfoView
In both, comment out the imports for: javazoom.jl.decoder.JavaLayerException and com.gtranslate.Audio
In SoundUtilities, comment out the interior of PlayAlertSoundMp3(String soundFile).
In InfoView, comment out the interior of generateCustomSoundFile(SoundTypes type), then, directly after the comment, add the following statement:
return Platform.getLocation().toString() + "/custom" + type.toString() + "Sound.mp3";
Lastly, navigate to the project's Manifest and delete the gTranslate dependency.