Difference between revisions of "Target Platform"

From Developer Documents
Jump to navigation Jump to search
Line 18: Line 18:
 
{{tip|Simantics is an open source software platform, licensed under Eclipse Public License EPL (more information in section [https://www.simantics.org/simantics/about-simantics/licensing Licensing]). The source code for both semantic database engine Simantics Core and the client Simantics Workbench is available to '''registered users'''. To gain access to the complete Simantics SDK source code, go to the [https://www.simantics.org/members/index.php Simantics Members Wiki] and [https://www.simantics.org/members/index.php/Special:RequestAccount request an account].}}
 
{{tip|Simantics is an open source software platform, licensed under Eclipse Public License EPL (more information in section [https://www.simantics.org/simantics/about-simantics/licensing Licensing]). The source code for both semantic database engine Simantics Core and the client Simantics Workbench is available to '''registered users'''. To gain access to the complete Simantics SDK source code, go to the [https://www.simantics.org/members/index.php Simantics Members Wiki] and [https://www.simantics.org/members/index.php/Special:RequestAccount request an account].}}
  
== Simantics 1.15 ==
+
== Getting a version of the Simantics target platform ==
 +
 
 +
In the following, the version 1.22 will be retrieved but the instructions apply to all versions. In this case 1.22 means getting the latest built target platform for the 1.22 platform branch. To use any other version, just change the version number to any other version. For SVN development, '''head''' is equal to the trunk version, and for git development '''master''' equals the git master branch.
  
 
# '''Get the target platform definitions'''
 
# '''Get the target platform definitions'''
#* Installing without SVN (recommended approach)
+
#* Installing without SVN
 
#** Select menu item ''File/New/Project'' to create a new empty project.
 
#** Select menu item ''File/New/Project'' to create a new empty project.
 
#** Download the following files and copy them into the new project:
 
#** Download the following files and copy them into the new project:
#*** http://www.simantics.org/download/1.15/simantics.target
+
#*** http://www.simantics.org/download/1.22/simantics.target
 
#** For members, source code access is available through these alternative target definitions:
 
#** For members, source code access is available through these alternative target definitions:
#*** http://www.simantics.org/download/1.15/simantics-sdk.target
+
#*** http://www.simantics.org/download/1.22/simantics-sdk.target
 
#* Installing through SVN
 
#* Installing through SVN
#** Checkout [[svn:target/branches/1.15]] project from the [[svn:|Simantics SVN]] into your workspace.
+
#** Checkout [[svn:target/branches/1.22]] project from the [[svn:|Simantics SVN]] into your workspace.
 
# '''Activate the target platform'''
 
# '''Activate the target platform'''
 
#* Select menu item ''Window/Preferences'' from your Eclipse IDE.
 
#* Select menu item ''Window/Preferences'' from your Eclipse IDE.
 
#* Open the preference page ''Plug-in Development/Target Platform''.
 
#* Open the preference page ''Plug-in Development/Target Platform''.
#* Activate the ''Simantics 1.15'' target platform definition by checking it and pressing Apply. Wait until Eclipse finishes downloading. Press OK.
+
#* Activate the ''Simantics 1.22'' target platform definition by checking it and pressing Apply. Wait until Eclipse finishes downloading. Press OK.
#** '''Members:''' Select '''Simantics SDK 1.15''' for source code access instead. Use the SVN credentials available in the members wiki when Eclipse asks for the credentials to the target platform.
+
#** '''Members:''' Select '''Simantics SDK 1.22''' for source code access instead. Use the SVN credentials available in the members wiki when Eclipse asks for the credentials to the target platform.
 
#** This will make Eclipse download the target platform components from '''simantics.org''' and install them as your target platform.
 
#** This will make Eclipse download the target platform components from '''simantics.org''' and install them as your target platform.
 
# '''Keep your platform up-to-date'''
 
# '''Keep your platform up-to-date'''
#* Updating is as easy as reloading the target platform from Target Platform preference page. Select your target from the list and then press the '''Reload''' button.
+
#* Updating should in theory be as easy as reloading the target platform from Target Platform preference page. Select your target from the list and then press the '''Reload''' button. However, in order to make Eclipse actually reload everything properly, it may be necessary to:
 
+
#*# Copy the current target platform file to a new file with another name
== Simantics TRUNK (head) ==
+
#*# Activate the copied target platform
Same instructions apply as for [[#Simantics 1.15]] with the following changes:
 
* Download the following files and copy them into the new project:
 
** http://www.simantics.org/download/head/simantics.target
 
** http://www.simantics.org/download/head/simantics-sdk.target
 
or
 
* Checkout [[svn:target/branches/head]] project from the [[svn:|Simantics SVN]] into your workspace.
 
  
 
= Deprecated deployments =
 
= Deprecated deployments =

Revision as of 10:58, 25 September 2016

The target platform is a composition of OSGi bundles, i.e. Eclipse plug-ins and features. This is the platform on top of which Simantics and its applications are developed. It consists roughly of:

  • selected parts of the Eclipse SDK (RCP, P2, JDT, PDE)
  • Simantics SDK
  • some third-party components (see Licensing)

Maintenance

Simantics target platform maintainer is Tuukka Lehtonen.

See Deploying plug-ins for the target platform for instructions on contributing to the target platform.

P2 deployments

P2 is a technology for provisioning software components for OSGi applications (e.g. anything Eclipse-based) originating from the Eclipse/Equinox project.

Register to access source code

Tip.png Simantics is an open source software platform, licensed under Eclipse Public License EPL (more information in section Licensing). The source code for both semantic database engine Simantics Core and the client Simantics Workbench is available to registered users. To gain access to the complete Simantics SDK source code, go to the Simantics Members Wiki and request an account.

Getting a version of the Simantics target platform

In the following, the version 1.22 will be retrieved but the instructions apply to all versions. In this case 1.22 means getting the latest built target platform for the 1.22 platform branch. To use any other version, just change the version number to any other version. For SVN development, head is equal to the trunk version, and for git development master equals the git master branch.

  1. Get the target platform definitions
  2. Activate the target platform
    • Select menu item Window/Preferences from your Eclipse IDE.
    • Open the preference page Plug-in Development/Target Platform.
    • Activate the Simantics 1.22 target platform definition by checking it and pressing Apply. Wait until Eclipse finishes downloading. Press OK.
      • Members: Select Simantics SDK 1.22 for source code access instead. Use the SVN credentials available in the members wiki when Eclipse asks for the credentials to the target platform.
      • This will make Eclipse download the target platform components from simantics.org and install them as your target platform.
  3. Keep your platform up-to-date
    • Updating should in theory be as easy as reloading the target platform from Target Platform preference page. Select your target from the list and then press the Reload button. However, in order to make Eclipse actually reload everything properly, it may be necessary to:
      1. Copy the current target platform file to a new file with another name
      2. Activate the copied target platform

Deprecated deployments

See Deprecated Target Platforms.