Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

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: http://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, right click at the root of the tree (on Resource element) and click Generate All
      3. (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
      3. (note that the generated test code is not mandatory)
      4. If you get the error in the console that there is not project ../org.eclipse.sensinact.studio.language.sensinact.tests or ../org.eclipse.sensinact.studio.language.sensinact.ui.tests, create them as Java projects and make sure they are in the same folder as the org.eclipse.sensinact.studio.language.sensinact project

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