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
Ts.protos.de (Talk | contribs) |
|||
| (40 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | = | + | = Quick Development Setup = |
| − | * | + | # Java Setup |
| − | + | #* Lastest [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java SE Development Kit 7 - JDK 7] (recommended 64bit) | |
| − | * | + | # 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]]) | ||
| + | # (To be added) Settings | ||
| − | = | + | |
| − | = | + | ---- |
| + | |||
| + | |||
| + | = Development Setup with with all eTrice features = | ||
| + | # get the sources ([[ETrice/Development/Repository |see how]]) | ||
| + | # download the [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/lunasr2 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 | ||
| + | # 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), <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]) |
| − | + | ||
| − | + | = 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). | |
| − | + | ||
| − | + | ||
| − | + | [[Category:eTrice]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
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).