The following topics are covered in this tutorial:
- Installation of Eclipse and all necessary plug-ins
- Retrieving the source code for Preesm and related projects
- Execution of Preesm
Prerequisite: Install and Configure git
Note: if you need to work with Graphiti and/or DFTools source code, please read these instructions first.
Follow the instructions of the Eclipse Preparation tutorial to obtain an Eclipse installation, in which you will install all necessary tools for Preesm development. Make sure you have the Neon version.
Install XTend, GEF SDK, Graphiti, Maven, DFTools, ...
- Go to "Help > Install New Software...";
- In "work with:", add a new location named "Preesm" with location "http://preesm.sourceforge.net/eclipse/update-site/"
- Select the "Developper Resources > PREESM Developper Requirements (Meta Feature)"
(this Eclipse feature contains all requirements for developping Preesm)
- Click Next twice, agree on the terms of the license, and click on Finish to install the features. This step will take a few minutes.
- During the installation process, a security warning for unsigned content will appear. Click on OK to continue the installation.
- Restart eclipse to complete the installation.
Import Preesm projects
Clone the following repository (git clone <url>, in the folder where you want to place your local repository):
- Preesm: https://github.com/preesm/preesm.git (https) or firstname.lastname@example.org:preesm/preesm.git (SSH)
Switch to the develop branch (git checkout develop) to get the latest developer version of our source.
Connect your local repository obtained through git clone to your Eclipse workspace
- Window > Perspective > Open Perspective > Other ... then select Git
- Add an existing local repository to this view (GIT button with a green plus symbol), then browes to the local repositories
- Check the box and click on finish.
The PREESM plugins are plain Maven projects. In order to import them in Eclipse, we rely on the M2Eclipse project (automatically installed with the dev feature). This allow to centralize all the configuration in the POM files. The .project, .classpath and .settings/* files are automatically generated (see maintainer doc).
- In the Java perspetive, click on File > Import... then Maven > Existing Maven Projects;
- In the next window, browse to the git repository location (the Preesm root folder);
- The project import wizard should automatically find all the projects;
- Note : releng/* projects are for Release Engineering, and can be omitted.
- Click on finish.
Compilation of Preesm
For a better user experience in eclipse, we strongly advice that you use the "Plug-In Development" perspective of eclipse. To use this perspective, select "Plug-In Development" in Windows > Open Perspective > Others...
If there still are errors after applying the previous operations, try again to clean, refresh and build the projects.
The Preesm code base respects some coding policy. If you intend to develop within Preesm, we strongly advise you to follow these policy to prevent the continuous integration server to reject your contributions. These policies are simple :
- Follow the checkstyle format provided in the coding policy project;
- Make sure all the tests run without failure (run 'mvn clean verify' in the root folder of the git repository.
To help enforcing the checkstyle format, the "on-the-fly" checkstyle analyser using the Eclipse plug-in (automatically installed with the meta feature and configured through M2Eclipse connectors) will provide feedback and the Eclipse cleanup formatter will enforce most of the rules (triggered on save action).
Execution of Preesm
In the Java or 'Plug-in Development' perspective, right-click on the 'org.ietr.preesm.ui' plug-in, the click on Debug As > Eclipse Application. A new Eclipse session is launched that behaves like the one obtained by Preesm users from the update site. The difference is that you can debug and modify code in the first Eclipse and test at the same time in the second Eclipse. You can see the tutorials to learn how to use the second Eclipse, import Preesm projects and test.
- I updated the source code and many errors appeared. Why ? (1) The main reason is that upstream API changed. Try "Help / Chek for updates". (2) Another reason would be the Maven configuration files that are not up to date. To update them, select all the projects in the workspace, and press Alt+F5 then press OK. (3) Also, the build state of the Eclipse workspace can be corrupted after an update. To fix that, restart Eclipse then clean and rebuild your workspace. (4) Finaly, some updates can introduce new Preesm plug-ins that you would have to add in your workspace (File / Import ... > Maven / Existing Maven Projects > select the root folder of the git repository. Eclipse will automatically detect new plugins). If the procedures did not solve the errors, please contact us.
- Missing artifact com.sun:tools:jar:1.8.0 is missing: This happens because Eclipse is running using a JRE instead of a JDK. Some Eclipse plugins needs Java packages that are not bundled with the JRE, but only with the JDK. If you installed the JDK, note that by default the JDK distribution for Windows also installs a JRE. Also, the installer adds a section in the PATH variable, that points to 'C:\ProgramData\Oracle\Java\javapath', which is an alias to the JRE binaries. Please refer to this page for fixing the issue. Basically, it tells to prepend the PATH variable with the path to the JDK, while not removing the '...\javapath' section.