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.
Difference between revisions of "ETrice/Development/GettingStartedWithEtrice"
< ETrice | Development
| Line 1: | Line 1: | ||
= Quick Development Setup = | = Quick Development Setup = | ||
# Java Setup | # Java Setup | ||
| − | #* Lastest [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java SE Development Kit 7 | + | #* Lastest [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java SE Development Kit 7 - JDK 7] (recommended 64bit) |
# Eclipse Setup | # Eclipse Setup | ||
| − | #* [ | + | #* [https://www.eclipse.org/downloads/packages/release/Luna/SR2 Eclipse Luna SR2] (recommended Modeling Tools) |
| − | #* | + | #* Download [http://git.eclipse.org/c/etrice/org.eclipse.etrice.git/plain/team/LunaSoftwareItems.p2f LunaSoftwareItems.p2f] to install plugins (Import -> Install -> Install Software Items from File) |
| − | + | ||
| − | + | ||
| − | + | ||
# Clone eTrice sources into workspace (see [[ETrice/Development/Repository |Git and eTrice]]) | # Clone eTrice sources into workspace (see [[ETrice/Development/Repository |Git and eTrice]]) | ||
| − | # (To be added) Settings | + | # (To be added) Settings |
Revision as of 15:44, 14 June 2015
Contents
Quick Development Setup
- Java Setup
- Lastest Java SE Development Kit 7 - JDK 7 (recommended 64bit)
- Eclipse Setup
- Eclipse Luna SR2 (recommended Modeling Tools)
- Download LunaSoftwareItems.p2f to install plugins (Import -> Install -> Install Software Items from File)
- Clone eTrice sources into workspace (see Git and eTrice)
- (To be added) Settings
Development Setup with with all eTrice features
- get the sources (see how)
- download the Eclipse Modeling Tools package from Luna SR2
- start Eclipse
- Install additional Plugins (if not already installed)
- 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
- might be already there: Apache Commons IO for file operations (e.g. for incremental code generator)
- 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).