Skip to main content
Jump to: navigation, search

SensiNact/studio-installation

There are TWO ways to install sensiNact Studio on your computer, depending on what you want to do with the Studio.

IMPORTANT Please check you are using Java 8. Because Java Module System (aka Jigsaw) is breaking a lot of API, we are waiting for updates on all the libraries we rely on to perform an upgrade to the latest JDK.


Eclipse Package installation

  1. Download “Eclipse IDE for Java and DSL developers” (tested with version 2019-12);
  2. Extract the archive to the directory of your choice;
  3. Run the eclipse executable.

Eclipse Plugins installation

Eclipse Plugins installation: the easy way

  1. Download Eclipse target platform;
  2. Extract the archive to the directory of your choice;
  3. In you Eclipse environment:
    1. Window / Preferences
    2. Plug-in Development / Target Platform
    3. select Running Platform (Active) and click Edit button.
    4. Click Add..., select Directory then click Next.
    5. Browse... to the target platform root directory and validate the dialog.
    6. A line is automatically added to the Edit Target Definition Dialog. Close it with Finish button.
    7. Close the Preferences dialog using Apply and Close button.


Eclipse Plugins installation: the expert way

Instead of using a target platform, you can install everything by hand.

  1. EMF transaction installation
    1. Go to Help / Install new software;
    2. Work with: http://download.eclipse.org/releases/2019-12 (already existing);
    3. Select Modeling / EMF Model Transaction SDK;
    4. Install.
  2. Restlet installation (Note: we are using Restlet Core, Restlet Extension - JSON and Restlet Extension - Jackson)
    1. Go to Help / Eclipse Marketplace...
    2. Search for: Java Restful Plugin for Eclipse
    3. Install the Eclipse plugin
  3. Nebula installation
    1. Go to Help / Install new software;
    2. Work with: https://download.eclipse.org/nebula/snapshot (to be added);
    3. Select Nebula Release Individual Widgets; (or Nebula Release all Widgets and Examples)
    4. Install.
  4. Jetty installation (With recent releases of Java, you may have issues related to javax.annotation. Please contact us if you need support)
    1. Go to Help / Install new software;
    2. Work with: http://download.eclipse.org/jetty/updates/jetty-bundles-9.x/ (to be added);
    3. Select all;
    4. Install.

sensiNact Source code import

sensiNact Source code import: the easy way

  1. Download sensiNact studio source code;
  2. Extract the archive to the directory of your choice;
  3. In you Eclipse environment:
    1. File / Import...;
    2. General / Existing Projects into Workspace;
    3. Select root directory --> the source code directory;
    4. Check all the projects;
    5. Click on finish.

sensiNact Source code import: the expert way

  1. Clone the sensiNact Studio GIT repository
    1. HTTP url : git clone https://git.eclipse.org/r/sensinact/org.eclipse.sensinact.studio
    2. SSH url : git clone ssh://git.eclipse.org/sensinact/org.eclipse.sensinact.studio
  2. Import all plugins into the workspace
    1. File / Import...;
    2. General / Existing Projects into Workspace;
    3. Select root directory --> the studio repository;
    4. Check all the projects;
    5. Click on finish.
  3. Code generation: the generated code is NOT part of the repository. You need to generate it!
    1. EMF model
      1. In the project org.eclipse.sensinact.studio.model.resource open the file models > resource.genmodel
      2. In the editor, activate the Generator tab (at the bottom of the view)
      3. In the editor, right click at the root of the tree (on Resource element) and click Generate All
      4. (note that the generated test code is not mandatory)
    2. XText language
      1. In the project org.eclipse.sensinact.studio.language.sensinact select the file src > org.eclipse.sensinact.studio.language > GenerateSensinact.mwe2
      2. Right click on the file, and execute Run As > MWE2 workflow. Run this even if there are errors.
      3. Note that the generated test code is not mandatory. If the test projects have errors, you can safely remove them.


First Studio Execution

  1. Run / Run configurations...;
  2. Double click on Eclipse Application to create a new runner;
  3. Run.
  4. In the new Eclipse instance, open sensiNact studio perspective
    1. Window > Perspective > Open Perspective > Other...
    2. Open Sensinact Studio perspective

Back to the top