Quick Development Environment Setup

Installation Instructions for Impatient

Install Java JDK and Eclipse, and Setup the Platform for Simantics Development

1. Get and install Java SE Development Kit 6 (JDK 6), you can download the package from http://www.oracle.com/technetwork/java/javase/downloads/index.html. Follow the installation instructions for your operating system.
2. Get and install Eclipse for RCP and RAP Developers, you can download the package from http://www.eclipse.org/downloads/. You can select freely the installation location for the package, e.g. under your home directory.
3. After the installation of Eclipse, check and set right Java Runtime Edition for your platform:
   • Open Eclipse Preferences from Window - Preferences.
   • Open page “Java / Installed JREs”.
   • Set the JRE to point to the previously installed JDK 6.
4. Install the Simantics Graph Compiler:
   • Open “Help / Install New Software”.
   • Set installation site "http://www.simantics.org/update/utils" to the “Work with” field and press “Add...”.
   • Select from the list the latest "Ontology development / Graph feature" and proceed with the installation. Restart the platform after the installation.
5. Install the Subversive plug-in to the Eclipse platform:
   • Open “Help / Install New Software”
   • Set installation site "http://download.eclipse.org/releases/helios" to the “Work with” field; the site location should already exist in the preset list.
   • Click open the "Collaboration" folder and select from the list
     • Subversive SVN Team Provider
     • Subversive SVN JDT Ignore Extensions

   and proceed with the installation. Restart the platform after the installation.

6. After restarting, open the SVN Repository Exploring perspective:
   • Open “Window / Open Perspective / Other...”.
   • Select SVN Repository Exploring and press “OK”.
7. Eclipse should open a dialog called “Install Connectors”. Select latest “SVN Kit 1.3.x” and press “Finish”. Proceed with the installation. Restart the platform after the installation.

Download Simantics Development Packages

1. In Eclipse platform, activate the Plug-in Development perspective, either from the tab on the upper right corner of the platform or from the “Window / Open Perspective / Other...” menu, and select Plug-in Development.
2. Create a new general project in Eclipse by:

1. Selecting “File / New / Project...” menu item.
2. In the "Select a wizard", select “General / Project” and press “Next”.
3. Give the project a name, e.g. "Simantics_development" and press "Finish".

1. Copy the following files into your system to some temporary location:

• http://www.simantics.org/download/1.4/simantics.target
• http://www.simantics.org/download/1.4/simantics-https.target

For THTH/Simantics registered members, source code access is available through these alternative target definitions:

• http://www.simantics.org/download/1.4/simantics-sdk.target
• http://www.simantics.org/download/1.4/simantics-sdk-https.target

1. In Eclipse Package Explorer (the window on left side of Eclipse):

1. Right-click your previously created project and select "Import..." from the context menu.
2. In Select wizard, select “General / File System”, and press "Next".
3. Select in the “From directory” the folder where the previously downloaded files are located, and select the two files from the file list. Press "Finish".
4. Open “Window / Preferences” and from there the “Plug-in Development / Target Platform” folder.
5. The new target definitions should be available in the list. Activate one of the following:

• “Simantics 1.4+” (for application development on Simantics platform)
• “Simantics 1.4+ (HTTPS)” (for application development on Simantics platform, if you are behind an HTTP proxy)
• “Simantics SDK 1.4+” (for platform development and application development on Simantics platform)
• “Simantics SDK 1.4+ (HTTPS)” (for platform development and application development on Simantics platform, if you are behind an HTTP proxy)

1. Confirm the target platform definition by pressing "Apply" and/or "OK".

Wait until Eclipse finishes downloading, this may take awhile.

In the Eclipse Plug-in window (the window on left side of Eclipse), there should be now several plug-ins starting with "org.simantics.*".

1. Checking the installation by... HOW???
2. Organizing the packages and plug-ins... HOW???
3. Keep your platform up-to-date! Updating is as easy as reloading the target platform from Target Platform preference page:

1. Open “Window / Preferences” and from there the “Plug-in Development / Target Platform” folder.
2. Select the active target platform, e.g. Simantics SDK 1.4, from the list and press "Reload".

Happy Simantics developing!