Difference between revisions of "Quick Development Environment Setup"

From Developer Documents
Jump to navigation Jump to search
 
(109 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
__TOC__
 +
 
== Install Java JDK and Eclipse, and Setup the IDE for Simantics Development ==
 
== Install Java JDK and Eclipse, and Setup the IDE for Simantics Development ==
# 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 http://www.oracle.com/technetwork/java/javase/downloads/index.html]. Follow the installation instructions for your operating system. Using the latest JDK update is recommended.
+
 
# Get and install the latest ''Eclipse Classic IDE'' 3.7 (Indigo) stable stream build. You can find the package from [http://download.eclipse.org/eclipse/downloads/ http://download.eclipse.org/eclipse/downloads/]. You can select freely the installation location for the package, e.g. under your home directory. Just unzip to install.
+
# Get and install the latest 64-bit ''Java SE Development Kit 8'' (JDK 8). You can download the package from [http://www.oracle.com/technetwork/java/javase/downloads/index.html http://www.oracle.com/technetwork/java/javase/downloads/index.html]. Follow the installation instructions for your operating system. It is recommended to always use the latest JDK update.
# After the installation of Eclipse, check that your Eclipse is set to use the right Java Runtime Edition:
+
# Get and install the latest 4.7 64-bit ''Eclipse Classic IDE'' release build. You can find the package from [http://download.eclipse.org/eclipse/downloads/ http://download.eclipse.org/eclipse/downloads/]. You can select freely the installation location for the package, e.g. under your home directory. Just unzip the package to install Eclipse. Alternatively, there is also an [http://www.eclipse.org/downloads/ installer] available.
#* Open Eclipse Preferences from Window - Preferences.
+
# After the installation of Eclipse, check that your Eclipse is set to use the right Java Runtime Environment (JRE):
 +
#* In Eclipse platform, open "Window - Preferences".
 
#* Open page “Java / Installed JREs”.
 
#* Open page “Java / Installed JREs”.
#* Set the JRE to point to the previously installed JDK 6.
+
#* Set the JRE to point to the previously installed JDK 8.
 
# Install the Simantics Graph Compiler:
 
# Install the Simantics Graph Compiler:
#* Open “Help / Install New Software”.
+
#* In Eclipse platform, open “Help / Install New Software...”.
#* Set installation site "http://www.simantics.org/update/utils" to the “Work with” field and press “Add...”.
+
#* Set the installation site to "http://www.simantics.org/update/utils" in the “Work with” field and press “Add...”. Give the installation site link a name when asked.
#* Select from the list the latest "Ontology development / Graph feature" and proceed with the installation. Restart the IDE after the installation.
+
#* Select from the list the latest "Ontology development / Graph feature" and proceed with the installation. Restart Eclipse after the installation.
 
# Install the Subversive plug-in to the Eclipse platform:
 
# Install the Subversive plug-in to the Eclipse platform:
#* Open ''“Help / Install New Software”''
+
#* In Eclipse platform, open ''“Help / Install New Software...”''.
#* Select installation site "Indigo - http://download.eclipse.org/releases/indigo" to the “Work with” field from the preset list.
+
#* Select installation site "Oxygen - http://download.eclipse.org/releases/oxygen" to the “Work with” field from the preset list.
#* Click open the "Collaboration" folder and select from the list
+
#* Click open the "Collaboration" folder and select from the list:
 
#** ''Subversive SVN Team Provider''
 
#** ''Subversive SVN Team Provider''
#** ''Subversive SVN JDT Ignore Extensions''
+
#: and proceed with the installation. Restart Eclipse after the installation.
#: and proceed with the installation. Restart the IDE after the installation.
+
# After restarting Eclipse, open the SVN Repository Exploring perspective:
# After restarting, open the SVN Repository Exploring perspective:
+
#* In Eclipse platform, open “Window / Open Perspective / Other...”.
#* Open “Window / Open Perspective / Other...”.
+
#* Select ''SVN Repository Exploring'' and press “OK”. Eclipse should open the “Install Connectors” dialog.
#* Select ''SVN Repository Exploring'' and press “OK”.
+
#* Select latest “SVN Kit 1.x.y” and press “Finish”, and proceed with the installation. Restart Eclipse after the installation.
# 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.
 
  
== Install Simantics Target Platform ==
+
'''NOTE:''' You can also use Eclipse 4.8 at your own risk, but Subversive is not available for it right now so you'll have to install [https://marketplace.eclipse.org/content/subclipse Subclipse] instead to get SVN support.
# 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''.
+
 
 +
== Install Latest Simantics Target Platform ==
 +
 
 +
# In Eclipse platform, activate the ''Plug-in Development'' perspective, either from the tab on the upper right corner of the Eclipse platform or from the “Window / Open Perspective / Other...” menu, and select ''Plug-in Development''.
 
# Create a new general project in Eclipse by:
 
# Create a new general project in Eclipse by:
## Selecting “File / New / Project...” menu item.
+
#* Selecting “File / New / Project...” menu item.
## In the "Select a wizard", select “General / Project” and press “Next”.
+
#* In the "Select a wizard", select “General / Project” and press “Next”.
## Give the project a name, e.g. "Simantics_target" and press "Finish".
+
#* Give the project a name, e.g. "Simantics_target" and press "Finish".
# Copy the following files into your system to some temporary location:
+
# Download the following file into the project folder you just created: [http://www.simantics.org/download/master/simantics.target http://www.simantics.org/download/master/simantics.target]
#* [http://www.simantics.org/download/1.4/simantics.target http://www.simantics.org/download/1.4/simantics.target]
+
# In Eclipse ''Package Explorer'' (the view on left side of the Eclipse platform):
#* [http://www.simantics.org/download/1.4/simantics-https.target http://www.simantics.org/download/1.4/simantics-https.target]
+
#* Right-click your previously created project and select "Refresh" from the context menu, or press F5 while the project is selected.
#: For THTH/Simantics registered members, source code access is available through these alternative target definitions:
+
# Set the target platform up for the development with Simantics:
#* [http://www.simantics.org/download/1.4/simantics-sdk.target http://www.simantics.org/download/1.4/simantics-sdk.target]
+
#* In Eclipse platform, open “Window / Preferences”, and from there the “Plug-in Development / Target Platform” folder.
#* [http://www.simantics.org/download/1.4/simantics-sdk-https.target http://www.simantics.org/download/1.4/simantics-sdk-https.target]
+
#* The new target definitions should be available in the list.
# In Eclipse ''Package Explorer'' (the window on left side of Eclipse):
+
#: Activate '''“Simantics x.y.z”''' and confirm the target platform definition by pressing "Apply" and/or "OK".
#* Right-click your previously created project and select "Import..." from the context menu.
+
#* Wait until Eclipse finishes downloading, this may take a while. After the download is completed, there should be several plug-ins starting with "org.simantics.*" in the Eclipse ''Plug-ins'' view (the view on the left side of Eclipse).
#* In ''Select wizard'', select “General / File System”, and press "Next".
+
# '''Keep your platform up-to-date!''' Updating is as easy as re-downloading the .target file and reloading the target platform from ''Target Platform'' preference page:
#* 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".
+
#* In Eclipse platform, open “Window / Preferences”, and from there the “Plug-in Development / Target Platform” folder.
# Open “Window / Preferences” and from there the “Plug-in Development / Target Platform” folder.
+
#* Select the active target platform, e.g. ''Simantics x.y.z'', from the list and press "Reload".
# The new target definitions should be available in the list. Activate one of the following:
+
#* Wait until the platform is updated.
#* “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)
+
== Test Your Installation ==
#* “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)
+
NOTE: this test/example is out of date, might not work anymore
# Confirm the target platform definition by pressing "Apply" and/or "OK".
+
 
#: Wait until Eclipse finishes downloading, this may take a while.
+
Test your installation with the [http://dev.simantics.org/index.php/Tutorial:_Ontology_Development Simantics movie tutorial]:
#: In the Eclipse Plug-in window (the window on left side of Eclipse), there should be now several plug-ins starting with "org.simantics.*".
+
 
# '''Keep your platform up-to-date!''' Updating is as easy as reloading the target platform from ''Target Platform'' preference page:
+
# Download ''Simantics movie tutorial'' plug-ins into your Eclipse workspace:
#* Open “Window / Preferences” and from there the “Plug-in Development / Target Platform” folder.
+
#* Get [https://www.simantics.org/jenkins/job/Tutorials/job/package-movie-tutorial-head/lastSuccessfulBuild/artifact/movie-tutorial.zip]
#* Select the active target platform, e.g. ''Simantics SDK 1.4'', from the list and press "Reload".
+
#* In Eclipse platform, select  “File / Import...” menu item.
 +
#* In the "Select" dialog, select “General / Existing Projects into Workspace” and press “Next”.
 +
#* Select the “Select archive file:” radio button and press “Browse” to find the downloaded movie-tutorial.zip.
 +
#* Press “Select All” and “Finish”.
 +
# Run movie.product:
 +
#* From the ''Package Explorer'' view, open “org.simantics.movie.ui'' / Movie.product”.
 +
#* From the ''Overview'' page of the opened product editor, press “Launch an Eclipse application”.
 +
 
 +
If you managed to start the ''movie'' product, your development platform should be operational.
  
== Test your installation ==
 
TODO:
 
# Checkout movie tutorial and try running movie.product. If that works, your development platform should be operational.
 
  
Happy Simantics developing!
+
'''''Happy developing with Simantics!'''''

Latest revision as of 07:32, 9 August 2018

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

  1. Get and install the latest 64-bit Java SE Development Kit 8 (JDK 8). You can download the package from http://www.oracle.com/technetwork/java/javase/downloads/index.html. Follow the installation instructions for your operating system. It is recommended to always use the latest JDK update.
  2. Get and install the latest 4.7 64-bit Eclipse Classic IDE release build. You can find the package from http://download.eclipse.org/eclipse/downloads/. You can select freely the installation location for the package, e.g. under your home directory. Just unzip the package to install Eclipse. Alternatively, there is also an installer available.
  3. After the installation of Eclipse, check that your Eclipse is set to use the right Java Runtime Environment (JRE):
    • In Eclipse platform, open "Window - Preferences".
    • Open page “Java / Installed JREs”.
    • Set the JRE to point to the previously installed JDK 8.
  4. Install the Simantics Graph Compiler:
    • In Eclipse platform, open “Help / Install New Software...”.
    • Set the installation site to "http://www.simantics.org/update/utils" in the “Work with” field and press “Add...”. Give the installation site link a name when asked.
    • Select from the list the latest "Ontology development / Graph feature" and proceed with the installation. Restart Eclipse after the installation.
  5. Install the Subversive plug-in to the Eclipse platform:
    • In Eclipse platform, open “Help / Install New Software...”.
    • Select installation site "Oxygen - http://download.eclipse.org/releases/oxygen" to the “Work with” field from the preset list.
    • Click open the "Collaboration" folder and select from the list:
      • Subversive SVN Team Provider
    and proceed with the installation. Restart Eclipse after the installation.
  6. After restarting Eclipse, open the SVN Repository Exploring perspective:
    • In Eclipse platform, open “Window / Open Perspective / Other...”.
    • Select SVN Repository Exploring and press “OK”. Eclipse should open the “Install Connectors” dialog.
    • Select latest “SVN Kit 1.x.y” and press “Finish”, and proceed with the installation. Restart Eclipse after the installation.

NOTE: You can also use Eclipse 4.8 at your own risk, but Subversive is not available for it right now so you'll have to install Subclipse instead to get SVN support.

Install Latest Simantics Target Platform

  1. In Eclipse platform, activate the Plug-in Development perspective, either from the tab on the upper right corner of the Eclipse platform or from the “Window / Open Perspective / Other...” menu, and select Plug-in Development.
  2. Create a new general project in Eclipse by:
    • Selecting “File / New / Project...” menu item.
    • In the "Select a wizard", select “General / Project” and press “Next”.
    • Give the project a name, e.g. "Simantics_target" and press "Finish".
  3. Download the following file into the project folder you just created: http://www.simantics.org/download/master/simantics.target
  4. In Eclipse Package Explorer (the view on left side of the Eclipse platform):
    • Right-click your previously created project and select "Refresh" from the context menu, or press F5 while the project is selected.
  5. Set the target platform up for the development with Simantics:
    • In Eclipse platform, open “Window / Preferences”, and from there the “Plug-in Development / Target Platform” folder.
    • The new target definitions should be available in the list.
    Activate “Simantics x.y.z” and confirm the target platform definition by pressing "Apply" and/or "OK".
    • Wait until Eclipse finishes downloading, this may take a while. After the download is completed, there should be several plug-ins starting with "org.simantics.*" in the Eclipse Plug-ins view (the view on the left side of Eclipse).
  6. Keep your platform up-to-date! Updating is as easy as re-downloading the .target file and reloading the target platform from Target Platform preference page:
    • In Eclipse platform, open “Window / Preferences”, and from there the “Plug-in Development / Target Platform” folder.
    • Select the active target platform, e.g. Simantics x.y.z, from the list and press "Reload".
    • Wait until the platform is updated.

Test Your Installation

NOTE: this test/example is out of date, might not work anymore

Test your installation with the Simantics movie tutorial:

  1. Download Simantics movie tutorial plug-ins into your Eclipse workspace:
    • Get [1]
    • In Eclipse platform, select “File / Import...” menu item.
    • In the "Select" dialog, select “General / Existing Projects into Workspace” and press “Next”.
    • Select the “Select archive file:” radio button and press “Browse” to find the downloaded movie-tutorial.zip.
    • Press “Select All” and “Finish”.
  2. Run movie.product:
    • From the Package Explorer view, open “org.simantics.movie.ui / Movie.product”.
    • From the Overview page of the opened product editor, press “Launch an Eclipse application”.

If you managed to start the movie product, your development platform should be operational.


Happy developing with Simantics!