Difference between revisions of "SensiNact/studio-installation"

Revision as of 11:43, 5 September 2019

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

• If you are a sensiNact end user, you may be interested in the latest stable release of sensiNact Studio.
• If you are a sensiNact core developper, you will need to install the studio from it sources. It will gives you access to the Studio development branch, with the latest features and the ability to debug the Studio using the source code.

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.

For sensiNact developpers: installation from sources

Eclipse Configuration

1. Eclipse download and start-up
   1. Download “Eclipse IDE for Java and DSL developers” (tested with version 2019-03);
   2. Extract the archive to the directory of your choice;
   3. Run the eclipse executable.
2. EMF transaction installation
   1. Go to Help / Install new software;
   2. Work with: http://download.eclipse.org/releases/2019-03 (already existing);
   3. Select Modeling / EMF Model Transaction SDK;
   4. Install.
3. Restlet installation
   1. Go to Help / Install new software
   2. Work with: http://p2.restlet.com/2.2/ (to be added);
   3. Select :
      1. Restlet Core
      2. inside Standards support : Restlet Extension - JSON
      3. inside Third-Party integrations : Restlet Extension - Jackson
   4. Install.
4. 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 Examples / Nebula Widgets)
   4. Install.
5. Jetty installation (to be double checked)
   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 Studio project

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, e.g., Java project, and make sure they are in the same folder as the org.eclipse.sensinact.studio.language.sensinact project
4. 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