Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "ETrice/Development/GettingStartedWithEtrice"
< ETrice | Development
(→Setting up Runtime Workspace) |
|||
Line 28: | Line 28: | ||
# make sure you are using a JDK (in Eclipse: Window->Preferences->Java->Installed JREs->e.g. jdk1.6.0_24), <b>attention</b>: do not use jdk1.6.0_18 or jdk1.6.0_22! | # make sure you are using a JDK (in Eclipse: Window->Preferences->Java->Installed JREs->e.g. jdk1.6.0_24), <b>attention</b>: do not use jdk1.6.0_18 or jdk1.6.0_22! | ||
− | + | = Working in the Runtime Workspace = | |
− | + | ||
* start the runtime workspace: org.eclipse.etrice.core.room.ui -> eTrice-rt.launch (contextmenu -> Run As) | * start the runtime workspace: org.eclipse.etrice.core.room.ui -> eTrice-rt.launch (contextmenu -> Run As) | ||
* follow the steps in the Tutorials chapter of the eTrice online help (use Eclipse: Help > Help Contents or view the 0.3 documentation in [http://eclipse.org/etrice/documentation/doc/etrice-doc.html HTML] or as [http://eclipse.org/etrice/documentation/manual/etrice.pdf PDF]) | * follow the steps in the Tutorials chapter of the eTrice online help (use Eclipse: Help > Help Contents or view the 0.3 documentation in [http://eclipse.org/etrice/documentation/doc/etrice-doc.html HTML] or as [http://eclipse.org/etrice/documentation/manual/etrice.pdf PDF]) |
Revision as of 11:04, 26 July 2013
Prepare Eclipse and build eTrice
- get the sources (see how)
- download the latest release of Eclipse Modeling Tools (cf. http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/keplerr)
- start eclipse
- Install additional Plugins (if not already installed)
- Graphiti for the Graphical Editors
- select Help -> Install New Software -> Kepler - http://download.eclipse.org/releases/kepler
- select Graphiti 0.10.0
- Xtext and Xtend for the DSL development and the code generators
- Help -> Install New Software -> Kepler - http://download.eclipse.org/releases/kepler
- select Xtext 2.4.2 (from Modeling) and Xtend 2.4.2 (from Languages)
- might be already there: Apache Commons IO for file operations (e.g. for incremental code generator)
- Help -> Install New Software : http://download.eclipse.org/tools/orbit/downloads/drops/R20130118183705/repository/ (the link is a p2 update site of Orbit)
- Apache Commons IO 2.0.1
- Google Guava (needed for Kieler Plugins)
- Help -> Install New Software : Guava - http://guava-osgi.googlecode.com/svn/trunk/repository/
- deselect "show only the latest versions of available software", because we need an older version
- select Guava 8.0.0
- Kieler for automatic layout of graphical editors
- Help -> Install New Software : http://download.eclipse.org/etrice/KIELER/kieler-0.7.1
- if "there are no categorized items" in the list, de-select "Group items by category" -> do not forget to -> select after installation
- select all Kieler Plugins
- Graphiti for the Graphical Editors
- import all projects from your local GIT clone to your Workspace (with EGit plugin)
- Git Repositories View
- Add Repository (local GIT clone)
- Context Menu of Working Directory -> Import Projects
- Import all Projects
- make sure you are using a JDK (in Eclipse: Window->Preferences->Java->Installed JREs->e.g. jdk1.6.0_24), attention: do not use jdk1.6.0_18 or jdk1.6.0_22!
Working in the Runtime Workspace
- start the runtime workspace: org.eclipse.etrice.core.room.ui -> eTrice-rt.launch (contextmenu -> Run As)
- follow the steps in the Tutorials chapter of the eTrice online help (use Eclipse: Help > Help Contents or view the 0.3 documentation in HTML or as PDF)
Deriving from an Existing Generator
There is a minimal example that shows how a generator can be derived from the existing eTrice Java generator. The example shows how the derived DetailCodeTranslator handles an additional tag.
The example consist of two plugins:
- examples/my.etrice.generator
- examples/my.etrice.generator.launch
You will find the examples in the eTrice GIT repository: http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/tree/examples
The first one overrides the Java generator, the second one overrides the Java launch configuration to launch the derived generator. Please have a look at the comments marked with EXAMPLE: (you can add that as a Java task tag in the preferences and use the Tasks View to locate these comments).