Getting started with the LDSTech IDE (Java WebApp platform)
Download and install the Sun JDK
- Download the latest Oracle/Sun Java Platform, Standard Edition Java Development Kit (JDK) Version 7.
- Install the JDK following the instructions on the JDK website.
- It is recommended that you don't install the JDK in a path with spaces.
Install the LDSTech IDE
- Download and LDSTech IDE compressed package from: http://code.lds.org/downloads/lds-tech-ide/current/
- Be sure to match the architecture (64bit or 32bit) of the JDK you just installed.
- Uncompress LDSTech IDE to desired location
- Execute "lds-tech" executable.
- If you get an error on startup eclipse may not have been able to find a compatible java version. To force eclipse to use the correct java version follow these instructions on the Eclipse wiki.
- On Mountain Lion or newer you will get the error "lds-tech is damaged and can't be opened". This occurs if your gatekeeper settings are set higher than "Anywhere" for "Allow Applications Downloaded From". In System Preferences -> Security and Privacy, temporarily change your setting to "Anywhere", launch lds-tech, and change your settings back. OSX will remember that you've run this app before and continue to allow it.
Setup JDKs in LDSTech IDE
Java comes in 2 forms a JRE and a JDK. When developing you generally want to use JDKs. In this step you will add any/all JDKs you may want to develop with and remove all JREs.
- Open the "Installed JREs" preference page by going to Preferences->Java->Installed JREs.
- Proceed to add any/all JDKs you wish to develop with.
- Remove any JREs in the list.
- Set a default JDK by checking the box next to it.
Checking Out and Importing Projects
- Find the Subversion URL of the project you wish to develop with.
- Add the Subversion URL to the SVN Repository Perspective
- Right click on the svn folder you wish to develop against and select "Checkout as Maven Project".
- Switch back to the LDSTech Perspective
- Wait for Maven to finish importing the project
Install and Import Database (Optional)
- Whether the application requires a database or not can usually be identified if a project ending in "-db" was imported by Maven.
- If the application uses a Database you may need to install the Oracle VM.
- Once the Oracle VM is installed and running you need to Import your database database schema.
- To import the schema Right click on the "-db" project and select Run As->stack-db:remigrate Database.
Start WAM Emulator (Optional)
- If the application you have checked out uses WAM you may need to launch a WAM Emulator. This can usually be determined by whether the application has a project that ends in "-alm" that contains a "wam" directory.
- To launch the WAM Emulator right click on the "-alm" project and select Run As->stack-wam:run
- In the Eclipse console make note of the "http proxy port" logged in the eclipse console (usually 8080).
- Right click on the "-web" project and select Run As->Run On Server
- Completing the Wizard will launch the server and Open a Browser
- If your project runs in WAM you will need to change port in the browser to the "http proxy port" noted when you started the WAM emulator.
Uninstalling the IDE
In the unlikely event you would like to uninstall the IDE:
- Simply delete the directory that the IDE was installed to.